# Skrapp MCP (server v1.5.0)

Bring Skrapp into Claude, ChatGPT, Cursor and any MCP client: verified emails, phone numbers, company search and enrichment in plain language.

Server URL: `https://mcp.skrapp.io/`

## Connect a client

Add Skrapp as a custom connector: paste the server URL `https://mcp.skrapp.io/` and sign in with your Skrapp account (OAuth). No API key is needed for chat assistants.

### Claude

[Claude.ai](https://claude.ai) on the web, or the Claude desktop app. Paid plans.

1. Open [Settings](https://claude.ai/settings), then [Customize](https://claude.ai/new#customize/connectors). The **Connectors** tab is selected.
2. Click **+ Add** at the top right, then [Add custom connector](https://claude.ai/new?modal=add-custom-connector#customize/connectors) (not one of the listed connectors).
3. Name it **Skrapp**, paste `https://mcp.skrapp.io/` as the MCP server URL, and click **Continue**.
4. **Authentication** shows **Sign in now**; keep it and click **Add**. A Skrapp page opens; sign in and click **Allow**. Skrapp now appears in the tools menu of every chat.

### ChatGPT

[ChatGPT.com](https://chatgpt.com) or the desktop app.

1. Open [Plugins](https://chatgpt.com/plugins) in the left sidebar, then click **Add** at the top right and choose **Add custom MCP server**.
2. Name it **Skrapp**, keep **Server URL** as the connection and paste `https://mcp.skrapp.io/`.
3. Leave **Authentication** on **OAuth**, tick **I understand and want to continue**, and click **Add**.
4. ChatGPT sends you to Skrapp to sign in and approve. Skrapp is then available from the **+** menu of a chat.

### Perplexity

[Perplexity.ai](https://www.perplexity.ai) or the desktop app.

1. Open [Settings → Connectors](https://www.perplexity.ai/account/connectors), and click **Add custom**.
2. Choose **Connector**, then **Add MCP connector**, and select **Remote**.
3. Name it **Skrapp**, paste `https://mcp.skrapp.io/` as the MCP server URL, keep **OAuth** as the authentication, tick the acknowledgement and click **Add**.
4. Click the new Skrapp card, sign in to Skrapp and click **Allow**. Skrapp is then available in your threads.

### Grok

[Grok.com](https://grok.com), or the Grok app on iOS and Android. All plans.

1. Open [Connectors](https://grok.com/connectors) (on the web: click **+** in a chat, then **Connectors**; in the app: **Settings**, then **Connectors**).
2. Click **New Connector**, then **Custom**.
3. Paste `https://mcp.skrapp.io/` as the MCP server URL and continue.
4. Grok sends you to Skrapp to sign in and click **Allow**. Skrapp is then available in your chats.

### Mistral

[Chat.mistral.ai](https://chat.mistral.ai) (Le Chat, now Vibe). On Free, Pro and Student plans the account owner can add connectors; on team plans ask your admin.

1. Open **Connectors** from the sidebar and click **+ Add Connector**.
2. Switch to the **Custom MCP Connector** tab.
3. Enter **Skrapp** as the connector name, paste `https://mcp.skrapp.io/` as the server URL, and click **Connect**.
4. Sign in to Skrapp when asked and click **Allow**. Enable Skrapp in a chat from the tools menu.

### Microsoft Copilot

Microsoft 365 Copilot, through [Copilot Studio](https://copilotstudio.microsoft.com). Needs a Copilot Studio license or trial; the Copilot app alone cannot add custom servers.

1. In Copilot Studio, open your agent, then **Tools**, then **Add a tool**, then **New tool**.
2. Under **Create new**, choose **Model Context Protocol**.
3. Enter **Skrapp** as the server name and a short description, paste `https://mcp.skrapp.io/` as the server URL, and set **Authentication** to **OAuth 2.0** with **Dynamic discovery**.
4. Click **Create**, then **Add to agent**, and sign in to Skrapp when the connection is created.

## Code tools

Claude Code, Cursor, VS Code and Codex connect with one line and sign you in themselves. Scripts and in-house agents use an API key from https://app.skrapp.io/integrations.

### Claude Code

Run the command, or drop `.mcp.json` at your project root; Claude Code asks for approval when it opens the folder.

Download .mcp.json: https://skrapp.io/mcp/skrapp.mcp.json

```bash
claude mcp add --transport http skrapp https://mcp.skrapp.io/
# then, inside Claude Code:
/mcp   # pick "skrapp" and sign in
```

### Cursor

Click the button, or add the config to `.cursor/mcp.json`. Cursor asks you to sign in as soon as it loads the server.

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=skrapp&config=eyJ1cmwiOiJodHRwczovL21jcC5za3JhcHAuaW8vIn0=)

```json
{
  "mcpServers": {
    "skrapp": { "url": "https://mcp.skrapp.io/" }
  }
}
```

### VS Code

VS Code asks you to sign in as soon as it starts the server.

[Add to VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=skrapp&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.skrapp.io%2F%22%7D)

```json
{
  "servers": {
    "skrapp": { "type": "http", "url": "https://mcp.skrapp.io/" }
  }
}
```

### Codex

Codex signs you in with `codex mcp login` after the server is added.

Download config.toml: https://skrapp.io/mcp/codex-config.toml

```toml
[mcp_servers.skrapp]
url = "https://mcp.skrapp.io/"
```

### Your own agent or a script

Send your API key as a bearer token with each request.

```bash
curl -X POST https://mcp.skrapp.io/ \
  -H "X-Access-Key: $SKRAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## What you can ask for

- **Search for leads and companies**: Filter by title, location, industry, size, revenue, funding and more, then page through the results. Cost: Free. Searches count toward your plan’s daily limit; some company filters need a paid plan.

- **Research a company**: Start with a free snapshot: size, industry, HQ and website. Go deeper on request: headcount trends, funding, financials, hiring, tech stack, competitors and signals. Cost: Snapshot free. Deep data costs 1–5 credits per topic, charged once per company; asking again is free.

- **Find someone’s email**: Give a name and a company to get their verified work email, plus the email pattern that company uses. Works for one person or a whole list. Cost: 1 credit per email found. Free if none is found.

- **Find a phone number**: Start from a LinkedIn profile, or a name plus a company or country. You get mobile, direct and company numbers, each with a confidence level. Cost: 5 credits for a personal number, 1 for company numbers only, free if nothing is found.

- **Verify emails**: Check one address or a batch before a campaign. Each comes back as valid, invalid, catch-all or unknown. Cost: 1 credit per email.

- **Save to lists**: Create lists, add the people you found, read them back, and rename or delete lists, all from the chat. Cost: Free, unless Skrapp has to find an email for someone you add.

## Safety

- **It asks before it spends**: Anything that costs more than a single credit, and anything that deletes, comes back as a quote first: the exact price and your current balance. Nothing happens until you say yes.

- **A refusal is never charged**: Not enough credits, a daily limit, an expired trial, a person that does not exist: the assistant is told plainly, with the time to wait if there is one, and nothing is deducted.

- **Speed limits built in**: An assistant stuck in a loop is slowed down after a few hundred calls a minute instead of draining your balance.

- **You stay in control**: You sign in with your Skrapp account; there is no key to copy for Claude, ChatGPT or Perplexity. Disconnect the connector or revoke access from your account at any time.

## Tools

| Tool | Cost | Notes |
| --- | --- | --- |
| **Free** | | |
| [get_account](https://skrapp.io/api#account) | Free | Your plan, credit balance and a cost summary. Call it first. |
| [get_company](https://skrapp.io/api#company-snapshot) | Free | Company snapshot (size, industry, HQ, website) by domain, name or id. Use it to resolve a company before enriching it. |
| search_leads | Free | Find people by title, company, location and more. Each new filter set uses one of the account’s daily searches; paging the same search is free. No REST equivalent. |
| [search_companies](https://skrapp.io/api#company-search) | Free | Find companies with the same filters as the Companies Search API: keywords, industry, size, location, revenue, funding, technologies, signals and more. Rate limited per minute and per day; every page counts. Premium filters need a paid plan. |
| [find_lists](https://skrapp.io/api#list-lists) | Free | Your lists, with id and size. |
| [get_list](https://skrapp.io/api#get-list) | Free | One list by id. |
| [get_list_leads](https://skrapp.io/api#list-leads) | Free | The leads saved in a list, paged. |
| [rename_list](https://skrapp.io/api#rename-list) | Free | Give a list a new name. |
| ping | Free | Connectivity check; no data. |
| **Credits** | | |
| [find_email](https://skrapp.io/api#email-finder) | 1 per email found | Verified work email for a name and company. Not found is free; the same email again is free. Optional `linkedinUrl`, `companyId`, `country`, `includeCompanyData`. |
| [find_email_bulk](https://skrapp.io/api#bulk-email-finder) | 1 per email found | Same as `find_email` for up to 250 people in one call. |
| [email_verifier_verify](https://skrapp.io/api#email-verifier) | 1 per email | Check whether an address is deliverable: valid, invalid, catch-all or unknown. |
| [email_verifier_verify_bulk](https://skrapp.io/api#bulk-email-verifier) | 1 per email | Same as `email_verifier_verify` for up to 250 emails. |
| [lookup_phone](https://skrapp.io/api#people-phone) | 5 per person phone found | Mobile, direct and company numbers for one person, from a LinkedIn URL or a name plus company or country. 1 when only company numbers are found, 0 when nothing is found. |
| [lookup_phones](https://skrapp.io/api#people-phone-bulk) | 5 per person phone found | Same as `lookup_phone` for up to 50 people. |
| [enrich_company](https://skrapp.io/api#company-enrich) | 1–5 per category | Deep company data by category, charged once per company and category for the account; asking again is free. 12 categories: firmographics 1, headcount 3, financials 3, hiring 3, funding 2, technographics 2, acquisitions 2, competitors 1, social 1, traffic 1, contacts 1, signals 5. |
| [enrich_companies](https://skrapp.io/api#company-bulk-enrich) | 1–5 per category | Same as `enrich_company` for up to 20 companies, all or nothing. |
| **Writes** | | |
| [create_list](https://skrapp.io/api#create-list) | Free | Create an empty list, or one with leads. |
| [add_leads_to_list](https://skrapp.io/api#load-leads) | Credits only for leads saved without an email | Save people to a list. A lead passed with its email and verification status is stored as is; one without an email triggers a finder lookup. |
| [delete_list](https://skrapp.io/api#delete-list) | Free | Delete a list and its leads. Irreversible; always asks for confirmation. |
| [delete_leads](https://skrapp.io/api#delete-leads) | Free | Remove one or more leads from a list by id. Irreversible; always asks for confirmation. |

## Optional ground rules prompt

Paste this at the start of a conversation, or into the assistant’s instructions.

```bash
You have access to the Skrapp MCP server (https://mcp.skrapp.io/). Use it to find and verify professional emails, look up phone numbers, search and enrich companies, and manage Skrapp lists.

Rules:
- Call get_account first and keep an estimate of remaining credits. Never start a task whose estimated cost exceeds the available credits; tell me instead.
- Credits are consumed by: find_email (1 per email found), lookup_phone (5 per person), email_verifier_verify (1 per email), enrich_company (1 to 5 per category, once per company). Searching companies and leads, reading lists and company snapshots are free. You can never know the exact amount in advance: what is found, and what was already paid for, decides the real charge, so treat every figure as an estimate from these rates.
- Before any call estimated to spend more than 100 credits, or that deletes anything, show me the estimated cost and ask for confirmation. When a tool returns status "confirmation_required", stop and ask me, then call it again with confirm=true and the same confirmationToken.
- Prefer a company domain over a company name, and a LinkedIn URL over a name for phone lookups. Keep every id as a string. When saving leads found with find_email, pass email and verificationStatus through unchanged.
- When a tool reports "already_queued", a rate limit, or insufficient credits, do not retry; report it to me with the retry time if one is given.
- Summarise results as a table: name, title, company, email, status, estimated credits used.
```

## FAQ

### Does it cost extra?

No. Your assistant spends the same Skrapp credits as the app, at the same prices. Looking up companies, searching and reading your lists are free.

### Which Skrapp plans can use it?

Any plan, including the free one. Free plan limits on daily searches and credits apply here as they do in the app.

### Which assistant plans support custom connectors?

Claude on its paid plans, ChatGPT on Plus, Pro, Business and Enterprise, and Perplexity on Pro, Max and Enterprise. Free tiers of those assistants do not offer custom connectors yet.

### When do I sign in?

Right when you add the connector. Skrapp asks for sign-in on the very first request, so your assistant shows “Sign in now” and opens the Skrapp page before any tool is available. You approve once; the connection renews itself from then on.

### Do I need an API key?

Not for Claude, ChatGPT or Perplexity: you sign in with your Skrapp account and approve once. An API key is only for scripts and in-house agents, and lives on [your integrations page](https://app.skrapp.io/integrations).

### Can my assistant spend credits without asking?

Only one credit at a time, for a single email find or verification. Anything larger, and anything that deletes, is quoted first and waits for a yes.

### How do I disconnect?

Remove the Skrapp connector in your assistant’s settings, or revoke the access from your Skrapp account. Access tokens expire within an hour on their own.

More: https://skrapp.io/mcp (this page) and https://skrapp.io/api#mcp (tool reference).