Tomba MCP Server: Email Finder Inside Claude and Cursor
How the Tomba MCP server lets Claude, Cursor and other AI clients find and verify business emails, how to connect it, and what it costs.

The Tomba MCP server lets an AI assistant look up and verify business emails for you, without a copy-and-paste trip between tabs. You ask a question in plain language, the assistant calls Tomba, and you get the result in the chat. This guide shows what the server does, how to connect it, and where it fits in a prospecting workflow.
What is the Tomba MCP server?#
MCP (Model Context Protocol) is an open standard that lets AI clients call outside tools. The Tomba MCP server connects clients such as Claude, Cursor, VS Code and ChatGPT to Tomba's email finder and enrichment data. It runs remotely at https://mcp.tomba.io/mcp, so nothing is installed on your machine. Each tool call makes a request to the Tomba API.
If you want the background on how assistants are used in sales, read our guide to Claude for sales.
What can the assistant do with it?#
Tomba lists 28 tools, grouped like this:
| Group | Tools | Typical use |
|---|---|---|
| Find (5) | domain_search, email_finder, author_finder, linkedin_finder, phone_finder | Get contacts for a company or person |
| Verify (3) | email_verifier, phone_validator, domain_status | Check an address or number before you send or call |
| Enrich (4) | email_enrichment, person_enrichment, company_enrichment, combined_enrichment | Fill in missing fields on a lead |
| Company (8) | companies_search, similar_finder, technology_finder, email_count, email_format, email_sources, location, autocomplete | Research accounts |
| Leads (2) | list_leads, create_lead | Read and save leads |
| Account (6) | account_info, usage_info, list_keys, get_logs, list_flags, create_flag | Check credits and activity |
The server also ships 3 resources and 12 built-in prompts, according to the product page.
How do you connect the Tomba MCP server?#
Add the server URL to your client's MCP configuration. For Claude Code, the product page gives this pattern:
claude mcp add --transport http tomba https://mcp.tomba.io/mcp
claude mcp login tomba
You then sign in through your browser and approve access, so you never handle keys. OAuth works for every tool except usage_info and get_logs. Two other options cover all tools:
- API key as a bearer token: send your key and secret, separated by a colon and base64-encoded, in an Authorization header.
- API key headers: send
X-Tomba-KeyandX-Tomba-Secret.
Create keys in your Tomba dashboard, and keep them out of shared config files.
What does it cost?#
The MCP server has no extra charge. Tool calls are billed like the underlying API request, against your plan's credits:
- An email finder call costs 1 search credit when it returns an address.
- A verification costs 1 verification credit.
- Domain search costs 1 search credit per 10 results requested.
- Account and lead tools cost nothing.
Calls also count toward your plan's API rate limits. The Free plan allows 1 request per second, and the page says Pro Plus, Scale and Enterprise have no per-second limit. See Tomba pricing for current plans.
Example prompts for prospecting#
Once connected, you can ask for things in plain language:
- "Find the email for the head of sales at example.com, then verify it."
- "Show how many emails Tomba has for example.com and which format the company uses."
- "Find companies similar to example.com and list their email formats."
- "Validate this phone number before I add it to the call list."
Check each result before you act on it. The assistant reports what Tomba returned, and verification tells you whether an address is deliverable, not whether the person wants your message. For the bigger picture, see our notes on email verification and finding emails by domain.
MCP, API or bulk upload: which should you use?#
The three routes reach the same data, so the choice is about the job:
- MCP server: best for ad hoc research and small batches, where you want to describe the task in words and read the answer in a chat.
- API: best when your own code or CRM sync needs a repeatable, scheduled call. See the Tomba API docs.
- Bulk tasks: best for a spreadsheet of hundreds or thousands of rows. Use bulk email finder and verifier so one run covers the whole file.
A common pattern is to explore with MCP, then move the prompt that works into the API or a bulk job.
Troubleshooting common problems#
If the assistant cannot see the tools, check three things in order. First, confirm the URL in your client config is exactly https://mcp.tomba.io/mcp. Second, repeat the sign-in step, because an expired OAuth session stops every call. Third, if you use an API key, confirm both the key and the secret are present, since sending only one fails.
If calls return errors on the Free plan, you may be hitting the 1 request per second limit. Ask the assistant to run lookups one at a time. If a lookup returns nothing, that is a valid answer: Tomba only charges an email finder search credit when it returns an address.
Tips for safe use#
- Start with one lead to see how many credits a prompt spends.
- Ask the assistant to verify before it saves a lead with
create_lead. - Use a separate API key per client so you can revoke one without breaking the rest.
- Review GDPR and local outreach rules before you contact people you found this way.
Frequently asked questions#
Do I need to install anything?#
No. The server is hosted at https://mcp.tomba.io/mcp. You add the URL to your client and sign in.
Does the MCP server cost extra?#
No. Tool calls use the credits of your Tomba plan, the same as the API.
Which clients work with it?#
The product page names Claude, Cursor, VS Code and ChatGPT, and lists Claude Desktop and Claude Code for OAuth sign-in.
Is it limited by a rate limit?#
The MCP server has no limit of its own. Your plan's API rate limits apply to the calls it makes.
Try it yourself#
Create a free account, then connect the server and run your first lookup with the Tomba Email Finder.
// start free
See who Tomba finds at any company
Type a company's domain to see its people, their roles and verified work emails, each with the pages it was found on. Free account, no card.
Free plan · No credit card required · GDPR & CCPA
// about the author