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.
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.
No files, no terminal. ChatGPT connects to one URL and you sign in with polyscrape.
-
1
In ChatGPT, open
Settings → Apps → Advanced settingsand turn on Developer mode. On a Business/Enterprise/Edu workspace, an admin enables it first. -
2
Open
Appsand choose Create (or Add custom app / connector). -
3
Name it
polyscrape, set Authentication to OAuth, and paste the server URL:Server URLhttps://polyscrape.com/mcp -
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
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.
-
1
Run this once in your terminal — it registers the server for the current project. Add
-s userto enable it in every project.Terminalclaude mcp add --transport http polyscrape https://polyscrape.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" -
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".
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.
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"}'
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
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.
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.
The questions teams ask before they connect
Setup & Connection
Auth & Billing
Give your product and agents clean Markdown.
Start with a free key and $0.50 free balance, on REST, MCP, or both.