> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.anymailfinder.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Use Anymail Finder from Claude, ChatGPT, Cursor and other AI assistants (MCP)

Connect your account once, then ask your assistant to find and verify email addresses in plain language. No API key to copy, no code to write.

*The assistants below change their menus often. If a step doesn't match what you see, the server URL is all you need.*

|| The server URL, for any assistant, is `https://api.anymailfinder.com/mcp` and that is the only setting most assistants need.

## What this does

MCP (Model Context Protocol) is an open standard that lets an AI assistant use an outside service on your behalf. Connecting Anymail Finder over MCP means your assistant can search for and verify email addresses directly, using your credits, without you leaving the conversation.

You are not giving the assistant your password, and on assistants that support signing in you are not giving it your API key either. You approve the connection on our site, and you can withdraw it at any time.

## What you can ask for

Once connected, your assistant can do five things. You don't need to name them — ask in plain language and it will pick the right one.

| You ask | What happens |
| --- | --- |
| "Find Jane Doe's email at `example.com`" | Searches for that specific person at that company. A LinkedIn URL works instead of a name. |
| "Who runs marketing at `example.com`, and what's their email?" | Finds a decision maker in a department when you don't know who you're looking for. |
| "What email addresses exist at `example.com`?" | Lists known addresses at a company, generic and personal. |
| "Is `jane@example.com` deliverable?" | Verifies an address you already have, including on catch-all domains. |
| "How many credits do I have left?" | Reads your balance. Free. |

Every address returned by a search is already verified in real time. There is no need to ask your assistant to verify a result it just found, and doing so costs credits for no new information.

| Because your assistant can chain steps, the useful requests are the compound ones: *"Find the heads of engineering at these twelve companies and tell me which ones you couldn't."*

## Claude desktop and web

This is the simplest route. You sign in to Anymail Finder in your browser and approve the connection — there is no API key involved.

1. In Claude, open **Settings** then **Connectors**.
2. Choose **Add custom connector**.
3. Name it **Anymail Finder**, then enter this URL: `https://api.anymailfinder.com/mcp`
4. Ignore **Advanced settings**. The OAuth Client ID and Secret are optional and you do not need them — signing in is what connects your account.
5. Click **Add**, then **Connect**. A browser window opens on our site.
6. Sign in if you aren't already, choose the workspace to connect, and click **Allow**.

![The only two fields that matter are the name and the URL. Leave the OAuth boxes under Advanced settings alone.](https://storage.crisp.chat/users/helpdesk/website/-/2/d/5/e/2d5efafd2ec2d600/screenshot-2026-08-17-alle-102_zr0jo1.png "=560xauto")

You'll be returned to Claude with the connection active. Ask it to check your credit balance to confirm.

## Claude Code

Add the server, then authenticate from inside a session.

```bash
claude mcp add anymailfinder https://api.anymailfinder.com/mcp -t http
```

1. Run the command above.
2. Run `/mcp`. If the server isn't listed yet, restart Claude Code and try again.
3. Select **anymailfinder** and choose to authenticate.
4. Approve the connection in the browser window that opens.

### Using an API key instead

If you'd rather not sign in — for a shared machine or a CI environment — you can pass an API key from **Settings, API** as a header:

```bash
claude mcp add anymailfinder https://api.anymailfinder.com/mcp -t http \
  -H "Authorization: Bearer YOUR_API_KEY"
```

An API key gives access to your whole account API, not just this connection, and revoking it breaks anything else using it. Signing in is the better choice when it's available.

## Cursor

Open **Settings**, then **MCP**, and add a server with the URL `https://api.anymailfinder.com/mcp` over HTTP transport. Cursor will prompt you to sign in the first time it connects.

Cursor stores this in `mcp.json`, so you can also add it by editing that file directly — useful if you want the same setup on more than one machine. Restart Cursor after editing.

## ChatGPT

ChatGPT supports custom MCP connectors, though availability depends on your plan and the option may need turning on first. Add a connector using the server URL above, and sign in when prompted.

OpenAI has moved this setting more than once, so if you can't find it, check their own documentation for adding a custom connector — the only detail you need from us is the URL.

## Other assistants

Anything that speaks MCP over HTTP can connect. The only detail you need is the server URL:

```
https://api.anymailfinder.com/mcp
```

Clients that support signing in will open a browser and walk you through approval. Clients that don't will need an API key sent as an `Authorization: Bearer` header — the same key you'd use with our REST API, found under **Settings, API**.

This includes Windsurf, LibreChat, Codex CLI and anything else that has added MCP support. Where each one keeps its connector settings changes as those products change, so follow their own documentation for adding a custom MCP server, and give it the URL above.

## What it costs

Connecting is free. You are charged the same as anywhere else in Anymail Finder, and your assistant is told the exact amount of every call so it can tell you.

| Action | Cost | When |
| --- | --- | --- |
| Find a person's email | 1 credit | Only if a verified address is found |
| Find a decision maker | 2 credits | Only if a verified address is found |
| Find a company's emails | 1 credit | Once per search, however many come back, only if at least one is found |
| Verify an address | 0.2 credits | Always, whatever the result |
| Check your balance | Free | — |

**Searches that find nothing are free.** If we can find candidates but cannot confirm they're deliverable, that also counts as finding nothing, and you are not charged. You only pay for an address we're confident in.

Repeating the same search, or verifying the same address, is free for 30 days.

## Which workspace it uses

A connection belongs to one workspace, chosen when you approve it. Credits come from that workspace, and searches appear in its usage history.

If you belong to more than one workspace, you'll see a picker on the approval screen. To use a different one, connect again and choose it — you can have more than one connection at a time.

## Seeing and disconnecting apps

Go to **Settings**, then **Account**. Connected apps are listed under **Connected apps**, with the workspace each one uses and when it was last active.

Click **Disconnect** to revoke access immediately. The app stops working straight away and has to be approved again. Disconnecting one app does not affect any other, and does not touch your API key.

Connections expire on their own after twelve months.

## Troubleshooting

**My assistant says it isn't authorised, or asks me to sign in again.**
The connection was disconnected, expired, or you were removed from the workspace it was using. Reconnect and it will work again.

**A search seems to hang, then fails.**
Most searches take a few seconds, but a difficult one can take up to three minutes. On some mobile and corporate networks the connection is dropped before a slow search finishes. If this keeps happening, try a different network — and note that re-running a search you already paid for is free for 30 days, so a retry costs nothing.

**My assistant offers to verify an address it just found.**
Decline. Search results are already verified. Verifying again costs 0.2 credits and tells you nothing new.

**It found nothing for someone I know exists.**
Give it the company domain rather than the company name — that's the single biggest improvement to accuracy. A LinkedIn URL works well too, and can be used on its own.

**It says I'm out of credits.**
Check the balance in the app under **Billing**. Your assistant can also read it if you ask.

**The connection screen says the app couldn't be connected.**
The app's registration has expired or its settings changed. Remove the connector in your assistant and add it again.

## Security

Worth knowing before you approve anything, here or elsewhere.

* **The app never sees your password.** You sign in on our site, and the app receives only a token limited to that one connection.
* **The name on the approval screen is chosen by the app.** Any app can call itself anything. The address shown underneath — where your approval is being sent — is the part we can confirm. If you don't recognise it, don't continue.
* **A connection can spend your credits.** It can search and verify, and read your plan and balance. It cannot change your password, your billing, or your team.
* **Revoking is instant**, and per app, from **Settings, Account**.

||| Only approve connections you started. If an approval screen appears when you weren't connecting anything, close it. A legitimate request always follows something you just did in your assistant.