# Evascrape MCP server

> Extract business leads and email addresses from Google Maps, Apollo.io, and LinkedIn directly within an AI client.

- Repository: https://github.com/evascrape/evascrape-mcp
- Page: https://hostedmcp.org/servers/evascrape/evascrape-mcp
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 1.0.0

## Install

### Claude Code

```sh
claude mcp add --env 'EVASCRAPE_API_KEY=<YOUR_EVASCRAPE_API_KEY>' evascrape-mcp -- npx -y @evascrape/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "evascrape-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@evascrape/mcp"
      ],
      "env": {
        "EVASCRAPE_API_KEY": "<YOUR_EVASCRAPE_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "evascrape-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@evascrape/mcp"
      ],
      "env": {
        "EVASCRAPE_API_KEY": "<YOUR_EVASCRAPE_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"evascrape-mcp","type":"stdio","command":"npx","args":["-y","@evascrape/mcp"],"env":{"EVASCRAPE_API_KEY":"<YOUR_EVASCRAPE_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "evascrape-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@evascrape/mcp"
      ],
      "env": {
        "EVASCRAPE_API_KEY": "<YOUR_EVASCRAPE_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add evascrape-mcp --env 'EVASCRAPE_API_KEY=<YOUR_EVASCRAPE_API_KEY>' -- npx -y @evascrape/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.evascrape-mcp]
command = "npx"
args = ["-y", "@evascrape/mcp"]

[mcp_servers.evascrape-mcp.env]
EVASCRAPE_API_KEY = "<YOUR_EVASCRAPE_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'EVASCRAPE_API_KEY=<YOUR_EVASCRAPE_API_KEY>' evascrape-mcp npx -- -y @evascrape/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "evascrape-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@evascrape/mcp"
      ],
      "env": {
        "EVASCRAPE_API_KEY": "<YOUR_EVASCRAPE_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `EVASCRAPE_API_KEY` | yes | yes | API key from https://app.evascrape.com/account/api-keys |
| `EVASCRAPE_BASE_URL` | no | no | Override the API host (https only). Defaults to https://app.evascrape.com |

## Tools (7)

- `google_maps_leads`: Find local businesses and their contact details from Google Maps: name, address, phone, website, rating, and the email address published on the business website where there is one. Use this for requests like "find 200 dentists in Austin with their emails", "get me restaurants in Berlin with phone numbers" or "build a list of plumbers near Manchester". This is the best starting point for local business prospecting. Costs $12 per 1,000 records from a prepaid balance; you are refunded for anything not delivered. Returns a job id, not the data: poll job_status, then call download.
- `apollo_export`: Export the results of a people search you already built on Apollo.io, past Apollo's own export cap and without consuming Apollo export credits. You must supply the Apollo search URL. Only leads that have a verified email address are delivered, so the count can be lower than the number Apollo displays. Costs $9 per 1,000. Returns a job id: poll job_status, then download.
- `linkedin_leads`: Build a list of people from LinkedIn and Sales Navigator audiences using filters, and get their verified work email addresses. This takes filters, not a LinkedIn URL: job titles, locations, company domains, keywords, industry, company size and revenue range. Use it for requests like "CMOs at SaaS companies in California" or "heads of engineering at companies using Stripe". Costs $9 per 1,000. If you get far fewer results than requested, set include_unverified to true: that single filter is the most common reason a list comes back short. Returns a job id: poll job_status, then download.
- `job_status`: Check whether an Evascrape job has finished. Call this about 30 seconds after starting a job and then every 20 to 30 seconds. When the status is "succeeded", call download to read the records. (read-only)
- `download`: Read the records of a finished Evascrape job as structured data. Returns the field names and the rows, paged. Ask for a job that has already reached the status "succeeded". With email verification enabled you can pick a variant: "good" for deliverable addresses only, "risk" for catch-all, "bad" for undeliverable. Default "all". (read-only)
- `check_balance`: Show how much prepaid credit is left on the Evascrape account, in USD. Check this before starting a large job. (read-only)
- `estimate_cost`: Return what a job would cost without starting it or charging anything. Use this before spending on behalf of someone, or when the user asks how much a list will cost. (read-only)

## FAQ

### Does Evascrape require a subscription?

No, Evascrape uses a prepaid credit system with no monthly subscription required, and credits do not expire.

### Can I see the cost of a lead extraction before running it?

Yes, you can use the `estimate_cost` tool to price a job before it starts.

### How are the extractions processed?

Extractions are asynchronous; a tool call starts a job and returns an ID, which you can track using `job_status` and retrieve via `download` once finished.
