Outscraper MCP Server logo

Outscraper MCP Server

Connect MCP-compatible agents to Outscraper for business discovery, Maps data, enrichment, reviews, search, and structured extraction.

Install Outscraper MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "outscraper-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "outscraper-mcp"
      ],
      "env": {
        "OUTSCRAPER_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y outscraper-mcp

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 7d ago.

Overview

Outscraper MCP Server MCP server exposes Outscraper’s business discovery, Google Maps, enrichment, review, search, and structured extraction APIs as MCP tools. It forwards client requests using an Outscraper API key and returns results in a normalized structured envelope, with metadata for asynchronous jobs. Use it for prospecting, place and reputation research, company or contact enrichment, and single-page data extraction rather than browser automation or persistent crawling.

Use cases

  • Find local businesses for prospecting
  • Analyze Google Maps reviews and photos
  • Enrich companies and validate contact data
  • Poll asynchronous Outscraper requests
  • Extract structured data from a web page

Key features

  • Business discovery and record enrichment
  • Google Maps places, reviews, photos, and chain detection
  • Company, email, phone, and contact enrichment
  • Search across Google and supported marketplaces
  • Structured single-page extraction
  • Synchronous and asynchronous request handling

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · outscraper-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
npm downloads443Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Outscraper MCP Server works

What Outscraper MCP Server MCP server does

Outscraper MCP Server MCP server connects MCP-compatible clients to Outscraper’s API. Its tools cover business discovery, company and contact enrichment, Google Maps places, reviews and photos, chain detection, search providers, review platforms, phone enrichment, and structured extraction from a single page.

The tool set includes businesses_search and businesses_get for finding and enriching business records. Google Maps workflows use tools such as google_maps_search, google_maps_reviews, google_maps_photos, and chain_info. Other sources include Yellow Pages, Booking, Yelp, Tripadvisor, Trustpilot, Indeed, Google Search, and Google Images.

Company-focused operations include company_insights, emails_and_contacts, emails_validator, and phones_enricher. ai_scraper extracts structured information from one page. balance_get checks the Outscraper account balance, while requests_get, requests_list, and requests_delete manage asynchronous request lifecycles.

How it works

An MCP client calls a tool exposed by the local or hosted server. The server authenticates with Outscraper, forwards the request to the corresponding API endpoint, and returns a common result structure containing data and meta fields. Asynchronous responses can also include a request ID, status, results location, and a suggested next action.

Async-capable tools accept execution_mode values of auto, sync, or async. The older boolean async option remains accepted, but execution_mode takes precedence. A typical workflow can search for businesses, enrich a selected record, submit a longer-running collection task, and then poll its status with requests_get.

The server supports local stdio communication and HTTP deployment. Hosted HTTP mode can authenticate with request headers or, for connector-style deployments, an API key in the /v1/mcp/<api-key> path. Stateful HTTP/SSE sessions are stored in process memory, so a single instance or sticky-session arrangement is more suitable than unrestricted horizontal scaling.

Setup and configuration

Install and run the package through npm:

bash
set OUTSCRAPER_API_KEY=YOUR_API_KEY
npx -y outscraper-mcp

For a local MCP client, configure npx as the command, pass -y and outscraper-mcp as arguments, and provide OUTSCRAPER_API_KEY in the client environment. The process also loads .env at startup. On Windows, clients that cannot resolve npx may need the full path to npx.cmd.

For Streamable HTTP, set HTTP_STREAMABLE_SERVER=true and configure HOST and PORT; the MCP endpoint is /mcp. Hosted authentication requires CLOUD_SERVICE=true. HTTP callers can send Authorization: Bearer, X-API-KEY, or X-OUTSCRAPER-API-KEY.

Tools and capabilities

  • Discover and enrich businesses with businesses_search and businesses_get.
  • Retrieve Google Maps places, photos, reviews, and chain information.
  • Enrich company domains, find contacts and emails, validate email addresses, and enrich phone data.
  • Search Google, Google Images, Yellow Pages, Booking, Tripadvisor, Indeed, and other supported services.
  • Analyze reviews from Yelp and Trustpilot, including legacy Trustpilot aliases.
  • Extract structured data from a single page with ai_scraper.
  • Check balances and list, poll, or delete Outscraper requests.

Limitations and notes

Outscraper MCP Server MCP server is not intended for browser automation, multi-step user-interface interaction, generic OAuth SaaS connections, arbitrary document search, or crawling sessions that depend on a persistent browser. The available data surface is defined by Outscraper’s supported endpoints.

API usage requires an Outscraper API key. URL-based hosted authentication is convenient for clients that cannot send custom headers, but header authentication is preferable for server-to-server use. Stateful HTTP sessions reside in process memory, which affects deployment choices when running multiple instances.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Outscraper MCP Server

Outscraper MCP Server is an MCP server that connects AI agents to the Outscraper API. Its main tools support business discovery, Google Maps places, reviews and photos, company and contact enrichment, web search, and structured extraction from a single page, with request polling for asynchronous jobs.

Install it by running `npx -y outscraper-mcp` after setting `OUTSCRAPER_API_KEY`. MCP clients should use `npx` as the command, pass `-y` and `outscraper-mcp` as arguments, and provide the API key through the client environment.

Yes, it supports Cursor through the local stdio connection mode. Configure Cursor to launch `npx -y outscraper-mcp` and provide `OUTSCRAPER_API_KEY` in the environment.

Run it with `HTTP_STREAMABLE_SERVER=true`, plus `HOST` and `PORT`, to expose the `/mcp` endpoint. Set `CLOUD_SERVICE=true` for hosted authentication, then use supported API-key headers or the `/v1/mcp/<api-key>` URL route.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOutscraper MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/outscraper-mcp-server?style=directory)](https://allmcps.com/mcp/outscraper-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/outscraper-mcp-server"><img src="https://allmcps.com/api/badge/outscraper-mcp-server?style=directory" alt="Outscraper MCP Server on AllMCPs" /></a>