Add Replay MCP stdio bridge

Author: BLamy

packages/replayio/README.md

@@ -26,6 +26,32 @@ This CLI will automatically prompt you to log into your Replay account (or to re
 
 The CLI will also prompt you to download the Replay runtime if you have not already done so.
 
+## MCP
+
+The CLI can run Replay's MCP server over stdio using your existing Replay CLI authentication:
+
+```json
+{
+  "mcpServers": {
+    "replay": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "replayio", "mcp"]
+    }
+  }
+}
+```
+
+The command starts without contacting Replay, so MCP clients can install and enumerate
+tools without logging in. The first tool call tries existing Replay CLI authentication,
+using `replayio login` or `REPLAY_API_KEY`. If no CLI token is available, it falls back
+to MCP OAuth using a stable pre-registered client ID and PKCE.
+
+The HTTP endpoint can be overridden with `REPLAY_MCP_SERVER` or `replayio mcp --url <url>`.
+The OAuth client can be overridden with `REPLAY_MCP_OAUTH_CLIENT_ID`, and the loopback
+callback can be overridden with `REPLAY_MCP_OAUTH_REDIRECT_URL`. The default OAuth
+callback is `http://127.0.0.1:42813/callback` and must be registered for the client.
+
 ## Contributing
 
 Contributing guide can be found [here](contributing.md).

packages/replayio/package.json

@@ -29,6 +29,7 @@
   ],
   "homepage": "https://github.com/replayio/replay-cli/blob/main/packages/replayio/README.md",
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
     "@replayio/protocol": "^0.71.0",
     "@replayio/sourcemap-upload": "workspace:^",
     "@types/semver": "^7.5.6",

packages/replayio/src/bin.ts

@@ -11,6 +11,7 @@ import "./commands/info";
 import "./commands/list";
 import "./commands/login";
 import "./commands/logout";
+import "./commands/mcp";
 import "./commands/open";
 import "./commands/record";
 import "./commands/remove";