Add ProtoMap to your coding agent

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.

Connect your agent in three steps

  1. 1

    Install ProtoMap Server

    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.

    Terminal
    git clone https://github.com/hounddogai/protomap.git
    cd protomap
    ./self-hosted/scripts/install.sh
  2. 2

    Scan a repository

    Run it from a new shell.

    Terminal
    protomap scan /path/to/repository
  3. 3

    Add it to your agent

    Run it from a repository’s folder.

    Claude Code · run from the repository’s folder
    claude mcp add protomap -- protomap mcp serve

    Another agent? See the guides at docs.protomap.ai.

Try it on your code.

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.