Skip to main content

MCP Server

The MCP server exposes Batho's graph as a model context provider for IDE and AI tool integrations.

Transports

TransportUse CaseCommand
stdioIDE integration (Cursor, Windsurf, etc.)batho bridge mcp --transport stdio
sseRemote clientsbatho bridge mcp --transport sse --port 8767

Tools

ToolDescription
bridge_list_indexesList all available index IDs and timestamps
bridge_get_indexGet metadata for a specific index
bridge_list_artifactsList artifact records, optionally filtered
bridge_get_artifactLoad full JSON content for an artifact type
bridge_get_artifact_by_pathLoad artifact content by exact logical path
bridge_search_artifactsFuzzy search artifacts by logical path
bridge_get_statsReturn registry statistics

Example: stdio transport

batho bridge mcp --root /path/to/repo --transport stdio

This mode is designed to be consumed by MCP-compatible clients that spawn the process and communicate over stdin/stdout.