Skip to content
MCP server

Rystic

Run local simulators of Stripe, GitHub and Slack APIs from a coding agent

Runs locallyStatus and history
Pricing
Freemium
Platforms
macOS, Linux, CLI
Runs
Locally
Version
0.0.57
Listing updated
3 days ago

About Rystic

Rystic is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "rystic": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Rystic-Inc/rystic/releases/download/v0.0.57/rystic-mcp_0.0.57.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "rystic": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Rystic-Inc/rystic/releases/download/v0.0.57/rystic-mcp_0.0.57.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium, from $89.99 a month

Free plan with 10 hours a month; Pro $89.99 per seat a month with a 14-day trial; Enterprise custom.

Prices change. Check rystic.ai before you buy.

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools