Copy page

Remote MCP Server

Tomba Remote MCP Tools

Available Tools

The Tomba Remote MCP Server provides a comprehensive suite of professional tools for email discovery, verification, and data enrichment. All tools are accessible through the Model Context Protocol interface with real-time processing and enterprise-grade reliability.

Tools (28)

Email Discovery

Tool	Description
domain_search	Search for email addresses associated with a domain
email_finder	Find a person's email address by name and company
author_finder	Find the email address of an article's author
linkedin_finder	Find email address from a LinkedIn profile URL
email_count	Get the count of emails available for a domain
email_sources	Find where an email address was found on the web
email_format	Get the email format patterns used by a domain

Verification

Tool	Description
email_verifier	Verify if an email address is valid and deliverable

Enrichment

Tool	Description
email_enrichment	Enrich an email with additional contact information
person_enrichment	Find person data by email (name, position, social)
company_enrichment	Find company data by domain (industry, size, social)
combined_enrichment	Combined person + company enrichment by email

Phone

Tool	Description
phone_finder	Find phone numbers for an email, domain, or LinkedIn profile
phone_validator	Validate and get information about a phone number

Domain Intelligence

Tool	Description
domain_status	Check if a domain is webmail or disposable
autocomplete	Company name suggestions with logo and domain info
similar_finder	Find companies similar to a given domain
technology_finder	Discover technologies used by a website
location	Get employees location count by country

Company Search

Tool	Description
companies_search	Search for companies using natural language with filters

Account & Management

Tool	Description
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)
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 (3)

Resource	URI	Description
Account Info	tomba://account	Current account information and usage
Domain Stats	tomba://domain/{domain}/stats	Email statistics for a domain
Usage Stats	tomba://usage	API usage statistics

Prompts (12)

Prompt	Description
lead-research	Research a company and find key contacts for outreach
competitor-analysis	Analyze competitors including tech stack, team structure, and contacts
email-verification	Verify a list of email addresses
find-person	Find a specific person's email at a company
content-outreach	Find authors and content creators for outreach campaigns
account-based-marketing	Build comprehensive ABM campaigns with multi-stakeholder targeting
investor-research	Research VCs/investors, portfolio companies, and find decision makers
hiring-outreach	Source candidates from target companies for recruiting
partnership-research	Identify strategic partners and integration opportunities
market-research	Conduct industry analysis across multiple companies
sales-territory-mapping	Build territory plans with account prioritization and stakeholder mapping
due-diligence	Comprehensive company analysis for investment, acquisition, or partnership

Tool Details

Email Discovery Tools

Domain Search

Discovers all available email addresses associated with a specific domain name. Perfect for competitive intelligence, lead generation, and comprehensive contact mapping.

Parameters:

• domain (required): The target domain to search
• limit (optional): Maximum number of results to return
• department (optional): Filter by specific department

Email Finder

Generates potential email addresses based on a person's name and their company domain using advanced pattern recognition and validation.

Parameters:

• first_name (required): Person's first name
• last_name (required): Person's last name
• domain (required): Company domain
• full_name (optional): Complete name for better accuracy

Author Finder

Extracts author email addresses from articles, blog posts, and other content by analyzing bylines, metadata, and content structure.

Parameters:

• url (required): URL of the article or content
• author_name (optional): Specific author name to target

LinkedIn Finder

Discovers email addresses from LinkedIn profile information using advanced matching algorithms and data correlation.

Parameters:

• linkedin_url (required): LinkedIn profile URL
• company_domain (optional): Company domain for validation

Verification & Validation Tools

Email Verifier

Performs comprehensive email deliverability verification including syntax validation, domain verification, and mailbox existence checking.

Parameters:

• email (required): Email address to verify
• smtp_check (optional): Enable/disable SMTP verification

Email Enrichment

Enriches email addresses with additional contact information including social profiles, job titles, and company data.

Parameters:

• email (required): Email address to enrich
• include_sources (optional): Include data source information

Phone Finder

Discovers phone numbers associated with email addresses or contact profiles using cross-platform data correlation.

Parameters:

• email (optional): Email address for phone lookup
• first_name (optional): Person's first name
• last_name (optional): Person's last name
• company (optional): Company name or domain

Phone Validator

Validates phone number format, carrier information, and geographic location for data quality assurance.

Parameters:

• phone (required): Phone number to validate
• country_code (optional): Expected country code

Company Intelligence Tools

Email Count

Retrieves the total number of email addresses available in Tomba's database for a specific domain.

Parameters:

• domain (required): The target domain to count emails
• type (optional): Filter by email type (personal/generic)

Returns: Total count, personal emails count, generic emails count, and department breakdown.

Technology Finder

Discovers the complete technology stack used by a website. Tracks 6000+ technologies across multiple categories including analytics, payment processing, marketing automation, and more.

Parameters:

• domain (required): The target domain to analyze

Returns: List of technologies with categories, icons, and website links.

Similar Finder

Finds companies similar to a target domain based on industry, size, technology stack, and business model.

Parameters:

• domain (required): The target domain to find similar companies
• limit (optional): Maximum number of similar companies to return (default: 10, max: 50)

Returns: List of similar domains with similarity scores, industry info, and employee counts.

Companies Search

Search for companies using natural language queries with advanced filtering capabilities. Supports complex queries and multiple filter combinations.

Parameters:

• query (required): Natural language search query (e.g., "SaaS startups in Europe")
• page (optional): Page number for pagination (default: 1)
• limit (optional): Results per page (default: 50, max: 100)
• filters (optional): Advanced filters object
  • country: Array of country codes
  • industry: Array of industry names
  • employees: Employee range string
  • revenue: Revenue range string
  • technologies: Array of technology names
  • city: Array of city names
  • founded: Object with min/max year range

Returns: List of companies with full details including domain, organization name, industry, location, employee count, revenue, technologies, and email count.

Email Sources

Find where an email address was found on the web.

Parameters:

• email (required): Email address to search

Email Format

Get the email format patterns used by a specific domain.

Parameters:

• domain (required): Target domain name

Domain Status

Check if a domain is a webmail provider or disposable email service.

Parameters:

• domain (required): Target domain name

Autocomplete

Company name suggestions with logo and domain information.

Parameters:

• query (required): Partial company name or domain

Location

Get employees location count by country for a domain.

Parameters:

• domain (required): Target domain name

Enrichment Tools

Person Enrichment

Find person data by email including name, position, company, and social profiles.

Parameters:

• email (required): Email address to enrich

Company Enrichment

Find company data by domain including industry, size, location, and social profiles.

Parameters:

• domain (required): Target domain name

Combined Enrichment

Combined person and company enrichment by email — returns both person and company data.

Parameters:

• email (required): Email address to enrich

Account Tools

Account Info

Get current Tomba account information including plan, credits, and usage limits. No parameters required.

Usage Info

Get current API usage statistics across all endpoints. No parameters required.

Account & Management Tools

List Flags

List submitted data flags with their status and credit refund information.

Parameters:

• page (optional): Page number (default: 1)
• limit (optional): Results per page (default: 10, max: 100)

Create Flag

Report incorrect data (hard bounces, invalid emails, wrong company) for credit recovery. Confirmed flags result in automatic credit refunds.

Parameters:

• flag_type (required): email, organization, phone, author_url, website
• value (required): The flagged item (email, domain, phone, or URL)
• reason (required): Must match flag_type — e.g., hard_bounce for email, wrong_company for organization
• comment (optional): Additional details (max 1000 chars)

List Leads

List leads with optional filtering by domain.

Parameters:

• page (optional): Page number
• limit (optional): Results per page
• domain (optional): Filter leads by domain

Create Lead

Add a new lead to a lead list.

Parameters:

• email (required): Lead's email address
• list_id (required): ID of the lead list
• first_name (optional): First name
• last_name (optional): Last name
• company (optional): Company name
• position (optional): Job title

List Keys

List all API keys for the account. No parameters required.

Get Logs

Get recent API request logs with pagination.

Parameters:

• page (optional): Page number
• limit (optional): Results per page

Performance & Reliability

All API calls have a 120-second timeout and automatically retry up to 3 times with exponential backoff (1s → 2s → 4s) on 429 Too Many Requests and 5xx server errors.

Usage Examples

Basic Tool Usage

Code
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "domain_search",
        "arguments": {
            "domain": "example.com",
            "limit": 10
        }
    }
}

Workflow Execution

Code
{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
        "name": "find_contact",
        "arguments": {
            "first_name": "John",
            "last_name": "Doe",
            "company_domain": "example.com"
        }
    }
}

Error Handling

All tools return standardized error responses with detailed information:

Code
{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32000,
        "message": "Tool execution failed",
        "data": {
            "tool_name": "domain_search",
            "error_type": "validation_error",
            "details": "Invalid domain format"
        }
    }
}