Skip to main content
Glama

agent-cassette

ci npm JSR Bun license

Deterministic VCR cassette recorder and offline replay proxy for LLM HTTP/SSE streams and MCP stdio runs. Replay multi-turn agent tests in ~0ms in CI without GPUs or live API keys.

Install

Bun / npm:

bunx agent-cassette record -- npm test
npx agent-cassette record -- npm test

# or install in your project / globally
bun add -d agent-cassette
npm i -D agent-cassette

JSR:

bunx jsr add @kanchingyg/agent-cassette
npx jsr add @kanchingyg/agent-cassette

Related MCP server: ResiliReplay

Quick start

# Record live LLM HTTP/SSE and MCP interactions into a deterministic cassette
npx agent-cassette record -- npm test
bunx agent-cassette record -- bun test

# Replay offline in CI in ~0ms with zero network calls or API keys
npx agent-cassette replay -- npm test

# Run as an MCP server over stdio
npx agent-cassette --mcp

Features

  • HTTP & SSE stream recording: Captures chunked token streams from OpenAI, Anthropic, Ollama, and OpenAI-compatible endpoints and replays them deterministically.

  • Prompt & tool-call hashing: Normalizes volatile headers and timestamps while matching prompt and tool-call signatures.

  • Automatic secret scrubbing: Strips Authorization, x-api-key, and bearer tokens before writing cassette files to disk.

  • SSRF & path containment: Blocks private-network target redirection and enforces workspace path containment on cassette reads/writes.

MCP setup

{
  "mcpServers": {
    "agent-cassette": {
      "command": "npx",
      "args": ["-y", "agent-cassette", "--mcp"]
    }
  }
}

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    VCR for MCP servers: a zero-dependency stdio proxy that records and replays MCP JSON-RPC tool calls to local cassette files, enabling deterministic, offline testing of AI agent workflows without side-effects or rate limits.
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Local-first MCP and coding-agent reliability harness that captures bounded, sanitized failure evidence and generates deterministic executable regression tests. Capture is opt-in; no API key or hosted service is required.
    2
    Apache 2.0
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables safe use of any MCP server by proxying and live-scanning all tool requests and responses, blocking or redacting poison descriptions, indirect prompt injection, malicious arguments, and unauthorized destinations.
    -
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables transparent proxying of upstream MCP servers and OpenAI/Anthropic API calls so large tool responses are handle-ified and can be queried with universal verbs, cutting token usage while preserving access to full payloads.
    33
    MIT