Tomba MCP Server

Official22 toolsLive

by tomba-io · TypeScript

MCP server for Tomba email finder, verification, and contact enrichment API

Tomba Email MCP Server (io.github.tomba-io/tomba-mcp-server)

This Model Context Protocol (MCP) server integrates with the Tomba.io API to support email discovery, verification, and contact enrichment through a standardized MCP interface. The server exposes MCP tools for workflows involving finding email addresses, validating them, and enriching contact data.

🛠️ Key Features

MCP server for Tomba email finder, verification, and contact enrichment API
Provides standardized MCP interface access to Tomba.io API capabilities
22 tools available
Topics: ai, aiagent, aiworkflow, api, email, mcp, mcp-server, mcp-tools, tomba, verification

🚀 Use Cases

Discover email addresses associated with a domain
Find likely email addresses from names and domains
Verify email addresses via Tomba.io capabilities
Enrich contact information through Tomba.io enrichment features

⚡ Developer Benefits

Uses MCP to connect Tomba.io API functionality to agent/workflow tooling
Tooling is categorized around email discovery, verification, and enrichment needs

⚠️ Limitations

Tool listing details in the provided excerpt are truncated (full tool names and counts beyond “22 available” are not fully shown)

Topics

aiaiagentaiworkflowapiemailmcpmcp-servermcp-toolstombaverification

Captured live from the server via tools/list.

author_finder

Find the email address of an article's author from a given URL. Useful for outreach to content creators and journalists.

Parameters2

url	string	required	The URL of the article or blog post
webhook_url	string	optional	Optional webhook URL to receive results asynchronously

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The URL of the article or blog post"
    },
    "webhook_url": {
      "description": "Optional webhook URL to receive results asynchronously",
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

companies_search

Search for companies in the Tomba database. Filter by name, industry, country, and more to find target companies for outreach.

Parameters4

query	string	optional	Search query for company name or keywords (8-100 characters)
filters	object	optional	Filter options with include/exclude arrays for: location_country, location_city, location_state, industry, size, type, keywords, founded, technologies, similar, revenue, sic, naics
page	number	optional	Page number for pagination (1-1000)
webhook_url	string	optional	Optional webhook URL to receive results asynchronously

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search query for company name or keywords (8-100 characters)",
      "type": "string",
      "minLength": 8,
      "maxLength": 100
    },
    "filters": {
      "description": "Filter options with include/exclude arrays for: location_country, location_city, location_state, industry, size, type, keywords, founded, technologies, similar, revenue, sic, naics",
      "type": "object",
      "properties": {
        "location_country": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "location_city": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "location_state": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "industry": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "size": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "type": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "keywords": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "founded": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "technologies": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "similar": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "revenue": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "sic": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "naics": {
          "type": "object",
          "properties": {
            "include": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "exclude": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "page": {
      "description": "Page number for pagination (1-1000)",
      "default": 1,
      "type": "number",
      "minimum": 1,
      "maximum": 1000
    },
    "webhook_url": {
      "description": "Optional webhook URL to receive results asynchronously",
      "type": "string",
      "format": "uri"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

domain_search

Search for all email addresses associated with a specific domain or company. Returns a list of email addresses found for the given company domain along with metadata about each contact.

Parameters8

domain	string	optional	The domain to search for emails (e.g., 'example.com')
company	string	optional	The company name to search for
limit	string	optional	Maximum number of results to return (10, 20, or 50)
page	number	optional	Page number for pagination
department	string	optional	Filter by department (e.g., 'executive', 'it', 'marketing')
country	string	optional	Filter by country code (e.g., 'US', 'GB')
enrich_mobile	boolean	optional	Whether to enrich with mobile phone data
webhook_url	string	optional	Optional webhook URL to receive results asynchronously

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "description": "The domain to search for emails (e.g., 'example.com')",
      "type": "string",
      "pattern": "^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"
    },
    "company": {
      "description": "The company name to search for",
      "type": "string",
      "minLength": 3,
      "maxLength": 75
    },
    "limit": {
      "description": "Maximum number of results to return (10, 20, or 50)",
      "default": "10",
      "type": "string",
      "enum": [
        "10",
        "20",
        "50"
      ]
    },
    "page": {
      "description": "Page number for pagination",
      "type": "number",
      "minimum": 1
    },
    "department": {
      "description": "Filter by department (e.g., 'executive', 'it', 'marketing')",
      "type": "string"
    },
    "country": {
      "description": "Filter by country code (e.g., 'US', 'GB')",
      "type": "string",
      "pattern": "^[A-Z]{2}$"
    },
    "enrich_mobile": {
      "description": "Whether to enrich with mobile phone data",
      "type": "boolean"
    },
    "webhook_url": {
      "description": "Optional webhook URL to receive results asynchronously",
      "type": "string",
      "format": "uri"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

email_count

Get the count of email addresses available for a specific domain. Useful for estimating the potential reach before performing a full domain search.

Parameters1

domain

string

required

The domain to count emails for (e.g., 'example.com')

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$",
      "description": "The domain to count emails for (e.g., 'example.com')"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

email_enrichment

Enrich an email address with additional information about the person, including their name, position, company details, and social profiles.

Parameters1

string

required

The email address to enrich

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The email address to enrich"
    }
  },
  "required": [
    "email"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

email_finder

Find the email address of a specific person given their name and company domain or company name. Uses various techniques to generate and verify the most likely email format.

Parameters7

domain	string	optional	The domain of the company (e.g., 'example.com')
company	string	optional	The company name to search in
full_name	string	optional	The full name of the person (alternative to first_name/last_name)
first_name	string	optional	The first name of the person
last_name	string	optional	The last name of the person
enrich_mobile	boolean	optional	Whether to enrich with mobile phone data
webhook_url	string	optional	Optional webhook URL to receive results asynchronously

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "description": "The domain of the company (e.g., 'example.com')",
      "type": "string",
      "pattern": "^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"
    },
    "company": {
      "description": "The company name to search in",
      "type": "string",
      "minLength": 3,
      "maxLength": 75
    },
    "full_name": {
      "description": "The full name of the person (alternative to first_name/last_name)",
      "type": "string",
      "minLength": 1
    },
    "first_name": {
      "description": "The first name of the person",
      "type": "string",
      "minLength": 1
    },
    "last_name": {
      "description": "The last name of the person",
      "type": "string",
      "minLength": 1
    },
    "enrich_mobile": {
      "description": "Whether to enrich with mobile phone data",
      "type": "boolean"
    },
    "webhook_url": {
      "description": "Optional webhook URL to receive results asynchronously",
      "type": "string",
      "format": "uri"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

email_verifier

Verify if an email address is valid and deliverable. Checks for proper format, domain validity, and mailbox existence without sending an email.

Parameters3

email	string	required	The email address to verify
enrich_mobile	boolean	optional	Whether to enrich with mobile phone data
webhook_url	string	optional	Optional webhook URL to receive results asynchronously

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The email address to verify"
    },
    "enrich_mobile": {
      "description": "Whether to enrich with mobile phone data",
      "type": "boolean"
    },
    "webhook_url": {
      "description": "Optional webhook URL to receive results asynchronously",
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "email"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

linkedin_finder

Find the email address associated with a LinkedIn profile URL. Extracts contact information from LinkedIn profiles.

Parameters3

url	string	required	The LinkedIn profile URL
enrich_mobile	boolean	optional	Whether to enrich with mobile phone data
webhook_url	string	optional	Optional webhook URL to receive results asynchronously

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The LinkedIn profile URL"
    },
    "enrich_mobile": {
      "description": "Whether to enrich with mobile phone data",
      "type": "boolean"
    },
    "webhook_url": {
      "description": "Optional webhook URL to receive results asynchronously",
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mpp_author_finder

Find the email address of the author of a blog post or article using MPP (Machine Payments Protocol). Pay-per-request, no API key required.

Parameters1

url

string

required

The URL of the article or blog post

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The URL of the article or blog post"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mpp_domain_search

Search for all email addresses associated with a specific domain using MPP (Machine Payments Protocol). Pay-per-request, no API key required — only an InFlow buyer key.

Parameters6

domain	string	optional	The domain to search for emails (e.g., 'example.com')
company	string	optional	The company name to search for
limit	string	optional	Maximum number of results to return
page	number	optional	Page number for pagination
department	string	optional	Filter by department (e.g., 'executive', 'it', 'marketing')
country	string	optional	Filter by country code (e.g., 'US', 'GB')

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "description": "The domain to search for emails (e.g., 'example.com')",
      "type": "string",
      "pattern": "^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"
    },
    "company": {
      "description": "The company name to search for",
      "type": "string",
      "minLength": 3,
      "maxLength": 75
    },
    "limit": {
      "description": "Maximum number of results to return",
      "default": "10",
      "type": "string",
      "enum": [
        "10",
        "20",
        "50"
      ]
    },
    "page": {
      "description": "Page number for pagination",
      "type": "number",
      "minimum": 1
    },
    "department": {
      "description": "Filter by department (e.g., 'executive', 'it', 'marketing')",
      "type": "string"
    },
    "country": {
      "description": "Filter by country code (e.g., 'US', 'GB')",
      "type": "string",
      "pattern": "^[A-Z]{2}$"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mpp_email_count

Get the count of email addresses available for a specific domain using MPP (Machine Payments Protocol). Pay-per-request, no API key required.

Parameters1

domain

string

required

The domain to count emails for

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$",
      "description": "The domain to count emails for"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mpp_email_enrichment

Enrich an email address with detailed contact and company information using MPP (Machine Payments Protocol). Pay-per-request, no API key required.

Parameters1

string

required

The email address to enrich

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The email address to enrich"
    }
  },
  "required": [
    "email"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mpp_email_finder

Find a person's email address given their name and company domain using MPP (Machine Payments Protocol). Pay-per-request, no API key required.

Parameters5

domain	string	optional	The domain of the company
company	string	optional	The company name
full_name	string	optional	The full name of the person
first_name	string	optional	The first name
last_name	string	optional	The last name

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "description": "The domain of the company",
      "type": "string",
      "pattern": "^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"
    },
    "company": {
      "description": "The company name",
      "type": "string",
      "minLength": 3,
      "maxLength": 75
    },
    "full_name": {
      "description": "The full name of the person",
      "type": "string",
      "minLength": 1
    },
    "first_name": {
      "description": "The first name",
      "type": "string",
      "minLength": 1
    },
    "last_name": {
      "description": "The last name",
      "type": "string",
      "minLength": 1
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mpp_email_verifier

Verify if an email address is valid and deliverable using MPP (Machine Payments Protocol). Pay-per-request, no API key required.

Parameters1

string

required

The email address to verify

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The email address to verify"
    }
  },
  "required": [
    "email"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mpp_linkedin_finder

Find a person's email address from their LinkedIn profile URL using MPP (Machine Payments Protocol). Pay-per-request, no API key required.

Parameters1

url

string

required

The LinkedIn profile URL

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The LinkedIn profile URL"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mpp_phone_finder

Find phone numbers associated with an email address, domain, or LinkedIn profile using MPP (Machine Payments Protocol). Pay-per-request, no API key required.

Parameters4

email	string	optional	The email address to look up
domain	string	optional	The domain to look up
linkedin	string	optional	The LinkedIn profile URL
full	boolean	optional	Whether to return full phone details

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "description": "The email address to look up",
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "domain": {
      "description": "The domain to look up",
      "type": "string",
      "pattern": "^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"
    },
    "linkedin": {
      "description": "The LinkedIn profile URL",
      "type": "string",
      "format": "uri"
    },
    "full": {
      "description": "Whether to return full phone details",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mpp_phone_validator

Validate a phone number and get carrier and location details using MPP (Machine Payments Protocol). Pay-per-request, no API key required.

Parameters1

phone

string

required

The phone number to validate in E.164 format

Raw schema

{
  "type": "object",
  "properties": {
    "phone": {
      "type": "string",
      "pattern": "^\\+?[1-9]\\d{1,14}$",
      "description": "The phone number to validate in E.164 format"
    }
  },
  "required": [
    "phone"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mpp_similar_finder

Find domains similar to a given domain using MPP (Machine Payments Protocol). Pay-per-request, no API key required.

Parameters1

domain

string

required

The domain to find similar domains for

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$",
      "description": "The domain to find similar domains for"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

phone_finder

Find phone numbers associated with an email address, domain, or LinkedIn profile. Returns direct and company phone numbers when available.

Parameters5

email	string	optional	Email address to search for phone numbers
domain	string	optional	Domain to search for phone numbers
linkedin	string	optional	LinkedIn URL to search for phone numbers
full	boolean	optional	Whether to return full phone details
webhook_url	string	optional	Optional webhook URL to receive results asynchronously

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "description": "Email address to search for phone numbers",
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "domain": {
      "description": "Domain to search for phone numbers",
      "type": "string",
      "pattern": "^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"
    },
    "linkedin": {
      "description": "LinkedIn URL to search for phone numbers",
      "type": "string",
      "format": "uri"
    },
    "full": {
      "description": "Whether to return full phone details",
      "type": "boolean"
    },
    "webhook_url": {
      "description": "Optional webhook URL to receive results asynchronously",
      "type": "string",
      "format": "uri"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

phone_validator

Validate and get information about a phone number. Returns the carrier, line type, country, and whether the number is valid.

Parameters1

phone

string

required

The phone number to validate (E.164 format recommended, e.g., +14155552671)

Raw schema

{
  "type": "object",
  "properties": {
    "phone": {
      "type": "string",
      "pattern": "^\\+?[1-9]\\d{1,14}$",
      "description": "The phone number to validate (E.164 format recommended, e.g., +14155552671)"
    }
  },
  "required": [
    "phone"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

similar_finder

Find companies similar to a given domain. Returns a list of competitor or similar businesses based on industry, size, and other factors.

Parameters1

domain

string

required

The domain to find similar companies for (e.g., 'example.com')

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$",
      "description": "The domain to find similar companies for (e.g., 'example.com')"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

technology_finder

Discover the technologies used by a website. Returns information about the tech stack including CMS, frameworks, analytics, and more.

Parameters1

domain

string

required

The domain to analyze for technologies (e.g., 'example.com')

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$",
      "description": "The domain to analyze for technologies (e.g., 'example.com')"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md34 KBView on GitHub

Tomba.io MCP Server

A Model Context Protocol (MCP) server for integrating with the Tomba.io API. This server provides comprehensive email discovery, verification, and enrichment capabilities through a standardized MCP interface.

Features

Tools (28 available)

Email Discovery

Domain Search: Find all email addresses associated with a domain
Email Finder: Generate likely email addresses from names and domains
Author Finder: Discover email addresses of article authors
LinkedIn Finder: Find emails from LinkedIn profile URLs
Email Count: Get total email counts for domains
Email Sources: Find where an email address was found on the web
Email Format: Get the email format patterns used by a domain

Verification

Email Verifier: Verify email deliverability and check database presence

Enrichment

Email Enrichment: Enrich emails with additional contact data
Person Enrichment: Find person data by email (name, position, social profiles)
Company Enrichment: Find company data by domain (industry, size, location)
Combined Enrichment: Combined person + company enrichment by email

Phone

Phone Finder: Search phone numbers by email, domain, or LinkedIn
Phone Validator: Validate phone numbers and check carrier info

Domain Intelligence

Domain Status: Check if a domain is webmail or disposable
Autocomplete: Company name suggestions with logo and domain info
Similar Finder: Find similar domains based on a target domain
Technology Finder: Discover technology stacks used by websites
Location: Get employees location count by country

Company Search

Companies Search: Search for companies using natural language queries with advanced filters

Account & Management

Account Info: Get current account information, plan, and credits
Usage Info: Get API usage statistics across all endpoints
List Flags: List submitted data flags with status and credit refunds
Create Flag: Report incorrect data (hard bounces, invalid emails) for credit recovery
List Leads: List leads with optional domain filter
Create Lead: Add a new lead to a list
List Keys: List API keys
Get Logs: Get recent API request logs

Resources (7 available)

tomba://api/status - API status and account info
tomba://domain/{domain} - Domain information
tomba://email/{email} - Email information
tomba://similar/{domain} - Similar domains analysis
tomba://technology/{domain} - Technology stack information
tomba://docs/api - API documentation
tomba://docs/tools - Tools documentation

Prompts (16 pre-built workflows)

find_contact - Find complete contact info for a person
verify_email_list - Batch verify email addresses
research_company - Research company contacts and structure
enrich_lead - Enrich a lead with all available data
find_journalists - Find journalist contacts from articles
phone_finder - Find phone numbers for contacts
validate_phone - Validate a phone number
competitor_analysis - Analyze competitors using similar domains and technology
technology_audit - Comprehensive technology audit of a website
domain_insights - Get comprehensive insights about a domain including email count and technology
bulk_domain_research - Research multiple domains for email counts and basic information
find_target_companies - Find companies with advanced filters (size, type, revenue, industry)
market_research - Research companies in a market segment with comprehensive filtering
lead_generation - Generate leads by finding companies and their contacts
prospect_enrichment - Enrich company prospects with comprehensive data
industry_analysis - Analyze companies within an industry with detailed segmentation

Filter	Available Values
Size	1-10 (Micro), 11-50 (Small), 51-250 (Mid-sized), 251-1K (Medium-large), 1K-5K (Large), 5K-10K (Very large), 10K-50K (Enterprise), 50K-100K (Massive), 100K+ (Global)
Type	education, government, nonprofit, private, public, personal
Revenue	$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
Industry	Based on LinkedIn Industry Codes V2 (140+ industries including Computer Software, Financial Services, Hospital & Health Care, etc.)

Performance & Reliability

Timeout

All API calls have a 120-second timeout. Tomba searches run in real time against live infrastructure — response times vary with the target company's SMTP server speed, website responsiveness, and the depth of catch-all detection.

Retry with Exponential Backoff

All API calls automatically retry up to 3 times with exponential backoff on:

429 Too Many Requests (rate limit exceeded)
5xx server errors

Retry delays: 1s → 2s → 4s.

Rate Limits

Rate limits are enforced per endpoint and per plan:

Plan	Per Second	Per Minute	Per Day
Free	1	2	5
Basic	3	50	500
Growth	5	80	1,000
Pro	8	150	4,000
50,000+ plans	Unlimited	Unlimited	Unlimited

No credits are charged when Tomba cannot provide a result. Duplicate requests within 30 days are not counted again.

Transport Options

stdio - Standard input/output (default, for Claude Desktop)
http - HTTP server with REST endpoints

Installation

Prerequisites

Node.js 18 or higher
npm or yarn
Tomba API account (Sign up here)

Screenshots

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Note: The npm package has been renamed from tomba-mcp-server to @tomba-io/tomba-mcp-server. Please update your configurations accordingly.

Option 1: Install via NPX (Recommended)

The easiest way to use the Tomba MCP server is via npx, which doesn't require cloning the repository:

macOS/Linux

Add to your claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json):

json

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows

Add to your claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json):

json

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Note: The -y flag automatically accepts the installation prompt, and npx will always fetch the latest version.

Option 2: Install from Source

If you want to modify the server or contribute to development:

bash

# Clone the repository
git clone https://github.com/tomba-io/tomba-mcp-server.git
cd tomba-mcp-server

# Install dependencies
yarn install

# Build the project
yarn build

Configuration

OpenClaw Skill

This repository now includes a workspace-local OpenClaw skill at skills/tomba-contact-intelligence/SKILL.md.

The skill is designed to help OpenClaw choose the right Tomba MCP tools for contact discovery, company research, email verification, phone lookup, and prospect enrichment workflows.

To use it:

Open this repository as your OpenClaw workspace, or copy the skills/tomba-contact-intelligence directory into your OpenClaw skills directory.
Ensure the Tomba MCP server is configured and available to OpenClaw.
Start a new OpenClaw session so the skill is loaded.

Example prompts:

"Find the best contact for partnerships at stripe.com and verify the email before you return it."
"Research fintech companies in Germany, then identify likely sales contacts for the top matches."
"Enrich this prospect with email, phone, company technology, and similar competitors: jane@acme.com"

Claude Desktop Setup

To use this server with Claude Desktop, add the configuration to your claude_desktop_config.json file.

Using NPX (Recommended)

This method automatically uses the latest published version:

macOS/Linux (~/Library/Application Support/Claude/claude_desktop_config.json):

json

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows (%APPDATA%\Claude\claude_desktop_config.json):

json

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Using Local Installation

If you've built from source, use the absolute path to your installation:

macOS/Linux:

json

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": ["/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows:

json

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": [
                "C:\\ABSOLUTE\\PATH\\TO\\tomba-mcp-server\\server\\index.js"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Important Notes:

Replace your-api-key-here and your-secret-key-here with your actual Tomba API credentials
For local installation, replace /ABSOLUTE/PATH/TO/tomba-mcp-server with the full path to your installation directory
Restart Claude Desktop after updating the configuration

Getting Tomba API Credentials

Visit https://tomba.io
Sign up for an account or log in
Navigate to your dashboard
Go to API settings
Copy your API Key and Secret Key

Alternative: Using HTTP Transport

For HTTP transport with npx:

json

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": [
                "-y",
                "@tomba-io/tomba-mcp-server",
                "--transport",
                "http",
                "--port",
                "3000"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

For HTTP transport with local installation:

json

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js",
                "--transport",
                "http",
                "--port",
                "3000"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Usage

Command-line Options

bash

Usage: tomba-mcp-server [options]

Options:
  --transport <type>    Transport type: 'stdio' or 'http' (default: stdio)
  --port <number>       Port number for HTTP transport (default: 3000)
  --help                Show help message

Environment Variables:
  TOMBA_API_KEY         Your Tomba API key (required)
  TOMBA_SECRET_KEY      Your Tomba secret key (required)

Examples:
  # Run with stdio transport (default)
  node server/index.js

  # Run with HTTP transport on default port (3000)
  node server/index.js --transport http

  # Run with HTTP transport on custom port
  node server/index.js --transport http --port 8080

Standalone HTTP Server

You can also run the server as a standalone HTTP service:

bash

export TOMBA_API_KEY="your-api-key"
export TOMBA_SECRET_KEY="your-secret-key"
node server/index.js --transport http --port 3000

HTTP API Endpoints

POST /mcp - Send JSON-RPC requests
GET /mcp - Server-Sent Events for notifications (requires X-Session-Id header)
DELETE /mcp - Terminate a session (requires X-Session-Id header)
GET /health - Health check endpoint
GET /sessions - List active sessions (requires authentication)

Example HTTP Request

bash

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "email_finder",
      "arguments": {
        "domain": "stripe.com",
        "firstName": "Patrick",
        "lastName": "Collison"
      }
    },
    "id": 1
  }'

🔧 Development

Development Commands

bash

# Run in development mode
yarn dev

# Build the project
yarn build

# Run tests
yarn test

# Run tests in watch mode
yarn test:watch

# Run tests with coverage
yarn test:coverage

# Lint code
yarn lint

# Fix linting errors
yarn lint:fix

🔍 Debugging & Testing

MCP Inspector (Recommended)

The easiest way to test and debug your MCP server:

bash

# Build and launch MCP Inspector
yarn debug

This opens a web interface where you can:

📋 View all available tools
🧪 Test tools interactively
📊 Inspect requests/responses
🐛 Debug in real-time

Alternative Debug Methods

bash

# Debug TypeScript directly
yarn debug:dev

# Run integration tests
yarn test:integration

# Manual testing
yarn build
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node server/index.js

VS Code Debugging

If using VS Code, use the included debug configurations:

Debug MCP Server: Debug the compiled JavaScript
Debug TypeScript: Debug TypeScript source directly
Debug with Inspector: Debug with MCP Inspector
Run Tests: Debug Jest tests

See DEBUG_GUIDE.md for comprehensive debugging instructions.

🧪 Testing Individual Tools

1. Domain Search

Search for email addresses associated with a domain name.

json

{
    "name": "domain_search",
    "arguments": {
        "domain": "tomba.io",
        "limit": 10,
        "page": 1
    }
}

Response:

json

{
  "data": {
    "organization": {
      "website_url": "tomba.io",
      "organization": "Tomba technology web service LLC",
      "location": {
        "country": "US",
        "city": "Claymont",
        "state": "Delaware",
        "street_address": "1228 claymont",
        "postal_code": "19703"
      },
      "social_links": {
        "twitter_url": "https://twitter.com/tombaplatforum",
        "facebook_url": "https://www.facebook.com/tombaplatforum",
        "linkedin_url": "https://www.linkedin.com/company/tomba-io"
      },
      "disposable": false,
      "webmail": false,
      "phone_number": "(850) 790-5575",
      "industries": "Information Technology and Services",
      "founded": "2021",
      "company_size": "1-10",
      "company_type": "privately held",
      "revenue": "$0-$1M",
      "accept_all": false,
      "description": "the most powerful email-finding tool which is able to list all the email addresses of people who are working in a particular company.",
      "pattern": "{l}.{first}",
      "total_similar": 35,
      "keywords": [
        "lead generation software"
      ],
      "ranking": 661495,
      "whois": {
        "registrar_name": "namecheap, inc.",
        "created_date": "2020-07-07T20:54:07+02:00",
        "referral_url": "https://www.namecheap.com/"
      },
      "last_updated": "2025-09-06T00:22:01+02:00"
    },
    "emails": [
      {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "DZ",
        "position": "CEO",
        "department": "executive",
        "seniority": "senior",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "verification": {
          "date": "2025-09-22T00:00:00+02:00",
          "status": "valid"
        },
        "sources": [
          {
            "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
            "website_url": "github.com",
            "extracted_on": "2021-02-08T20:09:54+01:00",
            "last_seen_on": "2021-02-08T22:43:40+01:00",
            "still_on_page": true
          },
          ....
        ]
      },
      ...
      ...
      ...
      ...
      ...
    ]
  },
  "meta": {
    "total": 21,
    "pageSize": 10,
    "current": 1,
    "total_pages": 3,
    "params": {
      "domain": "tomba.io",
      "page": 1,
      "limit": 10,
      "department": null,
      "country": null,
      "type": "all",
      "live": false
    }
  }
}

2. Email Finder

Generate likely email addresses from domain, first name, and last name.

json

{
    "name": "email_finder",
    "arguments": {
        "domain": "example.com",
        "firstName": "John",
        "lastName": "Doe"
    }
}

Response:

json

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

3. Email Verifier

Verify email address deliverability and check database presence.

json

{
    "name": "email_verifier",
    "arguments": {
        "email": "b.mohamed@tomba.io"
    }
}

Response:

json

{
    "data": {
        "email": {
            "email": "b.mohamed@tomba.io",
            "result": "deliverable",
            "status": "valid",
            "score": 99,
            "smtp_provider": "Google Workspace",
            "mx": {
                "records": [
                    "aspmx.l.google.com",
                    "alt2.aspmx.l.google.com",
                    "alt1.aspmx.l.google.com",
                    "alt4.aspmx.l.google.com",
                    "alt3.aspmx.l.google.com"
                ]
            },
            "mx_check": true,
            "smtp_server": true,
            "smtp_check": true,
            "accept_all": false,
            "greylisted": false,
            "block": true,
            "gibberish": false,
            "disposable": false,
            "webmail": false,
            "regex": true,
            "whois": {
                "registrar_name": "namecheap, inc.",
                "referral_url": "https://www.namecheap.com/",
                "created_date": "2020-07-07T20:54:07+02:00"
            }
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

4. Email Enrichment

Enrich an email address with additional contact information.

json

{
    "name": "email_enrichment",
    "arguments": {
        "email": "b.mohamed@tomba.io"
    }
}

Response:

json

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

5. Author Finder

Find email addresses of article authors from a URL.

json

{
    "name": "author_finder",
    "arguments": {
        "url": "https://example.com/article"
    }
}

Response:

json

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

6. LinkedIn Finder

Find email addresses from LinkedIn profile URLs.

json

{
    "name": "linkedin_finder",
    "arguments": {
        "url": "https://linkedin.com/in/johndoe"
    }
}

Response:

json

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

7. Phone Finder

Search for phone numbers based on email, domain, or LinkedIn profile.

json

{
    "name": "phone_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Response:

json

{
    "data": {
        "domain": "tomba.io",
        "valid": true,
        "local_format": "(850) 790-5575",
        "intl_format": "+1 850-790-5575",
        "e164_format": "+18507905575",
        "rfc3966_format": "tel:+1-850-790-5575",
        "country_code": "US",
        "line_type": "FIXED_LINE_OR_MOBILE",
        "carrier": "",
        "timezones": ["America/New_York"]
    }
}

8. Phone Validator

Validate phone numbers and check carrier information.

json

{
    "name": "phone_validator",
    "arguments": {
        "phone": "+213667945402"
    }
}

Response:

json

{
    "data": {
        "valid": true,
        "local_format": "0667 94 54 02",
        "intl_format": "+213 667 94 54 02",
        "e164_format": "+213667945402",
        "rfc3966_format": "tel:+213-667-94-54-02",
        "country_code": "DZ",
        "line_type": "MOBILE",
        "carrier": "Mobilis",
        "timezones": ["Europe/Paris"]
    }
}

9. Email Count

Get the total number of email addresses for a domain.

json

{
    "name": "email_count",
    "arguments": {
        "domain": "tomba.io"
    }
}

Response:

json

{
    "domain": "tomba.io",
    "total": 245,
    "personalEmails": 198,
    "genericEmails": 47,
    "department": {
        "engineering": 45,
        "sales": 38,
        "marketing": 32,
        "hr": 15,
        "finance": 12,
        "legal": 8,
        "executive": 25,
        "support": 28,
        "other": 42
    },
    "seniority": {
        "junior": 89,
        "senior": 125,
        "executive": 31
    },
    "source": "tomba_email_count"
}

10. Similar Finder

Find similar domains based on a specific domain.

json

{
    "name": "similar_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Response:

json

{
    "data": [
        {
            "website_url": "summit.com",
            "name": "Summit",
            "industries": "Wholesale"
        },
        {
            "website_url": "hunter.io",
            "name": "Hunter",
            "industries": "Information Technology and Services"
        },
        {
            "website_url": "voilaNorbert.com",
            "name": "VoilaNorbert",
            "industries": "Information Technology and Services"
        }
    ]
}

11. Technology Finder

Instantly reveal the technology stack of any website.

json

{
    "name": "technology_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Response:

json

{
    "domain": "tomba.io",
    "data": [
        {
            "slug": "intercom",
            "name": "Intercom",
            "icon": "Intercom.png",
            "website": "https://www.intercom.com",
            "categories": {
                "id": 10,
                "slug": "analytics",
                "name": "Analytics"
            }
        }
    ]
}

12. Companies Search

Search for companies using natural language queries with advanced filters including location, industry, size, and revenue.

json

{
    "name": "companies_search",
    "arguments": {
        "filters": {
            "location_city": {
                "include": ["san francisco"]
            },
            "industry": {
                "include": ["technology"]
            },
            "size": {
                "include": ["51-200", "201-500"]
            }
        },
        "page": 1,
        "limit": 10
    }
}

Response:

json

{
    "data": {
        "companies": [
            {
                "name": "Tech Company Inc",
                "domain": "techcompany.com",
                "industry": "Technology",
                "location": {
                    "city": "San Francisco",
                    "state": "California",
                    "country": "United States"
                },
                "size": "51-200",
                "revenue": "$10M-$50M"
            }
        ],
        "total": 150,
        "page": 1
    }
}

Available Filters:

location_city: Filter by city with include/exclude arrays
location_state: Filter by state with include/exclude arrays
location_country: Filter by country with include/exclude arrays
industry: Filter by industry (based on LinkedIn Industry Codes V2 - 140+ industries)
type: Filter by company type: education, government, nonprofit, private, public, personal
size: Filter by company size: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
revenue: Filter by revenue range: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
founded: Filter by founding year with include/exclude arrays
keywords: Filter by keywords with include/exclude arrays
sic: Filter by SIC codes with include/exclude arrays
naics: Filter by NAICS codes with include/exclude arrays
similar: Filter by similar domains with include/exclude arrays

Rate Limiting & Usage

API Rate Limits

Tomba.io implements rate limiting based on your subscription plan:

Free Plan: 50 requests per month
Growth Plan: 5,000 requests per month + 10,000 verifications requests
Pro Plan: 10,000 requests per month
Enterprise Plan: 50,000 requests per month
Custom Plan: Custom limits

Learn more about Tomba Pricing Plans.

Rate Limit Headers

Each API response includes rate limit information:

code

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1609459200

Learn more about Tomba API Rate Limits.

Handling Rate Limits

When you exceed your rate limit, the API returns a 429 Too Many Requests status with:

json

{
    "error": {
        "type": "rate_limit",
        "message": "Rate limit exceeded. Please try again in 60 seconds",
        "code": 429
    }
}

Best Practices

Monitor Usage: Check your dashboard at tomba.io/dashboard
Implement Backoff: Handle 429 responses with exponential backoff
Batch Operations: Use domain search for multiple emails from the same domain
Cache Results: Store results locally to avoid duplicate requests
Plan Accordingly: Upgrade your plan based on usage patterns

Usage Tips

Domain search returns multiple emails per request (more efficient than individual lookups)
Email verification consumes credits only for valid email formats
Phone finder may return multiple numbers per request
Enrichment provides comprehensive data in a single request

Troubleshooting

Server Not Starting in Claude Desktop

Check Node.js version: Ensure you have Node.js 18 or higher
bash
```
node --version
```
Using NPX:
- Ensure you have a stable internet connection for the first run
- The -y flag should auto-accept the installation
- NPX will cache the package after first use
Using Local Installation:
- Verify absolute path is correct in your config
- Ensure server/index.js exists: ls -la server/index.js
- Make sure you ran yarn build successfully
Verify API credentials: Ensure your Tomba API keys are correct
Check Claude logs:
- macOS: ~/Library/Logs/Claude/mcp*.log
- Windows: %APPDATA%\Claude\logs\mcp*.log

NPX-Specific Issues

"npx command not found":

Ensure npm is installed: npm --version
NPX comes with npm 5.2.0+, update if needed: npm install -g npm

Package not found:

Verify the package is published: npm view @tomba-io/tomba-mcp-server
Try clearing npm cache: npm cache clean --force

Always downloading package:

This is normal behavior with -y flag
NPX caches the package after first download
For a permanent installation, use local installation method

Authentication Errors

Verify your API keys at https://app.tomba.io/dashboard
Ensure environment variables are properly set in the config
Check that your API subscription is active

Tools Not Responding

Check your Tomba API rate limits
Verify network connectivity
Review server logs for error messages

About Tomba

Founded in 2020, Tomba prides itself on being the most reliable, accurate, and in-depth source of email address data available anywhere. We process terabytes of data to produce our Email finder API.

Contributing

Fork it (https://github.com/tomba-io/tomba-mcp-server/fork)
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request

License

Please see the License file for more information.

Support

Install

Tools (22)

author_findercompanies_searchdomain_searchemail_countemail_enrichmentemail_finderemail_verifierlinkedin_finder

Configuration

Environment variables

TOMBA_API_KEYrequiredsecret

Tomba API key (format: ta_*)

TOMBA_SECRET_KEYrequiredsecret

Tomba secret key (format: ts_*)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "tomba-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@tomba-io/tomba-mcp-server@1.10.0"
      ],
      "env": {
        "TOMBA_API_KEY": "<YOUR_TOMBA_API_KEY>",
        "TOMBA_SECRET_KEY": "<YOUR_TOMBA_SECRET_KEY>"
      }
    }
  }
}

Tomba Email MCP Server (io.github.tomba-io/tomba-mcp-server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

author_finder

companies_search

domain_search

email_count

email_enrichment

email_finder

email_verifier

linkedin_finder

mpp_author_finder

mpp_domain_search

mpp_email_count

mpp_email_enrichment

mpp_email_finder

mpp_email_verifier

mpp_linkedin_finder

mpp_phone_finder

mpp_phone_validator

mpp_similar_finder

phone_finder

phone_validator

similar_finder

technology_finder

Tomba.io MCP Server

Features

Tools (28 available)

Email Discovery

Verification

Enrichment

Phone

Domain Intelligence

Company Search

Account & Management

Resources (7 available)

Prompts (16 pre-built workflows)

Filter Options for Company Search Prompts

Performance & Reliability

Timeout

Retry with Exponential Backoff

Rate Limits

Transport Options

Installation

Prerequisites

Screenshots

Option 1: Install via NPX (Recommended)

macOS/Linux

Windows

Option 2: Install from Source

Configuration

OpenClaw Skill

Claude Desktop Setup

Using NPX (Recommended)

Using Local Installation

Getting Tomba API Credentials

Alternative: Using HTTP Transport

Usage

Command-line Options

Standalone HTTP Server

HTTP API Endpoints

Example HTTP Request

🔧 Development

Development Commands

🔍 Debugging & Testing

MCP Inspector (Recommended)

Alternative Debug Methods

VS Code Debugging

🧪 Testing Individual Tools

1. Domain Search

2. Email Finder

3. Email Verifier

4. Email Enrichment

5. Author Finder

6. LinkedIn Finder

7. Phone Finder

8. Phone Validator