Articles on: Integrations and API

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.


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.


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:


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.

Updated on: 17/08/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!