[codex] Add Replay MCP stdio bridge

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 tries existing Replay CLI authentication first, 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`, the Auth0
+audience can be overridden with `REPLAY_MCP_OAUTH_AUDIENCE`, and the loopback callback
+can be overridden with `REPLAY_MCP_OAUTH_REDIRECT_URL`. The default OAuth callback is
+`http://localhost: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";