MCP Server
ProtoMap’s MCP server gives your coding agent your organization’s gRPC and Protobuf context: what calls a service, what depends on it, and where a field’s data goes, across every repository, including the changes you haven’t committed yet.
Set it up
The self-hosted platform and its CLI, on your machine, with Docker and Compose 2.23.1 or newer. When the installer asks, choose Trial: it runs PostgreSQL locally and logs the CLI in.
git clone https://github.com/hounddogai/protomap.git
cd protomap
./self-hosted/scripts/install.sh
Run it from a new shell.
protomap scan /path/to/repository
Run it from a repository’s folder.
claude mcp add protomap -- protomap mcp serve
codex mcp add protomap -- protomap mcp serve
{
"mcpServers": {
"protomap": { "command": "protomap", "args": ["mcp", "serve"] }
}
}
copilot mcp add protomap -- protomap mcp serve
code --add-mcp '{"name":"protomap","command":"protomap","args":["mcp","serve"]}'
opencode mcp add protomap -- protomap mcp serve
Another agent? See the guides at docs.protomap.ai.
Install the self-hosted version for free. It runs on your machine with Docker, and your source code stays in your environment.
Paste into your coding agent
Set up ProtoMap and show me what it can do. ProtoMap maps gRPC services and protobuf messages across repositories, and gives coding agents that graph over MCP. Docs: https://docs.protomap.ai/quickstart/
Tell me what you are about to do before each step that installs something.
1. Check that this computer has git, Docker with Compose 2.23.1 or newer, at least 4 GB of RAM, and 20 GB of disk space. If anything is missing, tell me and stop.
2. Install ProtoMap Server, in a folder outside this repository:
git clone https://github.com/hounddogai/protomap.git
cd protomap
./self-hosted/scripts/install.sh
The installer asks questions. Choose Trial, which runs PostgreSQL locally and logs the CLI in, and keep the default port.
3. Show me the address and the one-time setup key the installer prints. Ask me to open the address, enter the key, and create my organization and owner account. Wait until I say that's done.
4. Scan this repository, from a new shell so the CLI is on the PATH:
protomap scan .
If it has no gRPC services in a supported language, tell me, and offer to scan a public example instead:
git clone https://github.com/GoogleCloudPlatform/microservices-demo.git
protomap scan microservices-demo
5. From the scanned repository's folder, add ProtoMap to yourself as an MCP server:
Claude Code: claude mcp add protomap -- protomap mcp serve
Codex: codex mcp add protomap -- protomap mcp serve
Antigravity: add "protomap": { "command": "protomap", "args": ["mcp", "serve"] } under mcpServers in ~/.gemini/config/mcp_config.json
Others: https://docs.protomap.ai/coding-agents/
Tell me if I need to restart you for it to take effect.
6. Tell me what the scan found, then use ProtoMap's tools to answer one question about my services, such as which services call a method and where. Suggest two more questions I could ask.