grpcurl MCP Server

MCP server that wraps grpcurl for calling gRPC APIs.

Tools

• grpc_invoke — Execute a gRPC method. Parameters: url (required, e.g. host:443), endpoint (required, e.g. ProductService.GetProducts), payload (required, JSON request body).
• grpc_list_services — List services available on a gRPC server. Parameters: url (required).

Requirements

• Python 3.11+
• uv
• grpcurl on PATH

Install grpcurl:

macOS (Homebrew)

brew install grpcurl

Linux

# Debian/Ubuntu
sudo apt install grpcurl

# Or download the latest binary from GitHub releases
curl -sSL https://github.com/fullstorydev/grpcurl/releases/latest/download/grpcurl_linux_x86_64.tar.gz | tar -xz
sudo mv grpcurl /usr/local/bin/

Windows (Scoop)

scoop install grpcurl

Go (any platform)

go install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest

Verify the install:

grpcurl --version

Install

The recommended way is via uvx — no separate install step needed:

{
  "mcpServers": {
    "grpcurl": {
      "command": "uvx",
      "args": ["grpcurl-mcp"]
    }
  }
}

uvx fetches and runs the package from PyPI automatically.

Or install explicitly with pip:

pip install grpcurl-mcp

Claude Code setup

Run this command to register the server (one-time setup):

claude mcp add grpcurl -- uvx grpcurl-mcp

Or add it manually to your Claude Code MCP config (~/.claude/settings.json or project .claude/settings.json):

{
  "mcpServers": {
    "grpcurl": {
      "command": "uvx",
      "args": ["grpcurl-mcp"]
    }
  }
}

Cursor setup

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-level) and add:

{
  "mcpServers": {
    "grpcurl": {
      "command": "uvx",
      "args": ["grpcurl-mcp"]
    }
  }
}

Then restart Cursor. Alternatively, use the UI: Cursor Settings → Features → MCP → add a new server with command uvx and arg grpcurl-mcp.

Local development

From the project root:

uv sync
uv run python main.py

For debugging with HTTP transport:

MCP_TRANSPORT=http uv run python main.py

Then connect to http://localhost:8000/mcp with the MCP Inspector.

Example prompts

• List available services:
  "List gRPC services on grpc.example.com:443"

• Fetch products by SKU:
  "Call ProductsView.GetProductsById on grpc.example.com:443 with SKUs ["SKU-001", "SKU-002"]"

• Run a query:
  "Call ExampleService.GetProducts on grpc.example.com:443 with payload {"skus": ["SKU-001"]}"

License

MIT