by speakeasy-api · speakeasy-api/gram
Speakeasy-built control plane — observability, policy, and a registry for agents/MCPs/skills, with deep API-first roots.
Gram comes from Speakeasy (the API-SDK folks). It's a control plane: observe tool calls across agents, enforce policy, manage MCP servers, and treat skills as deployable artifacts. Designed for orgs treating agents like services.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"gram-mcp": {
"command": "npx",
"args": [
"-y",
"@speakeasy/gram"
]
}
}
}Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.
{
"mcpServers": {
"gram-mcp": {
"command": "npx",
"args": [
"-y",
"@speakeasy/gram"
]
}
}
}Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.
{
"mcpServers": {
"gram-mcp": {
"command": "npx",
"args": [
"-y",
"@speakeasy/gram"
]
}
}
}Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".
{
"mcpServers": {
"gram-mcp": {
"command": "npx",
"args": [
"-y",
"@speakeasy/gram"
]
}
}
}Same shape as Claude Desktop. Restart Windsurf to pick up changes.
{
"mcpServers": [
{
"name": "gram-mcp",
"command": "npx",
"args": [
"-y",
"@speakeasy/gram"
]
}
]
}Continue uses an array of server objects rather than a map.
{
"context_servers": {
"gram-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"@speakeasy/gram"
]
}
}
}
}Add to context_servers. Zed hot-reloads on save.
claude mcp add gram-mcp -- npx -y @speakeasy/gramOne-liner. Verify with claude mcp list. Remove with claude mcp remove.
When to use: You want a real audit of MCP tool usage across your org.
Outcome: Real picture of agent tool usage.
Use Gram for control plane; agentgateway for high-perf data plane
| Tool | Inputs | When to call | Cost |
|---|---|---|---|
| control-plane | (see docs) | No callable tools — sits beside the agent | 1 call |
gram-adminexpose admin to engineering broadlyTraces missingConfirm clients are configured to emit; check sampling
| Alternative | When to use it instead | Tradeoff |
|---|---|---|
| archestra | You want pure registry | Less observability |