Diagrid Catalyst — Claude Code MCP server setup
Runs Dapr Workflows and Durable Agents on Diagrid Catalyst directly from coding assistants. Useful for checking and managing distributed systems.
claude mcp add --transport http catalyst https://mcp.cloud.r1.diagrid.io/mcpWhat Diagrid Catalyst does
This integration connects your assistant to the Diagrid Catalyst cloud endpoint at https://mcp.cloud.r1.diagrid.io/mcp. It allows models to inspect Durable Agents and run Dapr Workflows. Standard API keys are absent here. You authenticate once via browser OAuth instead.
The connection requires the offline_access scope for background token refresh. Without that scope, the session drops on expiry, forcing a fresh browser sign-in. Write operations like catalyst_apply disappear from the tool list if your account holds read-only rights. Forwarding requests to a local machine process also requires the external Diagrid CLI.
What it helps with
- trigger and inspect Dapr Workflows via chat
- verify active identity and roles inside Catalyst
- apply system configurations using catalyst_apply
- bridge local services to the cloud with app tunnels
Example prompts for the agent
- Who am I in Catalyst and what are my assigned roles?
- Check the status of the latest Dapr Workflow in Catalyst.
- Apply the new configuration using catalyst_apply.
How to install Diagrid Catalyst
Platform CLI: remote server
claude mcp add --transport http catalyst https://mcp.cloud.r1.diagrid.io/mcpPlatform CLI: remote server
codex mcp add diagrid-catalyst --url https://mcp.cloud.r1.diagrid.io/mcpConfig file
{
"mcpServers": {
"diagrid-catalyst": {
"url": "https://mcp.cloud.r1.diagrid.io/mcp"
}
}
}Config file
{
"servers": {
"diagrid-catalyst": {
"type": "http",
"url": "https://mcp.cloud.r1.diagrid.io/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http diagrid-catalyst https://mcp.cloud.r1.diagrid.io/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Diagrid Catalyst
How to install Diagrid Catalyst in Claude Code?
Register the server with claude mcp add --transport http catalyst https://mcp.cloud.r1.diagrid.io/mcp. Next, open /mcp inside the client and finish OAuth login in your browser.
What does Diagrid Catalyst MCP server do?
It bridges your AI assistant to the Diagrid Catalyst cloud platform. This allows managing Durable Agents and running Dapr Workflows straight from the editor or terminal.
Why are write tools missing from the tool list?
The server omits tools like catalyst_apply when the session lacks the catalyst:write scope. They are also hidden if your Catalyst user role is read-only.
