Claude Desktop

\n\nAdd this to your Claude Desktop MCP config:\n\n```json\n{\n \"mcpServers\": {\n \"outscraper\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"outscraper-mcp\"],\n \"env\": {\n \"OUTSCRAPER_API_KEY\": \"YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n

\n\n

Claude Code

\n\nAdd the server with the Claude Code CLI:\n\n```bash\nclaude mcp add outscraper -e OUTSCRAPER_API_KEY=YOUR_API_KEY -- npx -y outscraper-mcp\n```\n\n

\n\n

Cursor

\n\nAdd this to your global MCP configuration:\n\n```json\n{\n \"mcpServers\": {\n \"outscraper\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"outscraper-mcp\"],\n \"env\": {\n \"OUTSCRAPER_API_KEY\": \"YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n

\n\n

Windsurf

\n\nAdd this to your MCP config:\n\n```json\n{\n \"mcpServers\": {\n \"outscraper\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"outscraper-mcp\"],\n \"env\": {\n \"OUTSCRAPER_API_KEY\": \"YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n

\n\n

VS Code

\n\nFor `settings.json`:\n\n```json\n{\n \"mcp\": {\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"outscraperApiKey\",\n \"description\": \"Outscraper API Key\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"outscraper\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"outscraper-mcp\"],\n \"env\": {\n \"OUTSCRAPER_API_KEY\": \"${input:outscraperApiKey}\"\n }\n }\n }\n }\n}\n```\n\n

\n\n

Cline / Roo Code / other command-based MCP clients

\n\nUse the standard stdio command form:\n\n```json\n{\n \"mcpServers\": {\n \"outscraper\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"outscraper-mcp\"],\n \"env\": {\n \"OUTSCRAPER_API_KEY\": \"YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n

\n\n

n8n

\n\nFor n8n or other HTTP MCP clients, run the server in Streamable HTTP mode:\n\n```bash\nset HTTP_STREAMABLE_SERVER=true\nset HOST=localhost\nset PORT=3000\nset OUTSCRAPER_API_KEY=YOUR_API_KEY\nnpx -y outscraper-mcp\n```\n\nThen use:\n\n```text\nhttp://localhost:3000/mcp\n```\n\n

\n\n## Tool Examples\n\n### Search businesses with structured filters\n\n```json\n{\n \"filters\": {\n \"country_code\": \"US\",\n \"states\": [\"NY\"],\n \"cities\": [\"New York\"],\n \"types\": [\"restaurant\", \"cafe\"]\n },\n \"fields\": [\"name\", \"phone\", \"website\", \"address\", \"rating\", \"reviews\"],\n \"limit\": 25\n}\n```\n\nNatural-language `query` support on `/businesses` currently depends on Outscraper's own parser behavior. In live testing, structured `filters` were reliable while free-form `query` values often returned `Could not parse query into a valid request format.`\n\n### Extract structured data with AI Scraper\n\n```json\n{\n \"query\": \"https://outscraper.com\",\n \"prompt\": \"Extract company name, company description, and people mentioned on the page.\",\n \"schema\": {\n \"type\": \"object\",\n \"required\": [],\n \"properties\": {\n \"company_name\": { \"type\": \"string\" },\n \"company_description\": { \"type\": \"string\" },\n \"people\": {\n \"type\": \"array\",\n \"items\": { \"type\": \"string\" }\n }\n }\n },\n \"execution_mode\": \"sync\"\n}\n```\n\nUse `execution_mode: \"async\"` if you want a request id and plan to poll later with `requests_get`.\n\n### Get one business\n\n```json\n{\n \"business_id\": \"YOUR_BUSINESS_ID\",\n \"fields\": [\"name\", \"phone\", \"website\", \"address\", \"rating\", \"reviews\"]\n}\n```\n\n### Search Google Maps\n\n```json\n{\n \"query\": [\"restaurants brooklyn usa\"],\n \"limit\": 20,\n \"language\": \"en\",\n \"region\": \"us\"\n}\n```\n\n### Fetch Google Maps reviews\n\n```json\n{\n \"query\": [\"ChIJrc9T9fpYwokRdvjYRHT8nI4\"],\n \"reviews_limit\": 20,\n \"sort\": \"newest\",\n \"language\": \"en\"\n}\n```\n\n### Get company insights\n\n```json\n{\n \"query\": [\"outscraper.com\"],\n \"fields\": [\"name\", \"description\", \"industry\"],\n \"execution_mode\": \"async\"\n}\n```\n\n### Find emails and contacts\n\n```json\n{\n \"query\": [\"outscraper.com\"],\n \"preferred_contacts\": [\"technical\", \"decision makers\"],\n \"execution_mode\": \"sync\"\n}\n```\n\n### Validate email addresses\n\n```json\n{\n \"query\": [\"support@outscraper.com\"],\n \"execution_mode\": \"sync\"\n}\n```\n\n### Fetch Google Maps photos\n\n```json\n{\n \"query\": [\"NoMad Restaurant, NY, USA\"],\n \"photos_limit\": 5,\n \"limit\": 1,\n \"execution_mode\": \"sync\"\n}\n```\n\n### Get chain info\n\n```json\n{\n \"query\": [\"Starbucks, New York, NY, USA\"],\n \"limit\": 1,\n \"execution_mode\": \"sync\"\n}\n```\n\n### Get Trustpilot business data\n\n```json\n{\n \"query\": [\"outscraper.com\"],\n \"execution_mode\": \"sync\"\n}\n```\n\n### Search Google\n\n```json\n{\n \"query\": [\"outscraper\"],\n \"pages_per_query\": 1,\n \"execution_mode\": \"sync\"\n}\n```\n\n### Search Google Images\n\n```json\n{\n \"query\": [\"outscraper\"],\n \"limit\": 5,\n \"execution_mode\": \"sync\"\n}\n```\n\n### Search Indeed\n\n```json\n{\n \"query\": [\"https://www.indeed.com/jobs?q=software+engineer&l=New+York%2C+NY\"],\n \"limit\": 10,\n \"execution_mode\": \"sync\"\n}\n```\n\n### Check account balance\n\n```json\n{}\n```\n\n### Delete async request\n\n```json\n{\n \"request_id\": \"YOUR_REQUEST_ID\"\n}\n```\n\n## Known Limitations\n\n- `businesses_search` works reliably with structured `filters`, but free-form `query` values on `/businesses` may fail with `Could not parse query into a valid request format.` This behavior was reproduced against the live API, not only inside the MCP layer.\n- `ai_scraper` works best through `POST` with a JSON body. In live validation, `POST` accepted `prompt` and `schema` reliably, while `GET` variants around `schema` and `query_schema` did not match the same behavior consistently.\n- When Outscraper OpenAPI examples and live API behavior differ, live endpoint behavior should be treated as the source of truth.\n- `businesses_search` is intentionally exposed here as a synchronous MCP tool because the current `/businesses` OpenAPI shape is request-body-based and did not prove to be a stable async-style workflow during live validation.\n- `execution_mode=\"auto\"` is heuristic-driven. It is designed to choose a practical default, but callers that need deterministic behavior should explicitly use `sync` or `async`.\n- HTTP hosted mode requires correct auth headers when `CLOUD_SERVICE=true`; stdio mode still expects `OUTSCRAPER_API_KEY` in the process environment.\n- `chain_info` is implemented from the documented `ai_chain_info` enrichment on `google-maps-search`, because Outscraper currently does not describe a standalone `chain info` endpoint.\n- `builtwith` is not currently exposed as a tool because Outscraper currently does not document a dedicated BuiltWith endpoint.\n\n## Tool Selection Notes\n\n- Use `businesses_search` for structured business discovery with filters and cursor pagination.\n- Use `businesses_get` once you already have a concrete business id.\n- Use `google_maps_search` for Google Maps-style place discovery from human search queries.\n- Use `google_maps_reviews` when the user specifically needs review data rather than place discovery.\n- Use `company_insights` for firmographics and company profile enrichment.\n- Use `emails_and_contacts` for contact discovery from known domains.\n- Use `requests_get`, `requests_list`, and `requests_delete` only for async lifecycle management.\n- Use `balance_get` for account and billing checks, not business data retrieval.\n\n## Notes\n\n- The server supports stdio, stateless Streamable HTTP, and stateful local HTTP/SSE mode.\n- `CLOUD_SERVICE=true` enables header-based API key resolution for HTTP requests.\n- For npm publication, package contents are intentionally limited to runtime artifacts and docs.\n- Client-specific config snippets in this README are meant as practical templates; the exact settings UI and config key names may vary slightly between MCP clients and versions.\n","changelogMarkdown","videoKey","requiredSecretsJson","[\"X_OUTSCRAPER_API_KEY\"]","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Data & Analytics","upstream",{"_97":98,"_99":100,"_101":102,"_103":104,"_105":106},"requiredSecrets",[96],"tags",[],"assets",[],"stats",{"_94":81,"_95":81},"ratingAvg","reviewCount","X_OUTSCRAPER_API_KEY","topics",[107,108,109,110,111,112,113,114,115,19,116,117],"license","MIT","language","TypeScript","registryName","io.github.outscraper/outscraper-mcp-server","homepage","https://outscraper.com","ai-agents","ai-scraper","business-data","company-enrichment","contact-enrichment","google-maps-scraper","lead-generation","mcp","model-context-protocol","reviews","web-scraping","ENV",{"_120":121,"_122":123,"_124":125},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

Outscraper MCP Server