# 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 (12)

| Tool                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `domain_search`     | Search for email addresses associated with a domain          |
| `email_finder`      | Find a person's email address by name and company            |
| `email_verifier`    | Verify if an email address is valid and deliverable          |
| `email_enrichment`  | Enrich an email with additional contact information          |
| `author_finder`     | Find the email address of an article's author                |
| `linkedin_finder`   | Find email address from a LinkedIn profile URL               |
| `phone_finder`      | Find phone numbers for an email, domain, or LinkedIn profile |
| `phone_validator`   | Validate and get information about a phone number            |
| `email_count`       | Get the count of emails available for a domain               |
| `similar_finder`    | Find companies similar to a given domain                     |
| `technology_finder` | Discover technologies used by a website                      |
| `companies_search`  | Search for companies in the Tomba database                   |

## 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.

## Usage Examples

### Basic Tool Usage

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

### Workflow Execution

```json
{
    "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:

```json
{
    "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"
        }
    }
}
```
