MCP - Scraperize

The Scraperize MCP server lets AI assistants use the Scraperize API for you. Your assistant finds the right endpoint, runs the scrape and works with the JSON, using your account’s credits. It’s read-only: it can’t change your account, API keys or billing.

MCP server URL

https://api.scraperize.com/mcp

Quick install

Install in Cursor

Adds the server, then sign in with your API key.

Install in VS Code

Adds the server, then sign in with your API key.

Setup

When an app connects for the first time, a Scraperize page opens in your browser. Paste an API key and click Connect. The app gets its own access token; your key is never shared with it.

Works in Claude on the web and the Claude desktop app.

Add a connector

Go to Settings → Connectors and click Add custom connector.

Enter the server

Name it Scraperize and use https://api.scraperize.com/mcp as the URL.

Connect

Click Connect, paste your API key on the Scraperize page, and click Connect again.

Add a connector

In Settings → Apps & Connectors, create a custom connector. Depending on your plan, you may need to turn on Developer mode under Advanced settings first.

Enter the server

Name it Scraperize, use https://api.scraperize.com/mcp as the URL and choose OAuth for authentication.

Connect

Paste your API key on the Scraperize page and click Connect.

Add the server:

claude mcp add --transport http scraperize https://api.scraperize.com/mcp

Then run /mcp, select scraperize and choose Authenticate to sign in with your API key.To skip the browser step, pass the key as a header instead:

claude mcp add --transport http scraperize https://api.scraperize.com/mcp --header "x-api-key: YOUR_API_KEY"

Use Install in Cursor above, or add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "scraperize": {
      "url": "https://api.scraperize.com/mcp"
    }
  }
}

Then open Settings → Tools & MCP and click Connect next to scraperize to sign in.

Use Install in VS Code above, or add this to .vscode/mcp.json in your workspace:

{
  "servers": {
    "scraperize": {
      "type": "http",
      "url": "https://api.scraperize.com/mcp"
    }
  }
}

Start the server from the file (or MCP: List Servers) and sign in when prompted.

Any MCP client that supports Streamable HTTP can connect. Use OAuth sign-in if the client supports it, or send your API key as a header:

{
  "mcpServers": {
    "scraperize": {
      "url": "https://api.scraperize.com/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Authorization: Bearer YOUR_API_KEY also works.

Give each app its own API key (for example “Claude” or “Cursor”). To disconnect an app, revoke its key in the dashboard. Your other apps and scripts keep working.

Tools

Tool	What it does	Credits
`list_endpoints`	Lists every scrape endpoint, optionally for one platform.	Free
`describe_endpoint`	Shows one endpoint’s parameters, cost and an example response.	Free
`call_endpoint`	Runs a scrape: `{ path, params, cache_max_age? }`. Returns `{ data, meta }`, like the REST API.	Per call
`get_credit_balance`	Your current credit balance.	Free
`get_usage_summary`	Requests, credits and cache hits for the last 7, 30 or 90 days, plus your most-used endpoints.	Free

Your assistant sees every endpoint as soon as it connects, so it can usually go straight to call_endpoint. If a path or parameter is wrong, it gets an error naming the closest endpoint or the valid parameters, and no credits are spent.

Credits and approval

Same as the API: a successful call_endpoint costs the endpoint’s credits (shown in meta.creditsCharged). Errors are free.
Caching: your assistant can pass cache_max_age (1d, 3d, 7d, 14d or 30d) to reuse a recent result for 0 credits.
Approval: call_endpoint is marked as an action that spends credits, so most clients ask before running it. Keep approval on.
Limits: calls share your team’s rate limit and show up in your request history.

Scraped posts and comments are third-party content. Scraperize returns them as data, and tells your assistant never to follow instructions found inside them.

Try it

Once connected, ask your assistant things like:

“Get natgeo’s TikTok profile and summarize their last 10 videos.”
“What has this company posted on LinkedIn this month?” (paste the company page link)
“How many credits do I have left, and what did I use most this week?”

Troubleshooting

The app says it's disconnected or unauthorized

The API key it was connected with was probably revoked. Reconnect the app and paste an active key.

A call fails with INSUFFICIENT_CREDITS

Your balance is lower than the endpoint’s cost. Top up in the dashboard.

A call fails with RATE_LIMITED

Your team hit its per-minute limit. Wait for the time in the error, then try again.

​Quick install

Install in Cursor

Install in VS Code

​Setup

​Tools

​Credits and approval

​Try it

​Troubleshooting

Quick install

Setup

Tools

Credits and approval

Try it

Troubleshooting