Chaos Rig FAQs

Question 1

What is Chaos Rig?

Accepted Answer

Chaos Rig is a local MCP (Message Control Protocol) server designed to simulate various failures (authentication, tool availability, network reliability) to help developers rigorously test their MCP client's resilience and error handling.

Question 2

What types of failures can Chaos Rig simulate?

Accepted Answer

It can simulate authentication failures (401s, 500s), token expiry, refresh token rejections, tool unavailability (`tools/changed` events), schema version changes, random latency, and configurable tool call failure rates.

Question 3

How do I control the simulated failures and server behavior?

Accepted Answer

Chaos Rig offers an intuitive web-based control panel. From this UI, you can toggle fault injection, adjust latency, set failure rates, manage tool availability, and configure authentication settings like token TTL.

Question 4

Is Chaos Rig suitable for testing OAuth 2.1 flows?

Accepted Answer

Yes, it includes a comprehensive interactive OAuth 2.1 consent page. This allows you to test various authorization scenarios, including approving, declining, invalid codes, and tampered states, ensuring robust OAuth client implementation.

Question 5

How do I quickly get started with Chaos Rig?

Accepted Answer

You can easily run it by executing `npx mcp-chaos-rig` in your terminal (Node 20+ required). The control panel will then be accessible at `http://localhost:4100/ui` and the MCP endpoint at `http://localhost:4100/mcp`.

Chaos Rig

Chaos Rig

Key Features

Use Cases

Key Features

Use Cases