{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_z52ymkrxmhkj","handle":"mcp-rec","url":"https://wellknown.network/agents/mcp-rec","links":{"self":"https://wellknown.network/agents/mcp-rec/record.json","html":"https://wellknown.network/agents/mcp-rec","markdown":"https://wellknown.network/agents/mcp-rec/record.md","api":"https://wellknown.network/api/v1/agents/mcp-rec","status":"https://wellknown.network/api/v1/agents/mcp-rec/status","claim":"https://wellknown.network/agents/mcp-rec/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-rec/claim.json","badge":"https://wellknown.network/agents/mcp-rec/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-rec/history","tools":"https://wellknown.network/api/v1/agents/mcp-rec/tools"},"ard":{"identifier":"urn:air::server:mcp-rec","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-rec","summary":"Record and replay MCP servers — VCR for the Model Context Protocol.","description":"# mcp-rec\n\n> **VCR for the Model Context Protocol.** Record any MCP server's traffic to a\n> JSONL file, then replay it deterministically — for tests, bug reports, or\n> running your client offline.\n\n[![PyPI](https://img.shields.io/pypi/v/mcp-rec)](https://pypi.org/project/mcp-rec/)\n[![Python](https://img.shields.io/badge/python-3.10%2B-blue)]()\n[![MCP](https://img.shields.io/badge/MCP-tooling-7c3aed)]()\n[![License: MIT](https://img.shields.io/badge/license-MIT-green)]()\n\n---\n\n## Why\n\nMCP servers are great until they aren't:\n\n- Your server passes locally but fails for someone else — and you have no way to share the exact session that broke.\n- You want CI tests for your MCP server but you can't pin upstream API responses.\n- You want to demo your agent offline.\n- You want to bisect \"when did this tool start returning empty results?\" against a recording.\n\n`mcp-rec` solves all four by acting as a transparent proxy: it sits between\nyour MCP client and any stdio MCP server, forwards every byte, and writes a\nJSONL transcript. Later you can replay that transcript as if it were the\nreal server.\n\n---\n\n## Install\n\n```bash\npip install mcp-rec\n# or\nuvx mcp-rec --help\n```\n\nZero dependencies. Pure Python ≥3.10.\n\n---\n\n## Record\n\nPoint your MCP client at `mcp-rec record` instead of your usual server command:\n\n```jsonc\n// claude_desktop_config.json\n{\n  \"mcpServers\": {\n    \"filesystem\": {\n      \"command\": \"mcp-rec\",\n      \"args\": [\n        \"record\",\n        \"-o\", \"/tmp/filesystem-session.jsonl\",\n        \"--\",\n        \"npx\", \"-y\", \"@modelcontextprotocol/server-filesystem\", \"/some/path\"\n      ]\n    }\n  }\n}\n```\n\nUse your client normally. Every JSON-RPC message in both directions is appended\nto the JSONL file:\n\n```json\n{\"ts\": 1750000001.23, \"dir\": \"client->server\", \"msg\": {\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}}\n{\"ts\": 1750000001.45, \"dir\": \"server->client\", \"msg\": {\"jsonrpc\":\"2.0\",\"id\":1,\"result\":{\"tools\":[...]}}}\n```\n\n---\n\n## Replay\n\nReplace the real server with `mcp-rec replay <j…","publisher":{"name":"yubinkim444","url":null},"homepage":"https://github.com/yubinkim444/mcp-rec","repository":"https://github.com/yubinkim444/mcp-rec","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["claude","cline","cursor","mcp","model-context-protocol","record","replay","testing","vcr"],"pricing":null,"endpoints":[{"url":"pypi:mcp-rec","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"code.testing","name":"Testing","confidence":1,"provenance":"declared"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.882,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.825,"provenance":"derived"}],"categories":["code","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-rec","registry":"pypi","observedAt":"2026-11-03T15:23:03.938Z","publishedAt":"2026-08-26T20:21:41.874698Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-rec","url":"https://pypi.org/project/mcp-rec/","firstSeenAt":"2026-09-10T03:19:08.264Z","fetchedAt":"2026-11-03T15:21:03.292Z","normalizedAt":"2026-11-03T15:21:03.292Z"}]},"firstSeenAt":"2026-09-10T03:19:08.264Z","updatedAt":"2026-11-03T15:23:03.938Z"}