MCP Grpcurl

What is MCP Grpcurl?

MCP Grpcurl is a Model Context Protocol (MCP) server that interacts with gRPC services using the grpcurl command-line utility. It enables listing services, describing service details, and invoking gRPC methods via reflection. It is intended for developers and AI agents that need to call or inspect gRPC endpoints programmatically.

How to use MCP Grpcurl?

Install the grpcurl tool, then run go install github.com/wricardo/mcp-grpcurl@latest. Configure your MCP client (e.g., Cline) with the command mcp-grpcurl and set the environment variable ADDRESS to the target gRPC server address (e.g., localhost:8005). Start the server with mcp-grpcurl. Use the provided tools (invoke, list, describe) to interact with gRPC services.

Key features of MCP Grpcurl

• Invoke gRPC methods with custom headers and JSON payloads.
• List all available gRPC services on the target server.
• Describe gRPC services or message types using reflection.
• Lightweight, leverages the well-known grpcurl tool.
• Integrates seamlessly with any MCP‑compatible client.

Use cases of MCP Grpcurl

• Allow an AI assistant to call a specific gRPC method and receive a response.
• Explore all available gRPC services on a development server for debugging.
• Describe the structure of a gRPC service or message type without manual inspection.
• Automate testing of gRPC endpoints from an MCP‑enabled workflow.