Guides/Using the MCP Server
DocsGuides

Using the MCP Server

Starting and querying the Model Context Protocol stdio server.

$athena mcp

Starting the MCP Server

Athena implements the standard Model Context Protocol (MCP) over stdio:

bash
athena mcp

Registered automatically for Claude Code (.mcp.json), Cursor (.cursor/mcp.json), Codex (.codex/config.toml), GitHub Copilot in VS Code (.vscode/mcp.json) and Gemini CLI (.gemini/settings.json). Any other MCP client can run athena mcp.

Write Permissions

By default, the server is read-only. To allow agents to call update_knowledge:

bash
athena mcp --allow-write