MCP Chaos Rig MCP Server

A local MCP server that breaks on demand. Test your client against auth failures, disappearing tools, flaky responses, and token expiry.

Local serverstdio

What is the MCP Chaos Rig MCP Server?

A local MCP server that breaks on demand. Test your client against auth failures, disappearing tools, flaky responses, and token expiry.

What the assistant can call

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 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

Recorded tools

  • 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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
echoreturns your message (v2 adds format options)
addsums two numbers (v2 accepts an array)
get-timecurrent server time as ISO 8601
random-numberrandom integer in a range
reversereverses a string
typeEchoechoes one optional parameter per JSON Schema primitive, to check a client round-trips every type
dispute-chargefiles a billing dispute, returns a JSON receipt
listcontacts, get-contact-by-id, get-contact-by-email, search-contacts, create-contact, update-contact, delete-contact: SQLite CRUD

How to install the MCP Chaos Rig MCP Server

{
  "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.

Configuration

VariableDescriptionRequired
BASE_URLEndpoint or connection string the server talks to.Yes
STATIC_CLIENT_IDConfiguration value read at startup.Optional
STATIC_CLIENT_SECRETCredential the server authenticates with.Yes

Example prompts to try

  • “Use MCP Chaos Rig to echo.”
  • “Use MCP Chaos Rig to add.”
  • “Use MCP Chaos Rig to get-time.”

Frequently asked questions

A local MCP server that breaks on demand. Test your client against auth failures, disappearing tools, flaky responses, and token expiry. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.