ESA MCP Server

What is ESA MCP Server?

ESA MCP Server provides esa.io data in Model Context Protocol (MCP) format. It is designed for use in Cloud Desktop environments.

How to use ESA MCP Server?

Install by cloning the repository, running npm install, and then executing node bin/cli.js or installing globally with npm install -g .. On first run you are prompted for your esa.io API key, team name, and port number (default 3000). Configuration is saved to ~/.esa-mcp-server/config.json. The server exposes three endpoints: GET /, GET /mcp-data, and POST /search.

Key features of ESA MCP Server

• Provides esa.io data in MCP format
• Designed for Cloud Desktop environments
• CLI-based server with config file storage
• API endpoint to fetch all data (GET /mcp-data)
• API endpoint to search esa.io content (POST /search)
• Pre-configured integration for Claude Desktop

Use cases of ESA MCP Server

• Accessing esa.io knowledge base from Claude Desktop via MCP
• Searching esa.io documents programmatically using a POST query
• Using esa.io data in cloud-based AI agent environments

FAQ from ESA MCP Server

What runtime is required to run ESA MCP Server?

Node.js is required. The server is started with node bin/cli.js or the globally installed esa-mcp-server command.

How do I authenticate to esa.io?

You provide your esa.io API key and team name on first startup, or set the ESA_API_KEY and ESA_TEAM_NAME environment variables in the Claude Desktop configuration.

Where is the configuration stored?

Configuration is stored in ~/.esa-mcp-server/config.json after the initial interactive setup.

What port does ESA MCP Server use by default?

The default port is 3000. You can change it via the prompt on first run or by setting the PORT environment variable.

What API endpoints are available?

The server offers GET / (welcome page), GET /mcp-data (retrieve all esa.io data in MCP format), and POST /search (search esa.io content with a JSON body containing a query field).