A local MCP server that breaks on demand. Test your client against auth failures, disappearing tools, flaky responses, and token expiry.
MCP Chaos Rig MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. A local MCP server that breaks on demand. Test your client against auth failures, disappearing tools, flaky responses, and token expiry.
Installation goes through your MCP client rather than a global install: point it at mcp-chaos-rig on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
Once MCP Chaos Rig is connected, these are the calls the assistant has available:
echo — returns your message (v2 adds format options)add — sums two numbers (v2 accepts an array)get-time — current server time as ISO 8601random-number — random integer in a rangereverse — reverses a stringtypeEcho — echoes one optional parameter per JSON Schema primitive, to check a client round-trips every typedispute-charge — files a billing dispute, returns a JSON receiptlist — contacts, get-contact-by-id, get-contact-by-email, search-contacts, create-contact, update-contact, delete-contact: SQLite CRUDServer — Configure auth mode, slow mode (random latency), and flaky tools (% failure rate)Tools — Toggle tools on/off. Disabling sends tools/changed to connected clients. Some tools (echo, add) support version switchingContacts — View and reset the SQLite database backing the contact tools. Starts with three seed recordsYou will need 3 environment variables: BASE_URL, STATIC_CLIENT_ID, STATIC_CLIENT_SECRET. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
This sits in the database access group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. MCP Chaos Rig's toolset — echo, add, get-time and 8 more — is a fair guide to whether it matches your workflow. It is maintained by typewise; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against MCP Chaos Rig's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| echo | returns your message (v2 adds format options) |
| add | sums two numbers (v2 accepts an array) |
| get-time | current server time as ISO 8601 |
| random-number | random integer in a range |
| reverse | reverses a string |
| typeEcho | echoes one optional parameter per JSON Schema primitive, to check a client round-trips every type |
| dispute-charge | files a billing dispute, returns a JSON receipt |
| list | contacts, get-contact-by-id, get-contact-by-email, search-contacts, create-contact, update-contact, delete-contact: SQLite CRUD |
| Server | Configure auth mode, slow mode (random latency), and flaky tools (% failure rate). |
| Tools | Toggle tools on/off. Disabling sends tools/changed to connected clients. Some tools (echo, add) support version switching. |
| Contacts | View and reset the SQLite database backing the contact tools. Starts with three seed records. |
{
"mcpServers": {
"chaos-rig": {
"command": "npx",
"args": ["-y", "mcp-chaos-rig"],
"env": {
"BASE_URL": "your-value",
"STATIC_CLIENT_ID": "your-value",
"STATIC_CLIENT_SECRET": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| BASE_URL | Endpoint or connection string the server talks to. | Yes |
| STATIC_CLIENT_ID | Configuration value read at startup. | Optional |
| STATIC_CLIENT_SECRET | Credential the server authenticates with. | Yes |
Read-only SQL access to Postgres — let your assistant inspect schemas and answer questions from real data.
Manage your whole Supabase project in conversation — database, auth, storage, Edge Functions and branches.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Official MongoDB server covering data, schemas and Atlas management — from find queries to spinning up clusters.
Serverless Postgres with database branching — point your assistant at Neon and let it work on disposable copies.