Back to Browse

Scrapercity Cli MCP Server

Search & WebLow Risk8.0Local
Free

B2B lead generation MCP server - 20+ scrapers, email finder, skip trace, and more.

About

B2B lead generation MCP server - 20+ scrapers, email finder, skip trace, and more.

Security Report

8.0
Low Risk8.0Low Risk

Valid MCP server (2 strong, 4 medium validity signals). 2 known CVEs in dependencies (0 critical, 2 high severity) Package registry verified. Imported from the Official MCP Registry.

4 files analyzed · 3 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your ScraperCity API keyRequired

Environment variable: SCRAPERCITY_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-scrapercity-scrapercity-cli": {
      "env": {
        "SCRAPERCITY_API_KEY": "your-scrapercity-api-key-here"
      },
      "args": [
        "-y",
        "scrapercity"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

ScraperCity - B2B Lead Generation for AI Agents

Pull leads, validate emails, find mobile numbers, and scrape business data - all from your AI agent, CLI, or code.

ScraperCity gives AI agents access to 15+ B2B data tools: Apollo scraping, Google Maps extraction, email finding/validation, mobile number lookup, skip tracing, ecommerce store data, criminal records, and more.

Quick Start

Option 1: CLI

npx scrapercity login            # enter your API key
npx scrapercity wallet           # check balance
npx scrapercity maps -q "plumbers" -l "Denver, CO"
npx scrapercity poll <runId>     # wait for results
npx scrapercity download <runId> # save CSV

Option 2: MCP Server (Claude Code, Cursor, Windsurf, etc.)

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

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

Then tell your AI: "Find 1000 plumbers in Denver with emails using ScraperCity"

Option 3: Skill File (Claude Code)

Copy the skill file into your project:

npx scrapercity-mcp --print-skill > SCRAPERCITY_SKILL.md

Or download from: https://scrapercity.com/agents/SKILL.md

Then in Claude Code: "Read SCRAPERCITY_SKILL.md and find me 2000 marketing directors at SaaS companies in California, validate their emails, and save to leads.csv"

Option 4: Direct API

# Start a Maps scrape
curl -X POST https://app.scrapercity.com/api/v1/scrape/maps \
  -H "Authorization: Bearer $SCRAPERCITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"searchStringsArray":["plumbers"],"locationQuery":"Denver, CO","maxCrawledPlacesPerSearch":500}'

# Check status
curl https://app.scrapercity.com/api/v1/scrape/status/RUN_ID \
  -H "Authorization: Bearer $SCRAPERCITY_API_KEY"

# Download CSV when SUCCEEDED
curl -O https://app.scrapercity.com/api/downloads/RUN_ID \
  -H "Authorization: Bearer $SCRAPERCITY_API_KEY"

Available Tools

ToolWhat it doesCost
ApolloB2B contacts by job title, industry, location$0.0039/lead
Google MapsLocal businesses with phones, emails, reviews$0.01/place
Email ValidatorVerify deliverability, catch-all, MX records$0.0036/email
Email FinderFind business email from name + company$0.05/contact
Mobile FinderPhone numbers from LinkedIn or email$0.25/input
People FinderSkip trace by name, email, phone, address$0.02/result
Store LeadsShopify/WooCommerce stores with contacts$0.0039/lead
BuiltWithAll sites using a technology$4.99/search
Criminal RecordsBackground check by name$1.00 if found
Lead Database3M+ B2B contacts, instant query ($649 plan)Included

How It Works

  1. Start a scrape → get a runId
  2. Poll status (or use webhooks) → wait for SUCCEEDED
  3. Download CSV → leads with full contact info

Apollo scrapes take 11-48+ hours. All other scrapers: 1-30 minutes. Store leads are instant.

Authentication

Get your API key at app.scrapercity.com/dashboard/api-docs

# Environment variable (recommended)
export SCRAPERCITY_API_KEY="your_key"

# Or save to config file
npx scrapercity login

Webhooks

For Apollo and long-running scrapes, configure a webhook at app.scrapercity.com/dashboard/webhooks to get notified when results are ready.

Plans

PlanPriceCredits
TrialFree$5
Starter$49/mo$49
Growth$149/mo$149 + 10% bonus
Professional$649/mo$649 + 30% bonus + Database API

Buy additional credits anytime. scrapercity.com/pricing

Links

License

MIT

Reviews

No reviews yet

Be the first to review this server!