Overview

platform-mcp exposes the API as tools an editor or agent can call.

Tool	What it does
platform_v1_HelloService_GetHello	Fetch the greeting
healthz	Check that the API is up

export PLATFORM_GRPC=template-grpc.localhost:80
export PLATFORM_REST=http://template-api.localhost

Optional config file: ~/.platform/config.json (endpoint, rest_endpoint, token). These environment variables override the file: PLATFORM_GRPC, PLATFORM_REST, PLATFORM_TOKEN.

If you set nothing: gRPC 127.0.0.1:9090, REST http://127.0.0.1:8080.

Connect

Cursor (~/.cursor/mcp.json or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "platform": {
      "command": "platform-mcp",
      "env": {
        "PLATFORM_GRPC": "template-grpc.localhost:80",
        "PLATFORM_REST": "http://template-api.localhost"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "platform": {
      "command": "platform-mcp",
      "env": {
        "PLATFORM_GRPC": "template-grpc.localhost:80",
        "PLATFORM_REST": "http://template-api.localhost"
      }
    }
  }
}

VS Code (mcp.json):

{
  "servers": {
    "platform": {
      "type": "stdio",
      "command": "platform-mcp",
      "env": {
        "PLATFORM_GRPC": "template-grpc.localhost:80",
        "PLATFORM_REST": "http://template-api.localhost"
      }
    }
  }
}

Put platform-mcp on your PATH, or use the full path to the binary as command.

Install or download a binary. See every tool on the reference.