What plan do I need to use the API with agents?

Any plan works. The $49, $149, and $649 plans all include API access. Scrapers deduct from your wallet balance per lead. The Lead Database query endpoint specifically requires the $649/mo plan.

What AI tools support MCP?

Claude Code, Cursor, Windsurf, Cline, Devin, OpenAI Codex, and any tool that supports the Model Context Protocol. The CLI works with any agent that can run shell commands.

Is there a rate limit?

There is no hard rate limit beyond your wallet balance. Duplicate protection blocks identical requests within 30 seconds. The Lead Database endpoint has a 100,000 leads per day limit.

How does Apollo delivery work for agents?

Apollo scrapes take up to 4 days to deliver. Set up a webhook at app.scrapercity.com/dashboard/webhooks to get notified when results are ready. Do not have your agent poll in a tight loop.

Can agents burn through my credits accidentally?

Your wallet balance acts as a natural ceiling. Agents cannot spend more than your balance. Duplicate protection also blocks rapid-fire identical requests. For extra safety, you can create a separate API key for agent use.

Do I need to install anything on the ScraperCity side?

No. The MCP server and CLI run on your machine. ScraperCity just sees normal API requests. Nothing changes on your backend.

ScraperCity for AI Agents - MCP Server, CLI & Skill File

Choose Your Integration Method

1MCP Server (Recommended)

Add ScraperCity as a tool your AI agent can call directly. Works with any MCP-compatible client.

Add to your MCP config (e.g. ~/.claude/claude_desktop_config.json for Claude Code):

{
  "mcpServers": {
    "scrapercity": {
      "command": "npx",
      "args": ["-y", "scrapercity"],
      "env": {
        "SCRAPERCITY_API_KEY": "your_api_key_here"
      }
    }
  }
}

The agent gets 16 tools: Apollo scraping, Maps, email validation, email finder, mobile finder, people finder, store leads, BuiltWith, criminal records, wallet check, status polling, downloads, and lead database queries.

2CLI

A command-line tool that turns 20-line API requests into 5-word commands. Works with any agent that can execute shell commands.

# Install and authenticate
npx scrapercity login

# Check balance
npx scrapercity wallet

# Scrape Google Maps
npx scrapercity maps -q "plumbers" -l "Denver, CO" --limit 500

# Poll until done
npx scrapercity poll <runId>

# Download CSV
npx scrapercity download <runId> -o plumbers.csv

3Skill File

A compressed doc your agent reads once to understand every ScraperCity endpoint, input format, cost, and error code. Drop it in your project and go.

# Download the skill file into your project
curl -o SCRAPERCITY_SKILL.md https://scrapercity.com/agents/SKILL.md

# Then tell your agent:
"Read SCRAPERCITY_SKILL.md and find me 2000 marketing directors
at SaaS companies in California. Validate their emails and
save the results to leads.csv"

View the skill file →

Available Tools

Tool	What It Does	Cost	Speed
Apollo	B2B contacts by title, industry, location	$0.0039/lead	~4 days
Google Maps	Local businesses with phones, emails, reviews	$0.01/place	5-30 min
Email Validator	Verify deliverability, catch-all, MX records	$0.0036/email	1-10 min
Email Finder	Business email from name + company	$0.05/contact	1-10 min
Mobile Finder	Phone numbers from LinkedIn or email	$0.25/input	1-5 min
People Finder	Skip trace by name, email, phone, address	$0.02/result	2-10 min
Store Leads	Shopify/WooCommerce stores with contacts	$0.0039/lead	Instant
BuiltWith	All sites using a technology	$4.99/search	1-5 min
Criminal Records	Background check by name	$1.00 if found	2-5 min
Airbnb Email	Host emails by city or listing URL	$0.0001/listing	10-30 min
YouTube Email	Business emails for YouTube channels	Per channel	5-15 min
Website Finder	Contact info from website domains	Per domain	5-15 min
Yelp	Business listings from Yelp	$0.01/listing	5-15 min
Angi	Service providers from Angie's List	$0.01/listing	5-15 min
Zillow Agents	Real estate agent listings	Per agent	5-15 min
BizBuySell	Businesses for sale listings	$0.01/listing	5-15 min
Crexi	Commercial real estate listings	$0.029/listing	5-15 min
Property Lookup	Property data + owner contact	$0.15/address	2-10 min
Lead Database	3M+ B2B contacts, instant query	$649/mo plan	Instant

Example Agent Prompts

“Find 2000 marketing directors at SaaS companies in California, validate their emails, find their mobile numbers, and save everything to leads.csv”

The agent chains 3 tools: Apollo scrape → email validation → mobile finder. Downloads and merges the CSVs automatically.

“Scrape all plumbers in Denver from Google Maps, then find the business owner's email for each one”

Maps scrape returns businesses. Agent extracts names + domains, feeds them to email finder, merges results.

“Check my ScraperCity balance, then pull 500 Shopify stores in the US that have Instagram accounts and export to CSV”

Agent calls wallet first to verify credits, then runs store-leads with the Instagram filter, downloads results.

“Query the lead database for all VPs of Sales at companies with 50-200 employees in New York. Paginate through every page and save to nyc-vps.csv”

Agent reads the pagination response, loops through all pages at 100 leads each, combines into a single CSV.

Tips

Apollo scrapes take up to 4 days. Configure a webhook at app.scrapercity.com/dashboard/webhooks instead of having your agent poll in a loop. All other scrapers complete in minutes.

Always have the agent check wallet balance before running expensive scrapes. This prevents 402 errors mid-workflow.

For Claude Code, add the SCRAPERCITY_SKILL.md file to your project root. Claude Code reads it automatically, so the agent always knows how to call the API.

Create a separate API key for agent use. If you need to revoke it, your manual access is unaffected.

Store leads (ecommerce data) are instant and cost $0.0039/lead from a cached database. Great for agent workflows that need fast results.

ScraperCity for AI Agents

Compatible With