MCP Server

Connect polyscrape to your AI assistant.

Use ChatGPT or Claude in the browser? Add the URL and sign in with OAuth. Working in a dev tool? Paste a small config with your API key.

OAuth for ChatGPT & Claude POST /mcp Streamable HTTP

Browser assistants

In ChatGPT and Claude, paste the server URL and sign in with OAuth. No keys, no files.

ChatGPT · Claude · Claude Desktop

Developer tools

In Claude Code, Cursor, VS Code, Windsurf, and Cline — drop in a small config with your API key, then restart.

Claude Code · Cursor · VS Code · Windsurf · Cline

Raw protocol

Any MCP-over-HTTP client, or curl for debugging: send your key as a Bearer token.

curl · custom clients

MCP server URL

https://polyscrape.com/mcp

Browser assistants (ChatGPT, Claude) sign in with polyscrape OAuth, nothing to paste. Developer tools send Authorization: Bearer <key>.

You're not signed in, so dev-tool snippets show a YOUR_API_KEY placeholder. Sign in to auto-fill your real key and copy-paste with zero edits.

Get a free API key
Browser assistants, sign in with OAuth

No files, no terminal. ChatGPT connects to one URL and you sign in with polyscrape.

  1. 1
    In ChatGPT, open Settings → Apps → Advanced settings and turn on Developer mode. On a Business/Enterprise/Edu workspace, an admin enables it first.
  2. 2
    Open Apps and choose Create (or Add custom app / connector).
  3. 3
    Name it polyscrape, set Authentication to OAuth, and paste the server URL:
    Server URL
    https://polyscrape.com/mcp
  4. 4
    Click Create, then Connect — a polyscrape window opens; sign in (or you're recognised if already signed in) and approve. ChatGPT handles tokens for you.
  5. 5
    Start a chat and ask: “Using polyscrape, scrape https://example.com and give me the Markdown.”

OAuth means there's no key to paste or leak — calls bill to your account, and you can disconnect any time from ChatGPT. Custom MCP apps run in Developer mode, available on Plus, Pro, Business, Enterprise and Edu; every polyscrape tool is read-only, so Plus and Pro work too. On the free plan, or if you don't see Developer mode or a Create button, check your plan and workspace policy or use a developer tool with your API key instead.

Developer tools, send your API key
  1. 1
    Run this once in your terminal — it registers the server for the current project. Add -s user to enable it in every project.
    Terminal
    claude mcp add --transport http polyscrape https://polyscrape.com/mcp \
      --header "Authorization: Bearer YOUR_API_KEY"
  2. 2
    Verify it's registered with claude mcp list, then ask Claude to use a polyscrape tool.

Tip: keep the key out of your shell history — export POLYSCRAPE_API_KEY=… first, then use "Authorization: Bearer $POLYSCRAPE_API_KEY".

Raw protocol, curl, for debugging

Any client that speaks Streamable HTTP works. To sanity-check the protocol, call the JSON-RPC endpoint directly. Per the MCP Streamable HTTP spec, clients advertise both application/json and text/event-stream in Accept; polyscrape replies with a single JSON response. Header clients authenticate with Authorization: Bearer YOUR_API_KEY.

tools/list
curl -sS https://polyscrape.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
tools/call · scrape
curl -sS https://polyscrape.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"scrape","arguments":{"url":"https://example.com"}}}'

Connector details (optional)

When you create a connector, ChatGPT may ask for a name, description and icon. They're optional: copy our ready-made set, or skip them. Claude only asks for a name.

Name

polyscrape

polyscrape connector icon

Icon

Square PNG, ready to upload

Download

Description

Scrape any URL or run a web search and get clean, LLM-ready Markdown back.

Recommended: add the Skill (optional)

MCP gives your agent the tools. The free Skill is the playbook for using them well, so it searches, scrapes the right pages, and cites each source. One plain SKILL.md file.

Add the Skill

Tool reference

Four tools, mirroring the REST API.

Tool What it does Price
scrape Fetch any URL (web page or document) through a real Chrome fingerprint and return clean Markdown plus the raw HTML. Cached up to 30 days. $0.001 / 1K words
search Run a web search and return the top results, each with its page already scraped to Markdown. 1 to 10 results. $0.001 + $0.002/result
parse Convert a base64-encoded document (PDF, Office, EPUB, CSV, XML) to clean Markdown. Up to 25 MB, stateless. $0.001 / 1K words
account_balance Your remaining prepaid balance, as a dollar amount. No arguments. Free

These mirror the REST API 1:1 — anything you can do over HTTP, you can do as a tool. Browse the full API.

Billing is shared with the REST API

MCP calls draw from the same prepaid balance, no subscription, no monthly credits. scrape and parse cost $0.001 per 1,000 words of Markdown returned (capped at $0.10); search costs $0.001 plus $0.002 per result, on REST and MCP alike. account_balance is free. When your balance hits zero, calls return a 402 until you top up.

MCP FAQ

The questions teams ask before they connect

Setup & Connection

Custom MCP needs the right plan and mode. In ChatGPT, custom apps live under Settings → Apps → Advanced settings → Developer mode (Plus, Pro, Business, Enterprise or Edu; an admin enables it on workspaces). In Claude, custom connectors are on Free (one connector), Pro, Max, Team and Enterprise. If the option is missing, check your plan and workspace policy, or use a developer tool (Claude Code, Cursor, VS Code, Windsurf, Cline) with your API key instead.
Restart the client after editing its config; most only read MCP servers on launch (Windsurf needs a full quit and reopen). For browser connectors, disconnect and reconnect. Check the endpoint is exactly https://polyscrape.com/mcp.
For ChatGPT and Claude (OAuth), just remove the polyscrape connector in the client — that revokes its access; there's no URL or key to rotate. For header-based clients, rotating your API key from the dashboard invalidates the old key everywhere it's used.
polyscrape's MCP server uses Streamable HTTP. Clients advertise both application/json and text/event-stream in Accept per the spec; we reply with JSON (one response per request, no session stream). Modern clients (Claude, Cursor, VS Code) handle this automatically; pick HTTP / Streamable HTTP if your client offers a transport choice. In Cline, set "type": "streamableHttp" so it doesn't fall back to legacy SSE.

Auth & Billing

Browser apps (ChatGPT, Claude, Claude Desktop) connect over OAuth: you sign in with polyscrape once and the client manages tokens; there's nothing to paste. Header-based clients (Claude Code, Cursor, VS Code, Windsurf, Cline, curl) send your API key as Authorization: Bearer. Both bill the same prepaid balance.
In ChatGPT/Claude, reconnect and sign in again if access expired. In a header client, send Authorization: Bearer YOUR_API_KEY and check the key wasn't truncated when copied — the copy button on each snippet grabs the full key.
Per call, from the same prepaid balance as the REST API. Prices are listed in the tool table above; no subscription, and your balance never expires.
Your balance is empty. Top up from your dashboard and the same key keeps working; paid calls resume immediately.
Yes. 10 requests per second per API key, shared across REST and MCP. Going over returns a 429, which costs nothing; add a short backoff and retry.

Give your product and agents clean Markdown.

Start with a free key and $0.50 free balance, on REST, MCP, or both.