Connect an AI assistant, such as Claude or ChatGPT, to Tomba so you can ask it to find and verify emails. There's nothing to install. Most assistants just ask you to sign in to Tomba.
The remote MCP server is hosted by Tomba. MCP is a standard way for AI assistants to use other tools.
Before you start
You need a Tomba account and an assistant that supports remote MCP servers. This table shows where each one keeps the setting, and how it connects.
Assistant | Where to add Tomba | How you connect |
Claude Desktop | Customize > Connectors | Sign in |
ChatGPT on the web | A Developer mode app | Sign in |
Claude Code, VS Code, Gemini CLI, Windsurf, Zed | Its MCP settings | Sign in, or API key and secret |
Cursor, Cline | Its MCP settings | API key and secret |
Connect your assistant
Step 1. Open Integrations and find the MCP group. On the Remote MCP Server card, select Connect to open the setup guide.
Step 2. In your assistant, add a new server with this address: https://mcp.tomba.io/mcp. For help with this step, see Use Tomba in Claude Desktop or Use Tomba in ChatGPT.
Step 3. Sign in to Tomba in the window that opens, and approve access.
If your assistant can't sign in, add your API key and secret instead. Use the setting X-Tomba-Key for your key and X-Tomba-Secret for your secret. See How to find my API key?.
Step 4. Ask your assistant to run the list_flags tool. A list, even an empty one, means the connection works.
What your assistant can do
Your assistant gets 28 Tomba tools. The main ones are:
Find emails: Domain Search, Email Finder, Author Finder and LinkedIn Finder
Check emails: Email Verifier
Add details: enrichment for people and companies
Find phones: Phone Finder and Phone Validator
Research companies: company search, similar companies and the technology a website uses
Manage contacts: list your leads and add new ones
💳 Credits: Most searches your assistant runs use credits, the same as in the app. Listing your leads or flags is free.
Remove an assistant's access
If you signed in, open Connected Apps under Settings > Connected Apps. Select Revoke next to the assistant.
If you connected with an API key, use Reset Key on API Keys instead.
For developers: see the remote MCP server docs.
Common questions
Can my assistant change anything in my account?
Only two tools change your data: one adds a lead and one creates a data flag, which is a report of wrong data. All the others only read. ChatGPT asks you to confirm those two before it runs them.
Why do the usage and logs tools fail?
Those two tools don't work when you sign in. To use them, connect with your API key and secret.
Are there limits?
Yes. On most plans, tool use counts toward limits per second, per minute and per day. If you hit one, Tomba tries again twice, then your assistant shows an error.
Should I use the local server instead?
Only if you want to run it on your own computer. See How to set up the Tomba local MCP server.
Related articles


