Tomba MCP

chính thức

Tomba, công cụ tìm kiếm và xác minh email B2B độc đáo của bạn, cung cấp cơ sở dữ liệu khách hàng tiềm năng đặc biệt để mở rộng tiếp cận một cách dễ dàng và hiệu quả.

GitHub

Dùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Tomba MCP?

Tìm địa chỉ email cho một tên miền — Yêu cầu tất cả các liên hệ tại một công ty qua domain_search, với các bộ lọc như phòng ban hoặc quốc gia.
Tạo email cho một người — Sử dụng email_finder để xây dựng một địa chỉ có khả năng khớp từ tên và tên miền, sau đó xác minh nó.
Xác minh khả năng gửi email — Kiểm tra xem một địa chỉ có hợp lệ và an toàn để gửi thư hay không bằng email_verifier.
Làm phong phú hồ sơ liên hệ — Lấy chức danh công việc, công ty và các liên kết mạng xã hội cho một email bằng email_enrichment.
Khám phá công nghệ của công ty — Xác định các công cụ và nền tảng mà một trang web sử dụng qua technology_finder.
Tìm các công ty tương tự — Sử dụng similar_finder để định vị các tên miền tương đương cho việc tìm kiếm khách hàng tiềm năng hoặc phân tích.

Tài liệu

Máy chủ MCP Tomba.io

Máy chủ Giao thức Ngữ cảnh Mô hình (MCP) để tích hợp với API Tomba.io. Máy chủ này cung cấp các khả năng khám phá, xác minh và làm phong phú email toàn diện thông qua giao diện MCP tiêu chuẩn.

Tính năng

Công cụ (28 công cụ có sẵn)

Khám phá Email

Tìm kiếm theo tên miền: Tìm tất cả địa chỉ email liên kết với một tên miền
Trình tìm email: Tạo địa chỉ email có khả năng từ tên và tên miền
Trình tìm tác giả: Khám phá địa chỉ email của tác giả bài viết
Trình tìm LinkedIn: Tìm email từ URL hồ sơ LinkedIn
Số lượng email: Lấy tổng số email cho các tên miền
Nguồn email: Tìm nơi địa chỉ email được tìm thấy trên web
Định dạng email: Lấy các mẫu định dạng email được sử dụng bởi một tên miền

Xác minh

Trình xác minh email: Xác minh khả năng gửi email và kiểm tra sự hiện diện trong cơ sở dữ liệu

Làm phong phú

Làm phong phú email: Làm phong phú email với dữ liệu liên hệ bổ sung
Làm phong phú cá nhân: Tìm dữ liệu cá nhân theo email (tên, chức vụ, hồ sơ mạng xã hội)
Làm phong phú công ty: Tìm dữ liệu công ty theo tên miền (ngành, quy mô, vị trí)
Làm phong phú kết hợp: Làm phong phú kết hợp cá nhân + công ty theo email

Điện thoại

Trình tìm số điện thoại: Tìm kiếm số điện thoại theo email, tên miền hoặc LinkedIn
Trình xác thực số điện thoại: Xác thực số điện thoại và kiểm tra thông tin nhà mạng

Thông tin tên miền

Trạng thái tên miền: Kiểm tra xem tên miền có phải là webmail hoặc dùng một lần không
Tự động hoàn thành: Gợi ý tên công ty với logo và thông tin tên miền
Trình tìm tương tự: Tìm các tên miền tương tự dựa trên tên miền mục tiêu
Trình tìm công nghệ: Khám phá các công nghệ được sử dụng bởi các trang web
Vị trí: Lấy số lượng nhân viên theo quốc gia

Tìm kiếm công ty

Tìm kiếm công ty: Tìm kiếm công ty bằng truy vấn ngôn ngữ tự nhiên với bộ lọc nâng cao

Tài khoản & Quản lý

Thông tin tài khoản: Lấy thông tin tài khoản hiện tại, gói và tín dụng
Thông tin sử dụng: Lấy thống kê sử dụng API trên tất cả các điểm cuối
Danh sách cờ: Liệt kê các cờ dữ liệu đã gửi với trạng thái và hoàn tiền tín dụng
Tạo cờ: Báo cáo dữ liệu không chính xác (email bị trả lại cứng, email không hợp lệ) để thu hồi tín dụng
Danh sách khách hàng tiềm năng: Liệt kê khách hàng tiềm năng với bộ lọc tên miền tùy chọn
Tạo khách hàng tiềm năng: Thêm khách hàng tiềm năng mới vào danh sách
Danh sách khóa: Liệt kê các khóa API
Lấy nhật ký: Lấy nhật ký yêu cầu API gần đây

Tài nguyên (7 tài nguyên có sẵn)

tomba://api/status - Trạng thái API và thông tin tài khoản
tomba://domain/{domain} - Thông tin tên miền
tomba://email/{email} - Thông tin email
tomba://similar/{domain} - Phân tích tên miền tương tự
tomba://technology/{domain} - Thông tin công nghệ
tomba://docs/api - Tài liệu API
tomba://docs/tools - Tài liệu công cụ

Lời nhắc (16 quy trình làm việc được xây dựng sẵn)

find_contact - Tìm thông tin liên hệ đầy đủ cho một người
verify_email_list - Xác minh hàng loạt địa chỉ email
research_company - Nghiên cứu liên hệ và cấu trúc công ty
enrich_lead - Làm phong phú khách hàng tiềm năng với tất cả dữ liệu có sẵn
find_journalists - Tìm liên hệ nhà báo từ các bài viết
phone_finder - Tìm số điện thoại cho các liên hệ
validate_phone - Xác thực số điện thoại
competitor_analysis - Phân tích đối thủ cạnh tranh bằng tên miền và công nghệ tương tự
technology_audit - Kiểm tra công nghệ toàn diện của một trang web
domain_insights - Lấy thông tin chi tiết toàn diện về một tên miền bao gồm số lượng email và công nghệ
bulk_domain_research - Nghiên cứu nhiều tên miền để lấy số lượng email và thông tin cơ bản
find_target_companies - Tìm công ty với bộ lọc nâng cao (quy mô, loại hình, doanh thu, ngành)
market_research - Nghiên cứu công ty trong phân khúc thị trường với bộ lọc toàn diện
lead_generation - Tạo khách hàng tiềm năng bằng cách tìm công ty và liên hệ của họ
prospect_enrichment - Làm phong phú khách hàng tiềm năng của công ty với dữ liệu toàn diện
industry_analysis - Phân tích công ty trong một ngành với phân khúc chi tiết

Tùy chọn bộ lọc cho lời nhắc tìm kiếm công ty

Bộ lọc	Giá trị có sẵn
Quy mô	1-10 (Siêu nhỏ), 11-50 (Nhỏ), 51-250 (Vừa), 251-1K (Trung bình-lớn), 1K-5K (Lớn), 5K-10K (Rất lớn), 10K-50K (Doanh nghiệp), 50K-100K (Khổng lồ), 100K+ (Toàn cầu)
Loại hình	giáo dục, chính phủ, phi lợi nhuận, tư nhân, công cộng, cá nhân
Doanh thu	$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
Ngành	Dựa trên Mã ngành LinkedIn V2 (hơn 140 ngành bao gồm Phần mềm máy tính, Dịch vụ tài chính, Bệnh viện & Chăm sóc sức khỏe, v.v.)

Hiệu suất & Độ tin cậy

Thời gian chờ

Tất cả các lệnh gọi API có thời gian chờ 120 giây. Các tìm kiếm Tomba chạy theo thời gian thực trên cơ sở hạ tầng trực tiếp — thời gian phản hồi thay đổi theo tốc độ máy chủ SMTP của công ty mục tiêu, khả năng phản hồi của trang web và độ sâu của phát hiện catch-all.

Thử lại với Backoff theo cấp số nhân

Tất cả các lệnh gọi API tự động thử lại tối đa 3 lần với backoff theo cấp số nhân khi:

429 Too Many Requests (vượt quá giới hạn tốc độ)
5xx lỗi máy chủ

Độ trễ thử lại: 1s → 2s → 4s.

Giới hạn tốc độ

Giới hạn tốc độ được áp dụng theo từng điểm cuối và từng gói:

Gói	Mỗi giây	Mỗi phút	Mỗi ngày
Miễn phí	1	2	5
Cơ bản	3	50	500
Tăng trưởng	5	80	1.000
Chuyên nghiệp	8	150	4.000
Gói 50.000+	Không giới hạn	Không giới hạn	Không giới hạn

Không tính phí tín dụng khi Tomba không thể cung cấp kết quả. Các yêu cầu trùng lặp trong vòng 30 ngày không bị tính lại.

Tùy chọn truyền tải

stdio - Đầu vào/đầu ra tiêu chuẩn (mặc định, cho Claude Desktop)
http - Máy chủ HTTP với các điểm cuối REST

Cài đặt

Điều kiện tiên quyết

Node.js 18 trở lên
npm hoặc yarn
Tài khoản API Tomba (Đăng ký tại đây)

Ảnh chụp màn hình

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Lưu ý: Gói npm đã được đổi tên từ tomba-mcp-server thành @tomba-io/tomba-mcp-server. Vui lòng cập nhật cấu hình của bạn cho phù hợp.

Tùy chọn 1: Cài đặt qua NPX (Khuyến nghị)

Cách dễ nhất để sử dụng máy chủ MCP Tomba là qua npx, không cần sao chép kho lưu trữ:

macOS/Linux

Thêm vào claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json) của bạn:

{
    "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

Thêm vào claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json) của bạn:

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

Lưu ý: Cờ -y tự động chấp nhận lời nhắc cài đặt và npx sẽ luôn tìm nạp phiên bản mới nhất.

Tùy chọn 2: Cài đặt từ mã nguồn

Nếu bạn muốn sửa đổi máy chủ hoặc đóng góp cho quá trình phát triển:

# 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

Cấu hình

Kỹ năng OpenClaw

Kho lưu trữ này hiện bao gồm kỹ năng OpenClaw cục bộ cho không gian làm việc tại skills/tomba-contact-intelligence/SKILL.md.

Kỹ năng được thiết kế để giúp OpenClaw chọn đúng công cụ MCP Tomba cho quy trình khám phá liên hệ, nghiên cứu công ty, xác minh email, tra cứu điện thoại và làm phong phú khách hàng tiềm năng.

Để sử dụng:

Mở kho lưu trữ này làm không gian làm việc OpenClaw của bạn hoặc sao chép thư mục skills/tomba-contact-intelligence vào thư mục kỹ năng OpenClaw của bạn.
Đảm bảo máy chủ MCP Tomba được cấu hình và khả dụng cho OpenClaw.
Bắt đầu phiên OpenClaw mới để kỹ năng được tải.

Ví dụ lời nhắc:

"Tìm liên hệ tốt nhất cho quan hệ đối tác tại stripe.com và xác minh email trước khi trả về."
"Nghiên cứu các công ty fintech tại Đức, sau đó xác định liên hệ bán hàng tiềm năng cho các kết quả hàng đầu."
"Làm phong phú khách hàng tiềm năng này với email, điện thoại, công nghệ công ty và đối thủ cạnh tranh tương tự: jane@acme.com"

Thiết lập Claude Desktop

Để sử dụng máy chủ này với Claude Desktop, hãy thêm cấu hình vào tệp claude_desktop_config.json của bạn.

Sử dụng NPX (Khuyến nghị)

Phương pháp này tự động sử dụng phiên bản đã phát hành mới nhất:

macOS/Linux (~/Library/Application Support/Claude/claude_desktop_config.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):

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

Sử dụng cài đặt cục bộ

Nếu bạn đã xây dựng từ mã nguồn, hãy sử dụng đường dẫn tuyệt đối đến cài đặt của bạn:

macOS/Linux:

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

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

Lưu ý quan trọng:

Thay thế your-api-key-here và your-secret-key-here bằng thông tin đăng nhập API Tomba thực tế của bạn
Đối với cài đặt cục bộ, thay thế /ABSOLUTE/PATH/TO/tomba-mcp-server bằng đường dẫn đầy đủ đến thư mục cài đặt của bạn
Khởi động lại Claude Desktop sau khi cập nhật cấu hình

Lấy thông tin đăng nhập API Tomba

Truy cập https://tomba.io
Đăng ký tài khoản hoặc đăng nhập
Điều hướng đến bảng điều khiển của bạn
Vào phần cài đặt API
Sao chép Khóa API và Khóa bí mật của bạn

Thay thế: Sử dụng truyền tải HTTP

Đối với truyền tải HTTP với npx:

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

Đối với truyền tải HTTP với cài đặt cục bộ:

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

Cách sử dụng

Tùy chọn dòng lệnh

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

Máy chủ HTTP độc lập

Bạn cũng có thể chạy máy chủ như một dịch vụ HTTP độc lập:

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

Điểm cuối API HTTP

POST /mcp - Gửi yêu cầu JSON-RPC
GET /mcp - Sự kiện do máy chủ gửi cho thông báo (yêu cầu tiêu đề X-Session-Id)
DELETE /mcp - Kết thúc phiên (yêu cầu tiêu đề X-Session-Id)
GET /health - Điểm cuối kiểm tra sức khỏe
GET /sessions - Liệt kê các phiên hoạt động (yêu cầu xác thực)

Ví dụ yêu cầu HTTP

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
  }'

🔧 Phát triển

Lệnh phát triển

# 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

🔍 Gỡ lỗi & Kiểm tra

MCP Inspector (Khuyến nghị)

Cách dễ nhất để kiểm tra và gỡ lỗi máy chủ MCP của bạn:

# Build and launch MCP Inspector
yarn debug

Thao tác này mở giao diện web nơi bạn có thể:

📋 Xem tất cả các công cụ có sẵn
🧪 Kiểm tra công cụ tương tác
📊 Kiểm tra yêu cầu/phản hồi
🐛 Gỡ lỗi theo thời gian thực

Phương pháp gỡ lỗi thay thế

# 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

Gỡ lỗi VS Code

Nếu sử dụng VS Code, hãy sử dụng các cấu hình gỡ lỗi được bao gồm:

Gỡ lỗi máy chủ MCP: Gỡ lỗi JavaScript đã biên dịch
Gỡ lỗi TypeScript: Gỡ lỗi mã nguồn TypeScript trực tiếp
Gỡ lỗi với Inspector: Gỡ lỗi với MCP Inspector
Chạy kiểm tra: Gỡ lỗi kiểm tra Jest

Xem DEBUG_GUIDE.md để biết hướng dẫn gỡ lỗi toàn diện.

🧪 Kiểm tra các công cụ riêng lẻ

1. Tìm kiếm theo tên miền

Tìm kiếm địa chỉ email liên kết với tên miền.

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

Phản hồi:

{
  "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. Trình tìm email

Tạo địa chỉ email có khả năng từ tên miền, tên và họ.

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

Phản hồi:

{
    "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. Trình xác minh email

Xác minh khả năng gửi email và kiểm tra sự hiện diện trong cơ sở dữ liệu.

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

Phản hồi:

{
    "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. Làm phong phú email

Làm phong phú địa chỉ email với thông tin liên hệ bổ sung.

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

Phản hồi:

{
    "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. Trình tìm tác giả

Tìm địa chỉ email của tác giả bài viết từ URL.

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

Phản hồi:

{
    "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. Trình tìm LinkedIn

Tìm địa chỉ email từ URL hồ sơ LinkedIn.

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

Phản hồi:

{
    "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. Trình tìm số điện thoại

Tìm kiếm số điện thoại dựa trên email, tên miền hoặc hồ sơ LinkedIn.

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

Phản hồi:

{
    "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. Trình xác thực số điện thoại

Xác thực số điện thoại và kiểm tra thông tin nhà mạng.

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

Phản hồi:

{
    "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. Số lượng email

Lấy tổng số địa chỉ email cho một tên miền.

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

Phản hồi:

{
    "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. Trình tìm kiếm tương tự

Tìm các tên miền tương tự dựa trên một tên miền cụ thể.

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

Phản hồi:

{
    "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. Trình tìm công nghệ

Tiết lộ ngay lập tức công nghệ của bất kỳ trang web nào.

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

Phản hồi:

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

12. Tìm kiếm công ty

Tìm kiếm công ty bằng các truy vấn ngôn ngữ tự nhiên với các bộ lọc nâng cao bao gồm vị trí, ngành, quy mô và doanh thu.

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

Phản hồi:

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

Bộ lọc có sẵn:

location_city: Lọc theo thành phố với mảng bao gồm/loại trừ
location_state: Lọc theo tiểu bang với mảng bao gồm/loại trừ
location_country: Lọc theo quốc gia với mảng bao gồm/loại trừ
industry: Lọc theo ngành (dựa trên Mã ngành LinkedIn V2 - hơn 140 ngành)
type: Lọc theo loại công ty: education, government, nonprofit, private, public, personal
size: Lọc theo quy mô công ty: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
revenue: Lọc theo phạm vi doanh thu: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
founded: Lọc theo năm thành lập với mảng bao gồm/loại trừ
keywords: Lọc theo từ khóa với mảng bao gồm/loại trừ
sic: Lọc theo mã SIC với mảng bao gồm/loại trừ
naics: Lọc theo mã NAICS với mảng bao gồm/loại trừ
similar: Lọc theo tên miền tương tự với mảng bao gồm/loại trừ

Giới hạn tốc độ & cách sử dụng

Giới hạn tốc độ API

Tomba.io triển khai giới hạn tốc độ dựa trên gói đăng ký của bạn:

Gói miễn phí: 50 yêu cầu mỗi tháng
Gói tăng trưởng: 5.000 yêu cầu mỗi tháng + 10.000 yêu cầu xác minh
Gói Pro: 10.000 yêu cầu mỗi tháng
Gói doanh nghiệp: 50.000 yêu cầu mỗi tháng
Gói tùy chỉnh: Giới hạn tùy chỉnh

Tìm hiểu thêm về Gói giá Tomba.

Tiêu đề giới hạn tốc độ

Mỗi phản hồi API đều bao gồm thông tin giới hạn tốc độ:

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

Tìm hiểu thêm về Giới hạn tốc độ API Tomba.

Xử lý giới hạn tốc độ

Khi bạn vượt quá giới hạn tốc độ, API trả về trạng thái 429 Too Many Requests với:

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

Các phương pháp tốt nhất

Theo dõi mức sử dụng: Kiểm tra bảng điều khiển của bạn tại tomba.io/dashboard
Triển khai backoff: Xử lý phản hồi 429 với backoff theo cấp số nhân
Thao tác hàng loạt: Sử dụng tìm kiếm tên miền cho nhiều email từ cùng một tên miền
Lưu kết quả vào bộ nhớ đệm: Lưu trữ kết quả cục bộ để tránh các yêu cầu trùng lặp
Lên kế hoạch phù hợp: Nâng cấp gói của bạn dựa trên mô hình sử dụng

Mẹo sử dụng

Tìm kiếm tên miền trả về nhiều email mỗi yêu cầu (hiệu quả hơn tra cứu riêng lẻ)
Xác minh email chỉ tiêu tốn tín dụng cho các định dạng email hợp lệ
Trình tìm số điện thoại có thể trả về nhiều số mỗi yêu cầu
Làm phong phú cung cấp dữ liệu toàn diện trong một yêu cầu duy nhất

Xử lý sự cố

Máy chủ không khởi động trong Claude Desktop

Kiểm tra phiên bản Node.js: Đảm bảo bạn có Node.js 18 trở lên
```
node --version
```
Sử dụng NPX:
- Đảm bảo bạn có kết nối internet ổn định cho lần chạy đầu tiên
- Cờ -y sẽ tự động chấp nhận cài đặt
- NPX sẽ lưu vào bộ nhớ đệm gói sau lần sử dụng đầu tiên
Sử dụng cài đặt cục bộ:
- Xác minh đường dẫn tuyệt đối chính xác trong cấu hình của bạn
- Đảm bảo server/index.js tồn tại: ls -la server/index.js
- Đảm bảo bạn đã chạy yarn build thành công
Xác minh thông tin xác thực API: Đảm bảo khóa API Tomba của bạn chính xác
Kiểm tra nhật ký Claude:
- macOS: ~/Library/Logs/Claude/mcp*.log
- Windows: %APPDATA%\Claude\logs\mcp*.log

Các vấn đề cụ thể với NPX

"Không tìm thấy lệnh npx":

Đảm bảo npm được cài đặt: npm --version
NPX đi kèm với npm 5.2.0+, cập nhật nếu cần: npm install -g npm

Không tìm thấy gói:

Xác minh gói đã được xuất bản: npm view @tomba-io/tomba-mcp-server
Thử xóa bộ nhớ đệm npm: npm cache clean --force

Luôn tải xuống gói:

Đây là hành vi bình thường với cờ -y
NPX lưu vào bộ nhớ đệm gói sau lần tải xuống đầu tiên
Để cài đặt vĩnh viễn, hãy sử dụng phương pháp cài đặt cục bộ

Lỗi xác thực

Xác minh khóa API của bạn tại https://app.tomba.io/dashboard
Đảm bảo các biến môi trường được đặt đúng trong cấu hình
Kiểm tra gói đăng ký API của bạn còn hoạt động

Công cụ không phản hồi

Kiểm tra giới hạn tốc độ API Tomba của bạn
Xác minh kết nối mạng
Xem lại nhật ký máy chủ để tìm thông báo lỗi

Về Tomba

Được thành lập vào năm 2020, Tomba tự hào là nguồn dữ liệu địa chỉ email đáng tin cậy, chính xác và chuyên sâu nhất hiện có ở bất kỳ đâu. Chúng tôi xử lý hàng terabyte dữ liệu để tạo ra API tìm email của mình.

Đóng góp

Fork nó (https://github.com/tomba-io/tomba-mcp-server/fork)
Tạo nhánh tính năng của bạn (git checkout -b my-new-feature)
Cam kết các thay đổi của bạn (git commit -am 'Add some feature')
Đẩy lên nhánh (git push origin my-new-feature)
Tạo Yêu cầu kéo mới

Giấy phép

Vui lòng xem tệp Giấy phép để biết thêm thông tin.

Tomba MCP

Bạn có thể làm gì với Tomba MCP?

Tài liệu

Máy chủ MCP Tomba.io

Tính năng

Công cụ (28 công cụ có sẵn)

Khám phá Email

Xác minh

Làm phong phú

Điện thoại

Thông tin tên miền

Tìm kiếm công ty

Tài khoản & Quản lý

Tài nguyên (7 tài nguyên có sẵn)

Lời nhắc (16 quy trình làm việc được xây dựng sẵn)

Tùy chọn bộ lọc cho lời nhắc tìm kiếm công ty

Hiệu suất & Độ tin cậy

Thời gian chờ

Thử lại với Backoff theo cấp số nhân

Giới hạn tốc độ

Tùy chọn truyền tải

Cài đặt

Điều kiện tiên quyết

Ảnh chụp màn hình

Tùy chọn 1: Cài đặt qua NPX (Khuyến nghị)

macOS/Linux

Windows

Tùy chọn 2: Cài đặt từ mã nguồn

Cấu hình

Kỹ năng OpenClaw

Thiết lập Claude Desktop

Sử dụng NPX (Khuyến nghị)

Sử dụng cài đặt cục bộ

Lấy thông tin đăng nhập API Tomba

Thay thế: Sử dụng truyền tải HTTP

Cách sử dụng

Tùy chọn dòng lệnh

Máy chủ HTTP độc lập

Điểm cuối API HTTP

Ví dụ yêu cầu HTTP

🔧 Phát triển

Lệnh phát triển

🔍 Gỡ lỗi & Kiểm tra

MCP Inspector (Khuyến nghị)

Phương pháp gỡ lỗi thay thế

Gỡ lỗi VS Code

🧪 Kiểm tra các công cụ riêng lẻ

1. Tìm kiếm theo tên miền

2. Trình tìm email

3. Trình xác minh email

4. Làm phong phú email

5. Trình tìm tác giả

6. Trình tìm LinkedIn

7. Trình tìm số điện thoại

8. Trình xác thực số điện thoại

9. Số lượng email

10. Trình tìm kiếm tương tự

11. Trình tìm công nghệ

12. Tìm kiếm công ty

Giới hạn tốc độ & cách sử dụng

Giới hạn tốc độ API

Tiêu đề giới hạn tốc độ

Xử lý giới hạn tốc độ

Các phương pháp tốt nhất

Mẹo sử dụng

Xử lý sự cố

Máy chủ không khởi động trong Claude Desktop

Các vấn đề cụ thể với NPX

Lỗi xác thực

Công cụ không phản hồi

Về Tomba

Đóng góp

Giấy phép

Hỗ trợ