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 |