@rckflr/a2e-mcp-server

An MCP server that exposes the A2E product-api as a bounded set of 11 tools, so an agentic LLM can compose and execute workflows, discover pieces, list connection references (never secrets), and query knowledge and runs — without writing code or seeing secrets.

Two transports, same tool surface:

• stdio () — for local clients (Claude Desktop, etc.).
• HTTP () — Streamable HTTP, stateless, Bearer-authenticated — for remote/VPS exposure.

Install

npm install @rckflr/a2e-mcp-server

Environment variables

| Variable | Required | Description | | --- | --- | --- | | A2E_API_BASE | no | Base URL of the A2E product-api. Default http://localhost:8080. | | A2E_API_KEY | recommended | Sent as X-API-Key to the product-api. | | A2E_MCP_TOKEN | HTTP only | Bearer token clients must send to a2e-mcp-http. Required for the HTTP entry. | | MCP_PORT | HTTP only | HTTP listen port. Default 8089. | | MCP_BIND | HTTP only | HTTP bind address. Default 127.0.0.1. |

stdio usage

// Claude Desktop config snippet
{
  "mcpServers": {
    "a2e": {
      "command": "a2e-mcp-server",
      "env": { "A2E_API_BASE": "http://localhost:8080", "A2E_API_KEY": "<your-key>" }
    }
  }
}

Or directly:

A2E_API_BASE=http://localhost:8080 A2E_API_KEY=... a2e-mcp-server

HTTP usage

A2E_MCP_TOKEN=... MCP_PORT=8089 MCP_BIND=127.0.0.1 a2e-mcp-http

Clients must send Authorization: Bearer <A2E_MCP_TOKEN> and POST JSON-RPC requests. Only POST is accepted (stateless).

Tools

retrieve_catalog, retrieve_pieces, retrieve_actions, get_piece, list_connections, execute_workflow, save_workflow, list_workflows, run_saved_workflow, query_knowledge, query_runs.

License

MIT