MCP Protocol

How Brain MCP implements the Model Context Protocol.

Transport

Brain MCP uses stdio transport — the MCP client spawns the server process and communicates via stdin/stdout using JSON-RPC 2.0. No HTTP server, no ports, no network exposure.

Tool Registration

On initialization, Brain MCP registers 25 tools with the MCP client:

  • • 8 Cognitive Prosthetic tools (🧠)
  • • 6 Search tools (🔍)
  • • 4 Synthesis tools (🧪)
  • • 3 Conversation tools (💬)
  • • 1 GitHub tool (🐙)
  • • 1 Analytics tool (📊)
  • • 2 Meta tools (📜)

Request Format

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "brain.semantic_search",
    "arguments": {
      "query": "bottleneck as amplifier"
    }
  },
  "id": 1
}

Error Handling

Brain MCP returns standard MCP error codes. Common errors include invalid domain names, missing required parameters, and data source unavailability.