{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_atb9hpvvny24","handle":"mcp-snoop","url":"https://wellknown.network/agents/mcp-snoop","links":{"self":"https://wellknown.network/agents/mcp-snoop/record.json","html":"https://wellknown.network/agents/mcp-snoop","markdown":"https://wellknown.network/agents/mcp-snoop/record.md","api":"https://wellknown.network/api/v1/agents/mcp-snoop","status":"https://wellknown.network/api/v1/agents/mcp-snoop/status","claim":"https://wellknown.network/agents/mcp-snoop/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-snoop/claim.json","badge":"https://wellknown.network/agents/mcp-snoop/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-snoop/history","tools":"https://wellknown.network/api/v1/agents/mcp-snoop/tools"},"ard":{"identifier":"urn:air::server:mcp-snoop","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-snoop","summary":"Transparent stdio interceptor for MCP JSON-RPC traffic. Like strace, but for MCP.","description":"# mcp-snoop\n\n**Transparent stdio interceptor for MCP JSON-RPC traffic.**\n\nLike `strace`, but for the Model Context Protocol. Wrap any MCP server and see every message in real time — tool calls, responses, errors. Zero dependencies.\n\n```\n$ mcp-snoop -- python3 my_server.py\nmcp-snoop intercepting: python3 my_server.py\n[03:14:22.847] →SERVER #1 initialize claude-desktop v1.0\n[03:14:22.912] ←CLIENT #1 → server: my-server v0.1.0\n[03:14:22.913] →SERVER notifications/initialized\n[03:14:22.914] →SERVER #2 list tools\n[03:14:22.916] ←CLIENT #2 → 8 tools\n[03:14:23.201] →SERVER #3 call search_files(path=\"/tmp\", pattern=\"*.py\")\n[03:14:23.847] ←CLIENT #3 → text: \"['server.py', 'handler.py']\"\n\nmcp-snoop: 7 messages intercepted\n```\n\n## Install\n\n```bash\npip install mcp-snoop\n```\n\nOr run without installing:\n\n```bash\nuvx mcp-snoop -- python3 my_server.py\n```\n\n## Usage\n\n```bash\n# Basic — logs all messages to stderr\nmcp-snoop -- python3 my_server.py\n\n# Verbose — print full JSON for each message\nmcp-snoop --verbose -- node server.js\n\n# Save trace to file\nmcp-snoop --output trace.log -- uvx my-mcp-server\n\n# No color (for CI/log files)\nmcp-snoop --no-color -- python3 server.py\n```\n\n## What you see\n\nEach log line shows:\n- **timestamp** — `HH:MM:SS.mmm` UTC\n- **direction** — `→SERVER` (client→server) or `←CLIENT` (server→client)\n- **message ID** — `#1`, `#2`, etc. (pairs requests with responses)\n- **summary** — parsed tool name, arguments, result preview\n\nWith `--verbose`, the full JSON follows.\n\n## Why\n\nYou're building an MCP server. Your agent keeps calling the wrong tool. Something's returning garbage. The MCP Inspector requires a browser. You want to script against the logs.\n\n`mcp-snoop` gives you the raw protocol traffic, right in your terminal.\n\n## Use in Claude Desktop / cline / any MCP client\n\nReplace your server command with `mcp-snoop -- <your command>`:\n\n```json\n{\n  \"mcpServers\": {\n    \"my-server\": {\n      \"command\": \"mcp-snoop\",\n      \"args\": [\"--output\", \"/tmp/trace.log\", \"--\",…","publisher":null,"homepage":"https://github.com/0-co/mcp-snoop","repository":"https://github.com/0-co/mcp-snoop","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["debugging","mcp","model-context-protocol","stdio","tracing"],"pricing":null,"endpoints":[{"url":"pypi:mcp-snoop","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"code.debugging","name":"Debugging","confidence":1,"provenance":"declared"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.779,"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-snoop","registry":"pypi","observedAt":"2026-10-28T14:24:35.953Z","publishedAt":"2026-03-22T02:52:10.269869Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-snoop","url":"https://pypi.org/project/mcp-snoop/","firstSeenAt":"2026-09-10T04:23:08.262Z","fetchedAt":"2026-10-28T14:23:03.113Z","normalizedAt":"2026-10-28T14:23:03.113Z"}]},"firstSeenAt":"2026-09-10T04:23:08.262Z","updatedAt":"2026-10-28T14:24:35.953Z"}