# Tomba — how to use (mcp.ai)

Connect your Tomba account and use 10 tools for sales and CRM straight from your AI agent. Connect with your own API key. Tomba is an Email Finder for B2B sales and email marketing.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_tomba?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `tomba_attributes_list`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/tomba`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/tomba/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/tomba/attributes/list` — Retrieves all custom lead attributes defined in your Tomba account. Use this action to discover the available attributes that can be used when creating or updating leads. Returns attribute metadata in
- `POST https://api.mcp.ai/api/tomba/domain/status` — Tool to check if a domain is webmail or disposable. Use when validating email deliverability constraints.
  - body: { domain: string }
- `POST https://api.mcp.ai/api/tomba/keys/delete` — Tool to delete an API key by its numeric ID. Use when you need to permanently revoke an API key before its expiration. Note: You can get the numeric key ID from the TOMBA_KEYS_LIST action.
  - body: { key_id: string }
- `POST https://api.mcp.ai/api/tomba/keys/list` — Tool to list all API keys. Use when you want to retrieve information about your existing Tomba API keys.
- `POST https://api.mcp.ai/api/tomba/leads/create` — Create a new lead in Tomba's lead database. Use this to store contact information for a person you want to track. Returns the unique ID of the created lead. Required fields: first_name, email. All oth
  - body: { city?: string, tags?: string[], email: string, phone?: string, state?: string, company?: string, country?: string, twitter?: string, website?: string, linkedin?: string, position?: string, last_name?: string, first_name: string }
- `POST https://api.mcp.ai/api/tomba/leads/list` — Tool to list all leads. Use when you need to retrieve and paginate your leads list.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/tomba/lists/delete` — Tool to delete a leads list by ID. Use when you need to permanently remove a list after confirming its ID.
  - body: { id: string }
- `POST https://api.mcp.ai/api/tomba/lists/list` — Tool to list all lead lists. Use when you need to retrieve and paginate your lead lists.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/tomba/lists/update` — Tool to update a leads list's name by ID. Use when renaming an existing list after obtaining its ID.
  - body: { id: string, name: string }
- `POST https://api.mcp.ai/api/tomba/usage/stats` — Tool to get API usage statistics. Use when you need to monitor account usage and avoid hitting limits.

## Example prompts
- "What can I do in Tomba?"
- "Show me a summary of my Tomba account"

## More
- Page: https://mcp.ai/tomba
- Agent spec (llms.txt): https://mcp.ai/tomba/llms.txt
- Postman collection: https://mcp.ai/tomba/postman.json