ProtoMap: gRPC and Protobuf context engine for AI agents
Every gRPC service and protobuf message, mapped for you and your AI agents.
ProtoMap is a context engine and model harness specialized for gRPC and Protobuf (more protocols coming soon). It scans your source code and provides organization-wide, centralized context to engineers and coding agents.
Plug in the ProtoMap MCP and benefit immediately. Benchmarks show 13× fewer tokens, 7.7× faster answers, 6.4× lower cost, and increased accuracy. The bigger the codebase, the bigger the gain.
Paste into your coding agent
Copy Prompt
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.
Why ProtoMap
Fast, cheap, and accurate at scale
Stop burning tokens spinning up subagents and rediscovering the same code. Instruction and memory files go stale quickly and are challenging to maintain across large codebases.
ProtoMap derives its context deterministically from the code itself, with no additional files to write or maintain. The analysis runs efficiently on a modern laptop, with no GPU required. Future-proof against the inevitable explosion of code.
Backed by benchmarks
A code context graph that actually works, measured on both synthetic and real codebases with millions of lines of code.
Beyond gRPC, coming soon
ProtoMap is expanding to more protocols, with end-to-end data lineage across the entire stack.
REST APIs
OpenAPI, endpoints, and fields
GraphQL
Schemas, resolvers, and fields
Apache Thrift
IDL files, services, and fields
Full Data Lineage
Source to sink, across your stack