{
  "markdown": "# brawsr MCP server\n\nThe authenticated local MCP bridge for brawsr browser sessions, checkpoints,\nrewind, and fork. It uses the official packaged `@brawsr/sdk`; it does not\nduplicate API models, poll orchestration, or browser/CDP behavior.\n\nThe v0.2 transport is local stdio and requires Node.js 22+.\n\n## Install and configure\n\nMCP clients spawn the server locally. Pin the package version in client\nconfiguration so an MCP client restart cannot silently select a newer release:\n\n```json\n{\n  \"mcpServers\": {\n    \"brawsr\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@brawsr/mcp-server@0.2.0\"],\n      \"env\": {\n        \"BRAWSR_API_KEY\": \"your-brawsr-api-key\"\n      }\n    }\n  }\n}\n```\n\nThe npm package includes the official `@brawsr/sdk`; no second package install\nis required. `BRAWSR_API_KEY` is the only required environment variable. The\nproduction endpoint `https://api.brawsr.io` is built in.\n\nFor local development or another deployment, `BRAWSR_BASE_URL` may explicitly\noverride that endpoint. `BRAWSR_MCP_TIMEOUT_MS` optionally changes the default\nbounded operation wait from 30 seconds and accepts an integer from 1 through 300000.\n\nThe API key is never a tool argument or result. Standard output is reserved for\nMCP protocol messages. Redacted lifecycle diagnostics use standard error. A\ndirect shell launch uses the same executable:\n\n```bash\nBRAWSR_API_KEY=... npx -y @brawsr/mcp-server@0.2.0\n```\n\n## Tools\n\n- `brawsr_create_session`, `brawsr_list_sessions`, `brawsr_get_session`,\n  `brawsr_update_session_label`, `brawsr_close_session`\n- `brawsr_close_sessions`\n- `brawsr_create_checkpoint`, `brawsr_get_checkpoint`,\n  `brawsr_list_checkpoints`, `brawsr_delete_checkpoint`\n- `brawsr_list_rewindable_checkpoints`, `brawsr_list_session_activity`,\n  `brawsr_get_session_lineage`\n- `brawsr_rewind`, `brawsr_fork`\n- `brawsr_get_operation`, `brawsr_wait_operation`\n\nSession creation accepts an optional `display_label`. The same label can be\nchanged or cleared with one `brawsr_update_session_label` call. Session lists\nare newest-first, bounded, and may include retained closed or expired sessions.\n`brawsr_get_session` includes a CDP URL only while the session is attachable.\n\n`brawsr_list_checkpoints` is capture history: it can include deleted captures\nfor audit and dashboard views. Use `brawsr_list_rewindable_checkpoints` when\nchoosing a valid rewind or fork target. Lineage returns one session, its\noptional parent fork edge, and one bounded page of direct children; callers can\nfollow child session IDs to browse a nested fork tree. Pagination cursors are\nopaque and may be passed back unchanged.\n\nCheckpoint, rewind, and fork are one high-level tool call. The packaged SDK\nhides ordinary `202` polling. Rewind returns as soon as its result is CDP-usable;\nthe operation may finish bounded post-restore work in the background. A timeout\nstops only local waiting and returns the operation/idempotency recovery fields;\nserver work continues.\n\nFork children are independent peer sessions, not implicit winners or losers.\nThere is no browser-state merge and no automatic sibling cleanup. Rewind\nrestores browser/client state, not remote website side effects, and makes old\nCDP/browser handles stale. Long-lived WSS/SSE/WebRTC streams may need\napplication-level reconnection.\n\nCDP URLs are sensitive structured outputs. The MCP server never returns the\nAuthorization header. Use the ordinary SDK or a supported framework to attach;\nthe MCP server does not proxy CDP.\n\nRemote Streamable HTTP, OAuth, hosted multi-tenancy, legacy HTTP+SSE, and\nresumable MCP sessions are deferred beyond the local v0.2 stdio boundary.\n\n## Development\n\n```bash\nnpm ci\nnpm run verify\n```\n\nRelease archives are built reproducibly with the pinned Node 24 and npm 11.5.1\ntoolchain. CI also exercises the server and its real MCP client boundary on\nNode 22 and Node 24. npm hosts the executable package; the official MCP Registry\nhosts discovery metadata for `io.github.brawsr/brawsr`.\n",
  "bytes": 3970,
  "sha": "3735a45723ce5686acb721f225bba1c17ccf039c8a66b602b6bb4a4898e0d998",
  "repo_slug": "brawsr/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_brawsr_brawsr_740a05fd/readme"
}