{
  "markdown": "# UserTapes MCP Server\n\n[UserTapes](https://usertapes.com) is a session replay tool. This is its\n[Model Context Protocol](https://modelcontextprotocol.io) server: a hosted,\nstateless JSON-RPC endpoint that lets any MCP client — Claude Code, Claude\nDesktop, Cursor, or your own agent — query what real users did on your site.\n\nThis repo does not contain the server's application source (that lives in the\nmain UserTapes codebase). It exists to document and register the public\nconnection details: the endpoint, its tools, and how to authenticate.\n\n## Why\n\nYour coding agent can read your repository, your git history, and your test\noutput. None of that describes what a real person actually did when something\nbroke. UserTapes derives a text transcript from every recorded session —\nclicks, navigation, errors, rage clicks — so an agent can query sessions the\nsame way it queries anything else, instead of you exporting a video and\npasting it into a prompt.\n\n## Connecting\n\nThe server is one HTTP endpoint speaking stateless JSON-RPC 2.0 over\nStreamable HTTP (protocol revision `2025-06-18`). Get a token from your\naccount's **Agent access** page, then add:\n\n```json\n{\n  \"mcpServers\": {\n    \"usertapes\": {\n      \"url\": \"https://usertapes.com/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_MCP_TOKEN\" }\n    }\n  }\n}\n```\n\nNo package install, no local process — the client talks to\n`https://usertapes.com/mcp` directly.\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `list_sites` | The account's sites |\n| `list_tapes` | Sessions for a site, newest first, filterable by errors, rage clicks, URL substring, duration, and date range |\n| `read_transcript` | One session as a markdown transcript |\n| `get_stats` | Aggregate counts over N days |\n| `site_digest` | One-call briefing of the last N days |\n| `list_alerts` / `create_alert` / `delete_alert` | Saved standing watches over sessions (e.g. \"notify when a session hits an error on /checkout\") |\n\nThe MCP token is a distinct, revocable, read-scoped credential — separate from\na site's ingest-only tracking token. Its only write surface is alerts; it\ncannot delete a recording, change a site, or touch billing.\n\n## Docs\n\n- [MCP server docs](https://usertapes.com/docs/mcp) — endpoint, auth, connection config, full tool reference\n- [MCP agent access](https://usertapes.com/features/mcp-server) — feature overview\n- [Session replay over MCP](https://usertapes.com/blog/session-replay-mcp-server) — full protocol details and tool schema\n\n## License\n\nMIT — see [LICENSE](LICENSE). (This repo is documentation and a registry\nmanifest; the UserTapes application itself is closed source.)\n",
  "bytes": 2640,
  "sha": "015d7331e4201c6dfb7af5db5fb57b13b17b7f86d4704ca262f2c7d493b234cf",
  "repo_slug": "mcdca/usertapes-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mcdca_usertapes_mcp_e390e314/readme"
}