# Rystic

> Rystic is a freemium MCP server for developer tools. Run local simulators of Stripe, GitHub and Slack APIs from a coding agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $89.99 a month
- **Platforms:** macOS, Linux, CLI
- **Website:** https://www.rystic.ai/mcp
- **Repository:** https://github.com/rystic-inc/rystic
- **MCP Registry name:** ai.rystic/rystic
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Instead of hitting real vendors during tests, the agent starts a local simulator of an API, loads a named scenario, seeds records, moves the clock, then reads state and the calls and webhooks the simulator saw. Tool names call a simulator a twin. The agent can diff state against its starting point and save a run as a regression test case.

It ships inside the rystic CLI and speaks MCP over stdio, for Mac or Linux. The catalogue in the docs names simulators for Slack, GitHub, Kalshi, PayPal, Lob, Okta, Linear, Stripe, Resend, Anthropic, Clerk and Dropbox, with topics such as test clocks, fault injection, merge queues and webhooks.

The free plan runs GitHub, Linear and Slack for 10 hours a month; Pro is $89.99 per seat per month with $100 of usage credit and a 14-day trial; Enterprise adds offline use. The README discloses that the CLI contacts rystic.ai to sign in and fetch simulators, and running simulators check in with a lease server that receives your API key and usage windows, never requests or data.

## Features

- **Simulator control:** Starts and stops simulators of real APIs.
- **Scenarios and seeding:** Loads named starting worlds and merges in records.
- **Clock control:** Pins or advances simulated time.
- **State inspection:** Reads state, calls served and outbound webhooks or emails.
- **State diffs:** Shows rows created, changed and deleted since the baseline.
- **Saved test cases:** Saves a run as a regression test.

## Good for

- Test billing code against a Stripe simulator with test clocks
- Check how an app handles Slack events without a live workspace
- Reproduce a webhook failure deterministically
- Keep an agent run as a regression test

## Install

### Claude Code (Terminal)

```sh
claude mcp add rystic -- npx -y https://github.com/Rystic-Inc/rystic/releases/download/v0.0.57/rystic-mcp_0.0.57.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rystic": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Rystic-Inc/rystic/releases/download/v0.0.57/rystic-mcp_0.0.57.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "rystic": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Rystic-Inc/rystic/releases/download/v0.0.57/rystic-mcp_0.0.57.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "rystic": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Rystic-Inc/rystic/releases/download/v0.0.57/rystic-mcp_0.0.57.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "rystic": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Rystic-Inc/rystic/releases/download/v0.0.57/rystic-mcp_0.0.57.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "rystic": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Rystic-Inc/rystic/releases/download/v0.0.57/rystic-mcp_0.0.57.mcpb"
      ]
    }
  }
}
```

## Tools

- `list_twins`: List the simulators running on this machine
- `start_twin`: Start a simulator, optionally with a scenario, and return its URL
- `stop_twin`: Stop a simulator
- `list_scenarios`: List the named starting worlds a simulator ships
- `load_scenario`: Wipe state and load a scenario
- `seed`: Merge records into state
- `set_clock`: Pin the simulator's clock
- `advance_clock`: Move the clock forward or back
- `reset`: Empty state and clear the logs
- `inspect_state`: Read the whole state or a named view
- `list_calls`: List API calls served since the last reset
- `list_sent`: List webhooks, emails and other outbound effects
- `diff_state`: Show rows created, changed and deleted since the baseline
- `save_test_case`: Save the run as a regression test

## FAQ

### Which platforms are supported?

Mac or Linux, 64-bit.

### What does the free plan include?

GitHub, Linear and Slack for 10 hours a month, one seat, no card.

### What data leaves my machine?

The CLI contacts rystic.ai for sign-in and downloads; simulators check in with a lease server carrying your API key and usage windows, not your requests or data.

### Which clients can use it?

Claude Code, Cursor, Codex, VS Code and Windsurf, plus plugins for Gemini CLI and Antigravity.

### Is Rystic free?

Rystic has a free plan, with paid plans for more usage or features. Paid plans start at $89.99 a month.

### How do I add Rystic to Claude Code?

Run this command in your terminal: claude mcp add rystic -- npx -y https://github.com/Rystic-Inc/rystic/releases/download/v0.0.57/rystic-mcp_0.0.57.mcpb

### What are the best alternatives to Rystic?

The closest alternatives to Rystic are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/rystic
