{"id":33580443,"url":"https://github.com/tomba-io/tomba-mcp-server","last_synced_at":"2026-03-10T08:00:40.734Z","repository":{"id":317240188,"uuid":"1061942420","full_name":"tomba-io/tomba-mcp-server","owner":"tomba-io","description":"MCP Server for Tomba.io API integration","archived":false,"fork":false,"pushed_at":"2026-02-09T12:16:05.000Z","size":910,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-09T17:15:29.027Z","etag":null,"topics":["ai","aiagent","aiworkflow","api","email","mcp","mcp-server","mcp-tools","tomba","verification"],"latest_commit_sha":null,"homepage":"https://tomba.io/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tomba-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-22T15:37:08.000Z","updated_at":"2026-02-09T12:16:09.000Z","dependencies_parsed_at":"2025-09-29T19:37:51.137Z","dependency_job_id":null,"html_url":"https://github.com/tomba-io/tomba-mcp-server","commit_stats":null,"previous_names":["tomba-io/tomba-mcp-server"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/tomba-io/tomba-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomba-io%2Ftomba-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomba-io%2Ftomba-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomba-io%2Ftomba-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomba-io%2Ftomba-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tomba-io","download_url":"https://codeload.github.com/tomba-io/tomba-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomba-io%2Ftomba-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30326878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T05:25:20.737Z","status":"ssl_error","status_checked_at":"2026-03-10T05:25:17.430Z","response_time":106,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","aiagent","aiworkflow","api","email","mcp","mcp-server","mcp-tools","tomba","verification"],"created_at":"2025-11-28T21:00:30.536Z","updated_at":"2026-03-10T08:00:40.669Z","avatar_url":"https://github.com/tomba-io.png","language":"TypeScript","funding_links":[],"categories":["MCP 服务器精选列表"],"sub_categories":["💬 通讯与协作 (Slack, Email, Calendar, Social, etc.)"],"readme":"# [\u003cimg src=\"https://tomba.io/logo.svg\" alt=\"Tomba\" width=\"25\"/\u003e](https://tomba.io/) Tomba.io MCP Server\n\nA 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.\n\n## Features\n\n### Tools (12 available)\n\n- **[Domain Search](https://tomba.io/domain-search)**: Find all email addresses associated with a domain\n- **[Email Finder](https://tomba.io/email-finder)**: Generate likely email addresses from names and domains\n- **[Email Verifier](https://tomba.io/email-verifier)**: Verify email deliverability and check database presence\n- **[Email Enrichment](https://tomba.io/enrichment)**: Enrich emails with additional contact data\n- **[Author Finder](https://tomba.io/author-finder)**: Discover email addresses of article authors\n- **[LinkedIn Finder](https://tomba.io/linkedin-finder)**: Find emails from LinkedIn profile URLs\n- **[Phone Finder](https://tomba.io/phone-finder)**: Search phone numbers by email, domain, or LinkedIn\n- **[Phone Validator](https://tomba.io/phone-validator)**: Validate phone numbers and check carrier info\n- **[Email Count](https://tomba.io/email-count)**: Get total email counts for domains\n- **[Similar Finder](https://tomba.io/similar-domains)**: Find similar domains based on a target domain\n- **[Technology Finder](https://tomba.io/technology-finder)**: Discover technology stacks used by websites\n- **[Companies Search](https://app.tomba.io/reveal)**: Search for companies using natural language queries with advanced filters\n\n### Resources (7 available)\n\n- `tomba://api/status` - API status and account info\n- `tomba://domain/{domain}` - Domain information\n- `tomba://email/{email}` - Email information\n- `tomba://similar/{domain}` - Similar domains analysis\n- `tomba://technology/{domain}` - Technology stack information\n- `tomba://docs/api` - API documentation\n- `tomba://docs/tools` - Tools documentation\n\n### Prompts (16 pre-built workflows)\n\n- **find_contact** - Find complete contact info for a person\n- **verify_email_list** - Batch verify email addresses\n- **research_company** - Research company contacts and structure\n- **enrich_lead** - Enrich a lead with all available data\n- **find_journalists** - Find journalist contacts from articles\n- **finder_phone** - Find phone numbers for contacts\n- **validate_phone** - Validate a phone number\n- **competitor_analysis** - Analyze competitors using similar domains and technology\n- **technology_audit** - Comprehensive technology audit of a website\n- **domain_insights** - Get comprehensive insights about a domain including email count and technology\n- **bulk_domain_research** - Research multiple domains for email counts and basic information\n- **find_target_companies** - Find companies with advanced filters (size, type, revenue, industry)\n- **market_research** - Research companies in a market segment with comprehensive filtering\n- **lead_generation** - Generate leads by finding companies and their contacts\n- **prospect_enrichment** - Enrich company prospects with comprehensive data\n- **industry_analysis** - Analyze companies within an industry with detailed segmentation\n\n#### Filter Options for Company Search Prompts\n\n| Filter       | Available Values                                                                                                                                                     |\n| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **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) |\n| **Type**     | education, government, nonprofit, private, public, personal                                                                                                          |\n| **Revenue**  | $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+                                                                        |\n| **Industry** | Based on LinkedIn Industry Codes V2 (140+ industries including Computer Software, Financial Services, Hospital \u0026 Health Care, etc.)                                  |\n\n### Transport Options\n\n- **stdio** - Standard input/output (default, for Claude Desktop)\n- **http** - HTTP server with REST endpoints\n\n## Installation\n\n### Prerequisites\n\n- Node.js 18 or higher\n- npm or yarn\n- Tomba API account ([Sign up here](https://tomba.io))\n\n## Screenshots\n\n![Screenshot 1](assets/screenshots/screenshot1.png)\n![Screenshot 2](assets/screenshots/screenshot2.png)\n![Screenshot 3](assets/screenshots/screenshot3.png)\n![Screenshot 4](assets/screenshots/screenshot4.png)\n![Screenshot 5](assets/screenshots/screenshot5.png)\n\n### Option 1: Install via NPX (Recommended)\n\nThe easiest way to use the Tomba MCP server is via npx, which doesn't require cloning the repository:\n\n#### macOS/Linux\n\nAdd to your `claude_desktop_config.json` (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n    \"mcpServers\": {\n        \"tomba\": {\n            \"command\": \"npx\",\n            \"args\": [\"-y\", \"tomba-mcp-server\"],\n            \"env\": {\n                \"TOMBA_API_KEY\": \"your-api-key-here\",\n                \"TOMBA_SECRET_KEY\": \"your-secret-key-here\"\n            }\n        }\n    }\n}\n```\n\n#### Windows\n\nAdd to your `claude_desktop_config.json` (`%APPDATA%\\Claude\\claude_desktop_config.json`):\n\n```json\n{\n    \"mcpServers\": {\n        \"tomba\": {\n            \"command\": \"npx\",\n            \"args\": [\"-y\", \"tomba-mcp-server\"],\n            \"env\": {\n                \"TOMBA_API_KEY\": \"your-api-key-here\",\n                \"TOMBA_SECRET_KEY\": \"your-secret-key-here\"\n            }\n        }\n    }\n}\n```\n\n**Note:** The `-y` flag automatically accepts the installation prompt, and npx will always fetch the latest version.\n\n### Option 2: Install from Source\n\nIf you want to modify the server or contribute to development:\n\n```bash\n# Clone the repository\ngit clone https://github.com/tomba-io/tomba-mcp-server.git\ncd tomba-mcp-server\n\n# Install dependencies\nyarn install\n\n# Build the project\nyarn build\n```\n\n## Configuration\n\n### Claude Desktop Setup\n\nTo use this server with Claude Desktop, add the configuration to your `claude_desktop_config.json` file.\n\n#### Using NPX (Recommended)\n\nThis method automatically uses the latest published version:\n\n**macOS/Linux** (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n    \"mcpServers\": {\n        \"tomba\": {\n            \"command\": \"npx\",\n            \"args\": [\"-y\", \"tomba-mcp-server\"],\n            \"env\": {\n                \"TOMBA_API_KEY\": \"your-api-key-here\",\n                \"TOMBA_SECRET_KEY\": \"your-secret-key-here\"\n            }\n        }\n    }\n}\n```\n\n**Windows** (`%APPDATA%\\Claude\\claude_desktop_config.json`):\n\n```json\n{\n    \"mcpServers\": {\n        \"tomba\": {\n            \"command\": \"npx\",\n            \"args\": [\"-y\", \"tomba-mcp-server\"],\n            \"env\": {\n                \"TOMBA_API_KEY\": \"your-api-key-here\",\n                \"TOMBA_SECRET_KEY\": \"your-secret-key-here\"\n            }\n        }\n    }\n}\n```\n\n#### Using Local Installation\n\nIf you've built from source, use the absolute path to your installation:\n\n**macOS/Linux:**\n\n```json\n{\n    \"mcpServers\": {\n        \"tomba\": {\n            \"command\": \"node\",\n            \"args\": [\"/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js\"],\n            \"env\": {\n                \"TOMBA_API_KEY\": \"your-api-key-here\",\n                \"TOMBA_SECRET_KEY\": \"your-secret-key-here\"\n            }\n        }\n    }\n}\n```\n\n**Windows:**\n\n```json\n{\n    \"mcpServers\": {\n        \"tomba\": {\n            \"command\": \"node\",\n            \"args\": [\n                \"C:\\\\ABSOLUTE\\\\PATH\\\\TO\\\\tomba-mcp-server\\\\server\\\\index.js\"\n            ],\n            \"env\": {\n                \"TOMBA_API_KEY\": \"your-api-key-here\",\n                \"TOMBA_SECRET_KEY\": \"your-secret-key-here\"\n            }\n        }\n    }\n}\n```\n\n**Important Notes:**\n\n- Replace `your-api-key-here` and `your-secret-key-here` with your actual Tomba API credentials\n- For local installation, replace `/ABSOLUTE/PATH/TO/tomba-mcp-server` with the full path to your installation directory\n- Restart Claude Desktop after updating the configuration\n\n### Getting Tomba API Credentials\n\n1. Visit [https://tomba.io](https://tomba.io)\n2. Sign up for an account or log in\n3. Navigate to your dashboard\n4. Go to API settings\n5. Copy your API Key and Secret Key\n\n### Alternative: Using HTTP Transport\n\nFor HTTP transport with npx:\n\n```json\n{\n    \"mcpServers\": {\n        \"tomba\": {\n            \"command\": \"npx\",\n            \"args\": [\n                \"-y\",\n                \"tomba-mcp-server\",\n                \"--transport\",\n                \"http\",\n                \"--port\",\n                \"3000\"\n            ],\n            \"env\": {\n                \"TOMBA_API_KEY\": \"your-api-key-here\",\n                \"TOMBA_SECRET_KEY\": \"your-secret-key-here\"\n            }\n        }\n    }\n}\n```\n\nFor HTTP transport with local installation:\n\n```json\n{\n    \"mcpServers\": {\n        \"tomba\": {\n            \"command\": \"node\",\n            \"args\": [\n                \"/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js\",\n                \"--transport\",\n                \"http\",\n                \"--port\",\n                \"3000\"\n            ],\n            \"env\": {\n                \"TOMBA_API_KEY\": \"your-api-key-here\",\n                \"TOMBA_SECRET_KEY\": \"your-secret-key-here\"\n            }\n        }\n    }\n}\n```\n\n## Usage\n\n### Command-line Options\n\n```bash\nUsage: tomba-mcp-server [options]\n\nOptions:\n  --transport \u003ctype\u003e    Transport type: 'stdio' or 'http' (default: stdio)\n  --port \u003cnumber\u003e       Port number for HTTP transport (default: 3000)\n  --help                Show help message\n\nEnvironment Variables:\n  TOMBA_API_KEY         Your Tomba API key (required)\n  TOMBA_SECRET_KEY      Your Tomba secret key (required)\n\nExamples:\n  # Run with stdio transport (default)\n  node server/index.js\n\n  # Run with HTTP transport on default port (3000)\n  node server/index.js --transport http\n\n  # Run with HTTP transport on custom port\n  node server/index.js --transport http --port 8080\n```\n\n### Standalone HTTP Server\n\nYou can also run the server as a standalone HTTP service:\n\n```bash\nexport TOMBA_API_KEY=\"your-api-key\"\nexport TOMBA_SECRET_KEY=\"your-secret-key\"\nnode server/index.js --transport http --port 3000\n```\n\n#### HTTP API Endpoints\n\n- **POST /mcp** - Send JSON-RPC requests\n- **GET /mcp** - Server-Sent Events for notifications (requires X-Session-Id header)\n- **DELETE /mcp** - Terminate a session (requires X-Session-Id header)\n- **GET /health** - Health check endpoint\n- **GET /sessions** - List active sessions (requires authentication)\n\n#### Example HTTP Request\n\n```bash\ncurl -X POST http://localhost:3000/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"email_finder\",\n      \"arguments\": {\n        \"domain\": \"stripe.com\",\n        \"firstName\": \"Patrick\",\n        \"lastName\": \"Collison\"\n      }\n    },\n    \"id\": 1\n  }'\n```\n\n## 🔧 Development\n\n### Development Commands\n\n```bash\n# Run in development mode\nyarn dev\n\n# Build the project\nyarn build\n\n# Run tests\nyarn test\n\n# Run tests in watch mode\nyarn test:watch\n\n# Run tests with coverage\nyarn test:coverage\n\n# Lint code\nyarn lint\n\n# Fix linting errors\nyarn lint:fix\n```\n\n## 🔍 Debugging \u0026 Testing\n\n### MCP Inspector (Recommended)\n\nThe easiest way to test and debug your MCP server:\n\n```bash\n# Build and launch MCP Inspector\nyarn debug\n```\n\nThis opens a web interface where you can:\n\n- 📋 View all available tools\n- 🧪 Test tools interactively\n- 📊 Inspect requests/responses\n- 🐛 Debug in real-time\n\n### Alternative Debug Methods\n\n```bash\n# Debug TypeScript directly\nyarn debug:dev\n\n# Run integration tests\nyarn test:integration\n\n# Manual testing\nyarn build\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | node server/index.js\n```\n\n### VS Code Debugging\n\nIf using VS Code, use the included debug configurations:\n\n- **Debug MCP Server**: Debug the compiled JavaScript\n- **Debug TypeScript**: Debug TypeScript source directly\n- **Debug with Inspector**: Debug with MCP Inspector\n- **Run Tests**: Debug Jest tests\n\nSee `DEBUG_GUIDE.md` for comprehensive debugging instructions.\n\n## 🧪 Testing Individual Tools\n\n### 1. Domain Search\n\nSearch for email addresses associated with a domain name.\n\n```json\n{\n    \"name\": \"domain_search\",\n    \"arguments\": {\n        \"domain\": \"tomba.io\",\n        \"limit\": 10,\n        \"page\": 1\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n  \"data\": {\n    \"organization\": {\n      \"website_url\": \"tomba.io\",\n      \"organization\": \"Tomba technology web service LLC\",\n      \"location\": {\n        \"country\": \"US\",\n        \"city\": \"Claymont\",\n        \"state\": \"Delaware\",\n        \"street_address\": \"1228 claymont\",\n        \"postal_code\": \"19703\"\n      },\n      \"social_links\": {\n        \"twitter_url\": \"https://twitter.com/tombaplatforum\",\n        \"facebook_url\": \"https://www.facebook.com/tombaplatforum\",\n        \"linkedin_url\": \"https://www.linkedin.com/company/tomba-io\"\n      },\n      \"disposable\": false,\n      \"webmail\": false,\n      \"phone_number\": \"(850) 790-5575\",\n      \"industries\": \"Information Technology and Services\",\n      \"founded\": \"2021\",\n      \"company_size\": \"1-10\",\n      \"company_type\": \"privately held\",\n      \"revenue\": \"$0-$1M\",\n      \"accept_all\": false,\n      \"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.\",\n      \"pattern\": \"{l}.{first}\",\n      \"total_similar\": 35,\n      \"keywords\": [\n        \"lead generation software\"\n      ],\n      \"ranking\": 661495,\n      \"whois\": {\n        \"registrar_name\": \"namecheap, inc.\",\n        \"created_date\": \"2020-07-07T20:54:07+02:00\",\n        \"referral_url\": \"https://www.namecheap.com/\"\n      },\n      \"last_updated\": \"2025-09-06T00:22:01+02:00\"\n    },\n    \"emails\": [\n      {\n        \"email\": \"b.mohamed@tomba.io\",\n        \"first_name\": \"Mohamed\",\n        \"last_name\": \"Ben rebia\",\n        \"full_name\": \"Mohamed Ben rebia\",\n        \"gender\": \"male\",\n        \"phone_number\": false,\n        \"type\": \"personal\",\n        \"country\": \"DZ\",\n        \"position\": \"CEO\",\n        \"department\": \"executive\",\n        \"seniority\": \"senior\",\n        \"twitter\": null,\n        \"linkedin\": \"https://www.linkedin.com/in/mohamed-ben-rebia\",\n        \"score\": 100,\n        \"verification\": {\n          \"date\": \"2025-09-22T00:00:00+02:00\",\n          \"status\": \"valid\"\n        },\n        \"sources\": [\n          {\n            \"uri\": \"https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts\",\n            \"website_url\": \"github.com\",\n            \"extracted_on\": \"2021-02-08T20:09:54+01:00\",\n            \"last_seen_on\": \"2021-02-08T22:43:40+01:00\",\n            \"still_on_page\": true\n          },\n          ....\n        ]\n      },\n      ...\n      ...\n      ...\n      ...\n      ...\n    ]\n  },\n  \"meta\": {\n    \"total\": 21,\n    \"pageSize\": 10,\n    \"current\": 1,\n    \"total_pages\": 3,\n    \"params\": {\n      \"domain\": \"tomba.io\",\n      \"page\": 1,\n      \"limit\": 10,\n      \"department\": null,\n      \"country\": null,\n      \"type\": \"all\",\n      \"live\": false\n    }\n  }\n}\n```\n\n### 2. Email Finder\n\nGenerate likely email addresses from domain, first name, and last name.\n\n```json\n{\n    \"name\": \"email_finder\",\n    \"arguments\": {\n        \"domain\": \"example.com\",\n        \"firstName\": \"John\",\n        \"lastName\": \"Doe\"\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n    \"data\": {\n        \"email\": \"b.mohamed@tomba.io\",\n        \"first_name\": \"Mohamed\",\n        \"last_name\": \"Ben rebia\",\n        \"full_name\": \"Mohamed Ben rebia\",\n        \"website_url\": \"tomba.io\",\n        \"company\": \"Tomba technology web service LLC\",\n        \"position\": \"CEO\",\n        \"country\": \"DZ\",\n        \"gender\": \"male\",\n        \"twitter\": null,\n        \"linkedin\": \"https://www.linkedin.com/in/mohamed-ben-rebia\",\n        \"score\": 100,\n        \"accept_all\": null,\n        \"phone_number\": false,\n        \"verification\": {\n            \"date\": \"2025-09-22T00:00:00+02:00\",\n            \"status\": \"valid\"\n        },\n        \"sources\": [\n            {\n                \"uri\": \"https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts\",\n                \"website_url\": \"github.com\",\n                \"extracted_on\": \"2021-02-08T20:09:54+01:00\",\n                \"last_seen_on\": \"2021-02-08T22:43:40+01:00\",\n                \"still_on_page\": true\n            }\n        ]\n    }\n}\n```\n\n### 3. Email Verifier\n\nVerify email address deliverability and check database presence.\n\n```json\n{\n    \"name\": \"email_verifier\",\n    \"arguments\": {\n        \"email\": \"b.mohamed@tomba.io\"\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n    \"data\": {\n        \"email\": {\n            \"email\": \"b.mohamed@tomba.io\",\n            \"result\": \"deliverable\",\n            \"status\": \"valid\",\n            \"score\": 99,\n            \"smtp_provider\": \"Google Workspace\",\n            \"mx\": {\n                \"records\": [\n                    \"aspmx.l.google.com\",\n                    \"alt2.aspmx.l.google.com\",\n                    \"alt1.aspmx.l.google.com\",\n                    \"alt4.aspmx.l.google.com\",\n                    \"alt3.aspmx.l.google.com\"\n                ]\n            },\n            \"mx_check\": true,\n            \"smtp_server\": true,\n            \"smtp_check\": true,\n            \"accept_all\": false,\n            \"greylisted\": false,\n            \"block\": true,\n            \"gibberish\": false,\n            \"disposable\": false,\n            \"webmail\": false,\n            \"regex\": true,\n            \"whois\": {\n                \"registrar_name\": \"namecheap, inc.\",\n                \"referral_url\": \"https://www.namecheap.com/\",\n                \"created_date\": \"2020-07-07T20:54:07+02:00\"\n            }\n        },\n        \"sources\": [\n            {\n                \"uri\": \"https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts\",\n                \"website_url\": \"github.com\",\n                \"extracted_on\": \"2021-02-08T20:09:54+01:00\",\n                \"last_seen_on\": \"2021-02-08T22:43:40+01:00\",\n                \"still_on_page\": true\n            }\n        ]\n    }\n}\n```\n\n### 4. Email Enrichment\n\nEnrich an email address with additional contact information.\n\n```json\n{\n    \"name\": \"email_enrichment\",\n    \"arguments\": {\n        \"email\": \"b.mohamed@tomba.io\"\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n    \"data\": {\n        \"email\": \"b.mohamed@tomba.io\",\n        \"first_name\": \"Mohamed\",\n        \"last_name\": \"Ben rebia\",\n        \"full_name\": \"Mohamed Ben rebia\",\n        \"website_url\": \"tomba.io\",\n        \"company\": \"Tomba technology web service LLC\",\n        \"position\": \"CEO\",\n        \"country\": \"DZ\",\n        \"gender\": \"male\",\n        \"twitter\": null,\n        \"linkedin\": \"https://www.linkedin.com/in/mohamed-ben-rebia\",\n        \"score\": 100,\n        \"accept_all\": null,\n        \"phone_number\": false,\n        \"verification\": {\n            \"date\": \"2025-09-22T00:00:00+02:00\",\n            \"status\": \"valid\"\n        },\n        \"sources\": [\n            {\n                \"uri\": \"https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts\",\n                \"website_url\": \"github.com\",\n                \"extracted_on\": \"2021-02-08T20:09:54+01:00\",\n                \"last_seen_on\": \"2021-02-08T22:43:40+01:00\",\n                \"still_on_page\": true\n            }\n        ]\n    }\n}\n```\n\n### 5. Author Finder\n\nFind email addresses of article authors from a URL.\n\n```json\n{\n    \"name\": \"author_finder\",\n    \"arguments\": {\n        \"url\": \"https://example.com/article\"\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n    \"data\": {\n        \"email\": \"b.mohamed@tomba.io\",\n        \"first_name\": \"Mohamed\",\n        \"last_name\": \"Ben rebia\",\n        \"full_name\": \"Mohamed Ben rebia\",\n        \"website_url\": \"tomba.io\",\n        \"company\": \"Tomba technology web service LLC\",\n        \"position\": \"CEO\",\n        \"country\": \"DZ\",\n        \"gender\": \"male\",\n        \"twitter\": null,\n        \"linkedin\": \"https://www.linkedin.com/in/mohamed-ben-rebia\",\n        \"score\": 100,\n        \"accept_all\": null,\n        \"phone_number\": false,\n        \"verification\": {\n            \"date\": \"2025-09-22T00:00:00+02:00\",\n            \"status\": \"valid\"\n        },\n        \"sources\": [\n            {\n                \"uri\": \"https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts\",\n                \"website_url\": \"github.com\",\n                \"extracted_on\": \"2021-02-08T20:09:54+01:00\",\n                \"last_seen_on\": \"2021-02-08T22:43:40+01:00\",\n                \"still_on_page\": true\n            }\n        ]\n    }\n}\n```\n\n### 6. LinkedIn Finder\n\nFind email addresses from LinkedIn profile URLs.\n\n```json\n{\n    \"name\": \"linkedin_finder\",\n    \"arguments\": {\n        \"url\": \"https://linkedin.com/in/johndoe\"\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n    \"data\": {\n        \"email\": \"b.mohamed@tomba.io\",\n        \"first_name\": \"Mohamed\",\n        \"last_name\": \"Ben rebia\",\n        \"full_name\": \"Mohamed Ben rebia\",\n        \"website_url\": \"tomba.io\",\n        \"company\": \"Tomba technology web service LLC\",\n        \"position\": \"CEO\",\n        \"country\": \"DZ\",\n        \"gender\": \"male\",\n        \"twitter\": null,\n        \"linkedin\": \"https://www.linkedin.com/in/mohamed-ben-rebia\",\n        \"score\": 100,\n        \"accept_all\": null,\n        \"phone_number\": false,\n        \"verification\": {\n            \"date\": \"2025-09-22T00:00:00+02:00\",\n            \"status\": \"valid\"\n        },\n        \"sources\": [\n            {\n                \"uri\": \"https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts\",\n                \"website_url\": \"github.com\",\n                \"extracted_on\": \"2021-02-08T20:09:54+01:00\",\n                \"last_seen_on\": \"2021-02-08T22:43:40+01:00\",\n                \"still_on_page\": true\n            }\n        ]\n    }\n}\n```\n\n### 7. Phone Finder\n\nSearch for phone numbers based on email, domain, or LinkedIn profile.\n\n```json\n{\n    \"name\": \"phone_finder\",\n    \"arguments\": {\n        \"domain\": \"tomba.io\"\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n    \"data\": {\n        \"domain\": \"tomba.io\",\n        \"valid\": true,\n        \"local_format\": \"(850) 790-5575\",\n        \"intl_format\": \"+1 850-790-5575\",\n        \"e164_format\": \"+18507905575\",\n        \"rfc3966_format\": \"tel:+1-850-790-5575\",\n        \"country_code\": \"US\",\n        \"line_type\": \"FIXED_LINE_OR_MOBILE\",\n        \"carrier\": \"\",\n        \"timezones\": [\"America/New_York\"]\n    }\n}\n```\n\n### 8. Phone Validator\n\nValidate phone numbers and check carrier information.\n\n```json\n{\n    \"name\": \"phone_validator\",\n    \"arguments\": {\n        \"phone\": \"+213667945402\"\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n    \"data\": {\n        \"valid\": true,\n        \"local_format\": \"0667 94 54 02\",\n        \"intl_format\": \"+213 667 94 54 02\",\n        \"e164_format\": \"+213667945402\",\n        \"rfc3966_format\": \"tel:+213-667-94-54-02\",\n        \"country_code\": \"DZ\",\n        \"line_type\": \"MOBILE\",\n        \"carrier\": \"Mobilis\",\n        \"timezones\": [\"Europe/Paris\"]\n    }\n}\n```\n\n### 9. Email Count\n\nGet the total number of email addresses for a domain.\n\n```json\n{\n    \"name\": \"email_count\",\n    \"arguments\": {\n        \"domain\": \"tomba.io\"\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n    \"domain\": \"tomba.io\",\n    \"total\": 245,\n    \"personalEmails\": 198,\n    \"genericEmails\": 47,\n    \"department\": {\n        \"engineering\": 45,\n        \"sales\": 38,\n        \"marketing\": 32,\n        \"hr\": 15,\n        \"finance\": 12,\n        \"legal\": 8,\n        \"executive\": 25,\n        \"support\": 28,\n        \"other\": 42\n    },\n    \"seniority\": {\n        \"junior\": 89,\n        \"senior\": 125,\n        \"executive\": 31\n    },\n    \"source\": \"tomba_email_count\"\n}\n```\n\n### 10. Similar Finder\n\nFind similar domains based on a specific domain.\n\n```json\n{\n    \"name\": \"similar_finder\",\n    \"arguments\": {\n        \"domain\": \"tomba.io\"\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n    \"data\": [\n        {\n            \"website_url\": \"summit.com\",\n            \"name\": \"Summit\",\n            \"industries\": \"Wholesale\"\n        },\n        {\n            \"website_url\": \"hunter.io\",\n            \"name\": \"Hunter\",\n            \"industries\": \"Information Technology and Services\"\n        },\n        {\n            \"website_url\": \"voilaNorbert.com\",\n            \"name\": \"VoilaNorbert\",\n            \"industries\": \"Information Technology and Services\"\n        }\n    ]\n}\n```\n\n### 11. Technology Finder\n\nInstantly reveal the technology stack of any website.\n\n```json\n{\n    \"name\": \"technology_finder\",\n    \"arguments\": {\n        \"domain\": \"tomba.io\"\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n    \"domain\": \"tomba.io\",\n    \"data\": [\n        {\n            \"slug\": \"intercom\",\n            \"name\": \"Intercom\",\n            \"icon\": \"Intercom.png\",\n            \"website\": \"https://www.intercom.com\",\n            \"categories\": {\n                \"id\": 10,\n                \"slug\": \"analytics\",\n                \"name\": \"Analytics\"\n            }\n        }\n    ]\n}\n```\n\n### 12. Companies Search\n\nSearch for companies using natural language queries with advanced filters including location, industry, size, and revenue.\n\n```json\n{\n    \"name\": \"companies_search\",\n    \"arguments\": {\n        \"filters\": {\n            \"location_city\": {\n                \"include\": [\"san francisco\"]\n            },\n            \"industry\": {\n                \"include\": [\"technology\"]\n            },\n            \"size\": {\n                \"include\": [\"51-200\", \"201-500\"]\n            }\n        },\n        \"page\": 1,\n        \"limit\": 10\n    }\n}\n```\n\n**Response:**\n\n```json\n{\n    \"data\": {\n        \"companies\": [\n            {\n                \"name\": \"Tech Company Inc\",\n                \"domain\": \"techcompany.com\",\n                \"industry\": \"Technology\",\n                \"location\": {\n                    \"city\": \"San Francisco\",\n                    \"state\": \"California\",\n                    \"country\": \"United States\"\n                },\n                \"size\": \"51-200\",\n                \"revenue\": \"$10M-$50M\"\n            }\n        ],\n        \"total\": 150,\n        \"page\": 1\n    }\n}\n```\n\n**Available Filters:**\n\n- `location_city`: Filter by city with include/exclude arrays\n- `location_state`: Filter by state with include/exclude arrays\n- `location_country`: Filter by country with include/exclude arrays\n- `industry`: Filter by industry (based on LinkedIn Industry Codes V2 - 140+ industries)\n- `type`: Filter by company type: `education`, `government`, `nonprofit`, `private`, `public`, `personal`\n- `size`: Filter by company size: `1-10`, `11-50`, `51-250`, `251-1K`, `1K-5K`, `5K-10K`, `10K-50K`, `50K-100K`, `100K+`\n- `revenue`: Filter by revenue range: `$0-$1M`, `$1M-$10M`, `$10M-$50M`, `$50M-$100M`, `$100M-$250M`, `$250M-$500M`, `$500M-$1B`, `$1B-$10B`, `$10B+`\n- `founded`: Filter by founding year with include/exclude arrays\n- `keywords`: Filter by keywords with include/exclude arrays\n- `sic`: Filter by SIC codes with include/exclude arrays\n- `naics`: Filter by NAICS codes with include/exclude arrays\n- `similar`: Filter by similar domains with include/exclude arrays\n\n## Rate Limiting \u0026 Usage\n\n### API Rate Limits\n\nTomba.io implements rate limiting based on your subscription plan:\n\n- **Free Plan**: 50 requests per month\n- **Growth Plan**: 5,000 requests per month + 10,000 verifications requests\n- **Pro Plan**: 10,000 requests per month\n- **Enterprise Plan**: 50,000 requests per month\n- **Custom Plan**: Custom limits\n\nLearn more about [Tomba Pricing Plans](https://tomba.io/pricing).\n\n### Rate Limit Headers\n\nEach API response includes rate limit information:\n\n```\nX-RateLimit-Limit: 1000\nX-RateLimit-Remaining: 999\nX-RateLimit-Reset: 1609459200\n```\n\nLearn more about [Tomba API Rate Limits](https://docs.tomba.io/rate-limits).\n\n### Handling Rate Limits\n\nWhen you exceed your rate limit, the API returns a `429 Too Many Requests` status with:\n\n```json\n{\n    \"error\": {\n        \"type\": \"rate_limit\",\n        \"message\": \"Rate limit exceeded. Please try again in 60 seconds\",\n        \"code\": 429\n    }\n}\n```\n\n### Best Practices\n\n1. **Monitor Usage**: Check your dashboard at [tomba.io/dashboard](https://app.tomba.io/dashboard)\n2. **Implement Backoff**: Handle 429 responses with exponential backoff\n3. **Batch Operations**: Use domain search for multiple emails from the same domain\n4. **Cache Results**: Store results locally to avoid duplicate requests\n5. **Plan Accordingly**: Upgrade your plan based on usage patterns\n\n### Usage Tips\n\n- Domain search returns multiple emails per request (more efficient than individual lookups)\n- Email verification consumes credits only for valid email formats\n- Phone finder may return multiple numbers per request\n- Enrichment provides comprehensive data in a single request\n\n## Troubleshooting\n\n### Server Not Starting in Claude Desktop\n\n1. **Check Node.js version**: Ensure you have Node.js 18 or higher\n\n    ```bash\n    node --version\n    ```\n\n2. **Using NPX:**\n    - Ensure you have a stable internet connection for the first run\n    - The `-y` flag should auto-accept the installation\n    - NPX will cache the package after first use\n\n3. **Using Local Installation:**\n    - Verify absolute path is correct in your config\n    - Ensure `server/index.js` exists: `ls -la server/index.js`\n    - Make sure you ran `yarn build` successfully\n\n4. **Verify API credentials**: Ensure your Tomba API keys are correct\n\n5. **Check Claude logs**:\n    - macOS: `~/Library/Logs/Claude/mcp*.log`\n    - Windows: `%APPDATA%\\Claude\\logs\\mcp*.log`\n\n### NPX-Specific Issues\n\n**\"npx command not found\":**\n\n- Ensure npm is installed: `npm --version`\n- NPX comes with npm 5.2.0+, update if needed: `npm install -g npm`\n\n**Package not found:**\n\n- Verify the package is published: `npm view tomba-mcp-server`\n- Try clearing npm cache: `npm cache clean --force`\n\n**Always downloading package:**\n\n- This is normal behavior with `-y` flag\n- NPX caches the package after first download\n- For a permanent installation, use local installation method\n\n### Authentication Errors\n\n- Verify your API keys at [https://app.tomba.io/dashboard](https://app.tomba.io/dashboard)\n- Ensure environment variables are properly set in the config\n- Check that your API subscription is active\n\n### Tools Not Responding\n\n- Check your Tomba API rate limits\n- Verify network connectivity\n- Review server logs for error messages\n\n## About Tomba\n\nFounded 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.\n\n[![image](https://avatars.githubusercontent.com/u/67979591?s=200\u0026v=4)](https://tomba.io/)\n\n## Contributing\n\n1. Fork it (\u003chttps://github.com/tomba-io/tomba-mcp-server/fork\u003e)\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create a new Pull Request\n\n## License\n\nPlease see the [License](LICENSE) file for more information.\n\n## Support\n\n- [GitHub Issues](https://github.com/tomba-io/tomba-mcp-server/issues)\n- [Email Support](mailto:support@tomba.io)\n- [Website](https://tomba.io)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomba-io%2Ftomba-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomba-io%2Ftomba-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomba-io%2Ftomba-mcp-server/lists"}