EKOSdocs
Docs / Integrations Build

MCP

EKOS as a Model Context Protocol server: transports, capabilities and client matrix.

ekos mcp serve implements MCP over newline-delimited JSON-RPC 2.0.

Transport Flag Auth
stdio (default) none needed — the client spawns the process
TCP --tcp ADDR first initialize carries params._meta.token
Streamable HTTP --http ADDR Authorization: Bearer on every request

Streamable HTTP exposes one POST /mcp endpoint. The reply is JSON or SSE by Accept negotiation. There is no server-initiated GET stream.

A server started with the default configuration lists 22 tools: search, query, retrieval, EKL, graph traversal, impact, history, audit, transformation and architecture analysis, conflicts, the cross-reference integrity check, the workflow sign-off status, and two review tools. Opt-in settings add up to six more (one gated live ClickHouse query, three session-memory tools, two business-semantics tools). Extension builds add their own. Full list: MCP Tools.

Through the web console

A team deployment does not run ekos mcp serve by hand. The console's MCP gateway (RFC 0182) serves each project at POST https://<console>/mcp/<tenant>/<project>, authenticated with an API token from Admin → API tokens (Authorization: Bearer ekos_…). The console starts a project's server on first use and stops it when idle. Every call is checked against the token's role, filtered by its read scope, and written to the tenant's audit log. A token can never call a review tool.

Read scopes

ekos mcp serve --read-scope <file> (RFC 0181) serves only what a JSON file of allow and deny rules (by source, path pattern or object id) lets the reader see. Under a restricting scope the server offers only the ten tools that read through the store, and refuses the rest. The console attaches each caller's scope to every call it forwards.

Clients

Client Route
Claude Code stdio: claude mcp add ekos -- ekos … mcp serve, or registered by ekos setup
Claude Desktop, VS Code registered by ekos setup (it backs up their config files and keeps other entries)
VS Code / GitHub Copilot, Visual Studio --http, or the console gateway URL
ChatGPT --http (needs SSE)
Custom clients --tcp, --http, or the console gateway