@growthscrapers/b2b-leads-mcp

Official Model Context Protocol (MCP) server for GrowthScrapers. Exposes 10 production-grade B2B web scrapers and lead generation actors directly as native AI tools inside Claude Desktop, Cursor, Windsurf, Cline, Roo Code, OpenAI Agents SDK, and n8n.

Zero server infrastructure required — runs locally in <50ms via npx and executes scrapers on Apify Cloud on a transparent Pay-Per-Result basis.

⚡ Quickstart

1. Claude Desktop

Add this to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "growthscrapers": {
      "command": "npx",
      "args": ["-y", "@growthscrapers/b2b-leads-mcp"],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN_HERE"
      }
    }
  }
}

💡 Get an Apify Token: Sign up and retrieve your personal token from Apify Console Integrations.

2. Cursor IDE

Create or edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "growthscrapers": {
      "command": "npx",
      "args": ["-y", "@growthscrapers/b2b-leads-mcp"],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN_HERE"
      }
    }
  }
}

3. Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "growthscrapers": {
      "command": "npx",
      "args": ["-y", "@growthscrapers/b2b-leads-mcp"],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN_HERE"
      }
    }
  }
}

4. Smithery.ai (1-Click Install)

Install automatically using the Smithery CLI:

npx -y @smithery/cli install @growthscrapers/b2b-leads-mcp --client claude

🛠️ Registered Tools (All 15 GrowthScrapers Actors + 1 Catalog Inspector = 16 Tools)

| Tool Name | Target Platform / Data | Category | Apify Pricing | | :--- | :--- | :--- | :--- | | scrape_google_maps_leads | Google Maps businesses, phones, websites, ratings, hours | Leads | $0.003 / lead | | analyze_shopify_store_tech | Shopify store pixels (Meta, TikTok, GA4), apps, emails | E-Commerce | $0.005 / store | | scrape_yellowpages_usa_b2b | YellowPages USA local businesses, contractors, phones, addresses | Leads | $0.003 / lead | | scrape_justdial_b2b_leads | Justdial local business listings, unmasked phone numbers, ratings, badges | Leads | $0.003 / lead | | scrape_meta_ad_library | Meta Ad Library active ads, winning creatives (30+ days), copy, CTAs, landing pages | Marketing | $0.005 / ad | | scrape_google_ads_transparency | Google Ads Transparency search/display/video ads, verified advertisers, copy | Marketing | $0.005 / ad | | scrape_clutch_b2b_agencies | Clutch top B2B marketing & software agencies, hourly rates, project sizes | Leads | $0.005 / agency | | scrape_houzz_architects_designers| Houzz interior designers, architects, project portfolios, job budgets | Leads | $0.004 / studio | | scrape_indiamart_suppliers | IndiaMART wholesale suppliers, manufacturers, pricing, MOQ | B2B Suppliers | $0.003 / supplier | | scrape_tradeindia_suppliers | TradeIndia verified suppliers, trust badges, MOQ, contacts | B2B Suppliers | $0.003 / supplier | | scrape_practo_doctors | Practo verified doctors, specialties, clinics, fees, reviews | Healthcare | $0.004 / doctor | | scrape_rera_projects | State RERA registered projects, builders, RERA IDs, certificates | Real Estate | $0.004 / project | | scrape_bayut_dubai_properties| Bayut Dubai luxury listings, broker agencies, agent contacts | Real Estate | $0.004 / property | | scrape_zomato_swiggy_menus | Zomato & Swiggy restaurant menus, dish pricing, FSSAI numbers | Food & F&B | $0.003 / restaurant| | scrape_magicbricks_india_properties| MagicBricks real estate properties, builders, BHK, localities | Real Estate | $0.003 / property | | list_growthscrapers_actors | Free portfolio catalog, store URLs, and parameter schemas | Meta / Info | Free ($0.00) |

💡 Example AI Agent Prompts

B2B Local Lead Generation

"Find 20 roofing contractors in Austin, TX with direct phone numbers and websites using scrape_yellowpages_usa_b2b. Format them into a contact table."

E-Commerce Competitor Tech Audit

"Audit boat-lifestyle.com and kyliecosmetics.com using analyze_shopify_store_tech. List their tracking pixels, installed apps, active Shopify theme, and official contact emails."

Real Estate Market Intelligence

"Scrape 15 luxury 2-bedroom apartments for sale in Dubai Marina using scrape_bayut_dubai_properties. Summarize average price per sqft and top listing broker agencies."

Healthcare & Doctor Outreach

"Extract 25 dentists in Bangalore from Practo using scrape_practo_doctors. Include doctor names, clinic localities, experience, and consultation fees."

💻 CLI Commands & Inspection

Verify your setup locally without running an AI agent:

# Print version
npx -y @growthscrapers/b2b-leads-mcp --version

# List all 11 registered MCP tools, categories & pricing
npx -y @growthscrapers/b2b-leads-mcp --list-tools

# Show CLI help
npx -y @growthscrapers/b2b-leads-mcp --help

🔒 Privacy & Security

• No Token Leaking: APIFY_TOKEN is used strictly in secure Authorization headers to the official Apify Cloud API (https://api.apify.com/v2/).
• Zero Logging of Secrets: All internal logging automatically masks tokens (apif...****).
• Zero Local Telemetry: No tracking, analytics, or third-party pings.

🧪 Development & Testing

# Clone the repository
git clone https://github.com/growthscrapers/growthscrapers-b2b-mcp-server.git
cd growthscrapers-b2b-mcp-server

# Run the automated test suite (100% standard library node:test)
npm test

📄 License

MIT © GrowthScrapers