ProdPoke MCP Server

A QA tester inside your AI. Chat with ProdPoke from Claude, Cursor, or any MCP client. It launches real Playwright browsers, finds real bugs, and remembers what you talked about across turns.

Hosted, not installed. Just paste a config into your MCP client and go.

Landing page · Get an API key · Pricing · ProdPoke

<p align="center"> <img src="assets/demo.gif" alt="ProdPoke MCP demo — scanning a site from Claude Desktop" width="720" /> </p>

---

What it does

ProdPoke is a remote, stateful MCP server that runs real-browser QA for any website. You describe what you want in plain English; ProdPoke spins up a headless Playwright session, navigates the site, and streams back structured findings — accessibility, SEO, performance, user-flow bugs, visual regressions, broken CTAs, and more.

Unlike local tools, everything runs on ProdPoke infrastructure. No Chromium to install, no browser containers to manage, no cleanup.

Available tools

Tool	Description	Parameters
chat	Talk to ProdPoke like a QA tester — scan a URL, test a flow, investigate findings, set session preferences. Stateful via session_id.	message (required), session_id (optional)
get_credit_balance	Check your remaining scan credits.	—

Example chat response

{
  "session_id": "a1b2c3d4-...",
  "response": "Found 3 issues on https://example.com...",
  "findings": [
    {
      "severity": "high",
      "category": "accessibility",
      "title": "Missing alt text on 4 images",
      "description": "Images in the hero section lack alt attributes..."
    },
    {
      "severity": "medium",
      "category": "seo",
      "title": "Missing meta description",
      "description": "The page has no meta description tag..."
    }
  ],
  "session_context": {
    "url_being_tested": "https://example.com",
    "message_count": 2,
    "has_findings": true
  }
}

---

Setup

1. Get your API key

1. Sign up for a ProdPoke account — the free tier includes 500 credits, enough for a first scan.
2. Go to Settings → API Keys.
3. Click Create new key and copy it immediately (it's shown once; you can't recover it later, but you can revoke and re-mint).

Keys look like pp_ followed by 64 hex characters.

2. Paste the config into your MCP client

<details open> <summary><strong>Claude Desktop / Cursor / Claude Code</strong> (streamable HTTP — recommended)</summary>

{
  "mcpServers": {
    "prodpoke": {
      "type": "streamable-http",
      "url": "https://prodpoke.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer pp_YOUR_KEY_HERE"
      }
    }
  }
}

Config file locations:

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
• Claude Code: .mcp.json in your project root
• Cursor: Settings → MCP Servers

Fully restart the client after editing.

</details>

<details> <summary><strong>Clients that only support stdio</strong> (via <code>mcp-remote</code> bridge)</summary>

{
  "mcpServers": {
    "prodpoke": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://prodpoke.com/v1/mcp",
        "--header",
        "Authorization: Bearer ${PRODPOKE_API_KEY}"
      ],
      "env": {
        "PRODPOKE_API_KEY": "pp_YOUR_KEY_HERE"
      }
    }
  }
}

Uses mcp-remote to proxy stdio ↔ streamable HTTP.

</details>

3. Start chatting

Try any of these:

• "Scan https://mysite.com and tell me what's broken"
• "Run an accessibility audit on https://example.com"
• "Test the signup flow on https://app.example.com — fill the form and check the confirmation page"
• "What bugs have you found on mysite.com?"
• "Scan https://competitor.com and compare their SEO headers to ours"
• "Check my ProdPoke credit balance"

---

Multi-step sessions

The chat tool is stateful. Each response includes a session_id; pass it back to continue the conversation with full context:

1. chat("Scan https://mysite.com") — starts a session, runs the scan, returns session_id + findings.
2. chat("Dig deeper into the accessibility issues", session_id="...") — builds on the prior scan.
3. chat("Now test the checkout flow", session_id="...") — runs a targeted test, knows about the earlier findings.
4. chat("What should I fix first?", session_id="...") — answers from the accumulated session context.

Sessions persist across MCP client restarts for the lifetime of the key.

---

How it works

Your MCP client  ──Authorization: Bearer pp_...──▶  https://prodpoke.com/v1/mcp
                                                       │
                                                       ▼
                                           Orchestrator classifies intent
                                                       │
                                                       ▼
                                           Playwright worker on ProdPoke
                                            infrastructure runs the scan
                                                       │
                                                       ▼
                                          Findings streamed back as a
                                               structured `chat` response

Nothing is installed on your machine. Scans run on our servers. You pay per scan in credits (see below).

---

Pricing

Plan	Credits	Price
Free tier	500 credits	$0
Watch	10,000 / month	$15 / month
Watch Pro	50,000 / month	$49 / month
Top-up packs	1,000 – 50,000	From $3

A standard scan costs roughly 10 credits. Deeper workflows — full user-flow tests, competitor comparisons — run 400–500 credits. See full pricing →

The error message when you're out of credits is explicit: "Insufficient credits. You need N but have M.", so your AI client can surface it clearly.

---

Troubleshooting

• 401 Missing Authorization header — your client didn't send the Authorization header. Double-check the config (the key goes in headers, not env, for streamable HTTP).
• 401 Invalid or revoked API key — the key was revoked or typed incorrectly. Re-mint at /app/settings/keys.
• The tool responds but never runs a scan — ask it to scan a specific URL. ProdPoke needs a URL to launch a browser; it won't guess.
• Scan hangs for >2 minutes — the MCP call times out at 120 seconds per step. Long flows should be split into multiple chat turns using session_id.

---

Links

• ProdPoke
• MCP landing page
• API Keys dashboard
• Pricing
• MCP Protocol specification

License

MIT — see LICENSE.