eon-mcp-local

Local stdio MCP server for the Eon platform.

Lets MCP clients (Claude Code, Cursor, Codex, Devin, scripts in CI) call Eon REST APIs over a non-interactive client_credentials OAuth flow. Unlike the remote https://mcp.eon.io server (which uses an interactive browser-based OAuth flow), this CLI is suitable for machines and pipelines.

Install

First install uv via your preferred method — Homebrew, pipx, your OS package manager, or Astral's install script (see Astral's docs for checksum-verified options).

Then pick one:

# zero-install (uvx fetches on first run, caches for next time) — recommended
uvx eon-mcp-local serve

# persistent install
uv tool install eon-mcp-local

# or pipx if you prefer
pipx install eon-mcp-local

Configure

Create API credentials in the Eon console (Settings → API Credentials), then set:

export EON_CLIENT_ID=...
export EON_CLIENT_SECRET=...
export EON_ACCOUNT_DOMAIN=acme        # the 'acme' in 'acme.console.eon.io'

Wire into Claude Code

claude mcp add eon -- uvx eon-mcp-local serve

Equivalent for Cursor / Codex / Devin: add a stdio MCP server with command uvx eon-mcp-local serve and the env vars above.

Using from an agent framework

See examples/adk_example.py for a runnable Google ADK agent that spawns eon-mcp-local as a stdio subprocess and exposes its tools to Gemini. The same pattern (spawn a subprocess, speak MCP over stdin/stdout) works with any MCP-aware framework.

Environment variables

Troubleshooting

• error: missing required environment variables — set the three required env vars before invoking serve.
• HTTP 401 on every call — verify the client_id/client_secret are active in the Eon console and were issued for the same tenant as EON_ACCOUNT_DOMAIN.
• DNS error / connection refused — EON_ACCOUNT_DOMAIN must be the bare subdomain, not a full URL.
• Garbled output — logs go to stderr by design; if you see them mixed with stdout, your MCP client is merging streams. Filter or capture stderr separately.

Reporting security issues

Please report suspected security issues privately to security@eon.io rather than in a public channel.

License

Apache License 2.0 — see LICENSE.