Tripswitch MCP Server

Connect the Tripswitch MCP server to Claude or any MCP-compatible assistant. Your projects, breakers, and health data come directly into the conversation — so you can identify what’s worth protecting, configure and create breakers, and get your codebase instrumented without leaving your assistant.

In Claude Code, it goes further: the assistant reads your codebase, fetches SDK documentation, and instruments your dependencies directly — in your language, the way Tripswitch is meant to be used.

Connect

Preferred Streamable HTTP endpoint:

https://mcp.tripswitch.dev/mcp

Legacy SSE endpoint:

https://mcp.tripswitch.dev/sse

Authentication uses OAuth 2.1. A browser window opens on first use, you log in with your Tripswitch account, and the client manages the token from there.

Claude Code

claude mcp add tripswitch --transport http https://mcp.tripswitch.dev/mcp

Codex

codex mcp add tripswitch --url https://mcp.tripswitch.dev/mcp
codex mcp login tripswitch

Codex uses the Streamable HTTP endpoint, which sends MCP requests directly over POST /mcp. GET /mcp for server-initiated notifications is not implemented yet.

Claude.ai

Go to Settings → Connectors, click +, and enter https://mcp.tripswitch.dev/mcp as the URL. OAuth runs in-browser on first use.

Other MCP clients

Use the Streamable HTTP endpoint when your client supports direct HTTP MCP. Use the SSE endpoint only for clients that specifically require SSE transport. Both use the same OAuth 2.1 flow.

What You Can Do

Find candidates for breaker protection

Describe your service, your dependencies, and your failure modes. The assistant can reason about what’s worth protecting and suggest appropriate breaker kinds and configurations before you write a line of code.

“We call Stripe for payments and an internal auth service. What should we be protecting with breakers?”

Configure and create breakers in conversation

Reasoning about thresholds, windows, and evaluation policies is non-trivial. Ask the assistant to walk through the tradeoffs for your specific situation, then create the breaker directly.

“Create a p95 latency breaker for the payments project. Our SLA is 300ms and we typically see around 200 requests per minute.”

Instrument your codebase (Claude Code)

Once your breakers are created, Claude Code can fetch your credentials, read your codebase, and wire up the instrumentation directly — in your language, idiomatically.

“I just created the fraud-scoring breaker. Find where we call the fraud service and instrument it.”

Check system health

“Give me a health report for the Meridian workspace.”

“Show me recent samples for the fraud-scoring breaker.”

“The payment-errors breaker tripped overnight, what does the sample data show?”

Available Tools

Tool	What it does
`list_workspaces`	List all workspaces in your org
`list_projects`	List projects in a workspace
`get_project`	Get project details
`get_workspace_health`	Check health across all projects in a workspace
`get_project_health`	Check if any breakers are open in a project
`get_project_credentials`	Retrieve ingest credentials
`rotate_ingest_secret`	Rotate a project’s ingest secret
`create_project`	Create a new project
`create_breaker`	Create a new breaker
`get_breaker`	Get breaker configuration
`list_breakers`	List breakers in a project, optionally filtered by state (`open`, `closed`, `half_open`)
`update_breaker`	Update breaker configuration
`get_breaker_state`	Get current breaker state
`get_recent_samples`	Fetch recent metric samples
`get_sdk_docs`	Retrieve SDK documentation for a given language

Troubleshooting

Tools are silently rejected with no permission prompt (Claude Code)

Restart the Claude Code session. Claude Code caches permission decisions per session — a stale denial from a previous session can suppress the prompt.

Connection shows as failed after authenticating (Claude Code)

Restart the Claude Code session. Authentication state is sometimes not picked up until the session reinitializes.

“Needs authentication” after restarting

Re-run the auth flow. Tokens expire after an extended period — you may need to authenticate again.