Skip to main content

How to use the Tomba remote MCP server

Connect an AI assistant such as Claude or ChatGPT to Tomba, with nothing to install.

Written by Tomba.io Team

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.

The MCP group on the Integrations page, with the Local MCP Server, Remote MCP Server and Composio card titles outlined

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.

The Connected Apps page with arrows on Connected Apps in the side menu and on the Revoke button of the first app

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

Did this answer your question?