@webxport/mcp

MCP server that lets AI agents (Claude Code / Cursor / Codex / Cherry Studio, anything MCP-capable) call your locally-recorded webXport browser workflows.

Changelog

0.3.0 (2026-05-22)

• Multi-Profile support: server now accepts concurrent WebSocket connections from multiple Chrome Profiles (cross-border sellers running multi-shop setups). list_scripts aggregates across all Profiles; each script entry includes a profile field for AI to disambiguate same-name scripts.
• run_script / set_schedule / update_script_params / get_runs(name): when same script name exists in multiple Profiles, pass profile arg to specify which one. Single-match case auto-routes.
• Breaking: get_recent_logs return shape changed from flat LogEntry[] to [{profile, entries: LogEntry[]}] (so logs from each Profile are annotated). AI prompts written for 0.2.0 may need updating.
• Breaking: get_runs without name returns flat list with profile field per entry instead of grouped-by-name (server-side flattening; same data).

0.2.0

• Initial public release.

Install (in your AI client)

Prerequisite: webXport Chrome extension installed and logged in. https://chromewebstore.google.com/detail/apdnkhgfafpdaomlomplocldgbmipmoh

Claude Code

claude mcp add -s user webxport npx -y @webxport/mcp

Cursor / Codex / others

Add to your MCP config (e.g. ~/.cursor/mcp.json):

{
  "mcpServers": {
    "webxport": {
      "command": "npx",
      "args": ["-y", "@webxport/mcp"]
    }
  }
}

Restart your AI client. You should see list_scripts, run_script, get_runs, get_run_status available as tools.

What it does

AI client <─stdio─> @webxport/mcp <─WebSocket(127.0.0.1:7654)─> Chrome extension

The MCP server is a thin bridge — it has no logic of its own. Recording/replay happens in the Chrome extension on your already-logged-in browser sessions. AI never reads the screen and never opens new browser tabs — it only calls your pre-recorded scripts with parameters you've exposed.

Requirements

• Node.js ≥ 18 (npx works out of the box on macOS / Linux / Windows)
• webXport extension installed and logged in (free 14-day trial of MCP access; ¥30/month thereafter)

Troubleshooting

"AI client says no tools available" → Restart the client after mcp add. For Claude Code, check claude mcp list.

"All script calls fail with 'license not active'" → Open the extension popup, check the account bar shows active subscription. Free users can record + replay locally but not call via MCP.

"Extension not responding" → Make sure Chrome is open (the WebSocket bridge needs the extension's service worker active).

License

MIT