aide mcp

Start the MCP (Model Context Protocol) stdio server.

Usage

aide mcp

This starts a JSON-RPC 2.0 server over stdin/stdout, allowing LLM hosts (Claude Code, Cursor, etc.) to use aide agents as tools.

Available tools

ToolDescription
aide_runRun a task on a registered agent
aide_listList all registered agents
aide_spawnCreate a new agent
aide_vault_getRetrieve a secret from the vault

Claude Code integration

Add to your Claude Code MCP config (.claude/settings.json):

{
  "mcpServers": {
    "aide": {
      "command": "aide",
      "args": ["mcp"]
    }
  }
}

Once configured, Claude Code can orchestrate your agents:

"Use the reviewer agent to check PR #42"
→ Claude calls aide_run(agent="reviewer", task="Review PR #42")

Protocol

  • Transport: stdio (line-delimited JSON)
  • Methods: initialize, tools/list, tools/call
  • Follows the MCP specification