Coresignal

Coresignal MCP v2

Máy chủ Model Context Protocol chính thức dành cho Coresignal — mang dữ liệu B2B mới về hơn 895 triệu nhân viên, hơn 70 triệu công ty và hơn 468 triệu tin tuyển dụng thẳng vào trợ lý AI của bạn.

https://mcp.coresignal.com/mcp/v2

Tìm kiếm bằng ngôn ngữ tự nhiên thông thường, kéo hồ sơ đầy đủ, làm giàu danh bạ bằng email đã xác minh và xuất tập kết quả lớn thành các tệp có thể tải xuống — tất cả từ Claude, Cursor, Codex, VS Code hoặc bất kỳ máy khách tương thích MCP nào.

Tính năng

• Xác thực OAuth 2.1 — đăng nhập bằng tài khoản bảng điều khiển Coresignal của bạn; không cần khóa API trong tệp cấu hình.
• Tìm kiếm ngôn ngữ tự nhiên kèm bằng chứng khớp trong từng hàng kết quả, để bạn thấy vì sao mỗi bản ghi khớp.
• Minh bạch chi phí — mọi phản hồi đều báo cáo credits_consumed, và các lệnh gọi tốn kém sẽ yêu cầu xác nhận trước khi tiêu tốn ngân sách.
• Khám phá trường dữ liệu — entity_fields tìm tên trường chính xác theo từ khóa, miễn phí, mà không cần nạp toàn bộ từ vựng 300+ trường vào ngữ cảnh.
• Tải tệp xuống — tập kết quả lớn được lưu phía máy chủ và trả về dưới dạng liên kết tải xuống thay vì làm ngập cuộc trò chuyện.
• artifact_read đưa các trang tệp đã giao trở lại cuộc trò chuyện miễn phí — hoạt động ngay cả trong các máy khách không có quyền truy cập hệ thống tệp.

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

• Tài khoản Coresignal có gói đăng ký (credit) đang hoạt động và khóa API nhóm được cấp trong bảng điều khiển. Máy chủ MCP tự động phân giải khóa của nhóm bạn sau khi đăng nhập — bạn không bao giờ phải dán khóa vào tệp cấu hình. Chưa có gói đăng ký? Bắt đầu với dùng thử miễn phí 7 ngày — bao gồm 2.000 credit. Xem so sánh gói.

Khi kết nối lần đầu, máy khách của bạn mở cửa sổ trình duyệt để đăng nhập vào bảng điều khiển Coresignal. Đó là toàn bộ quá trình thiết lập — không cần biến môi trường, không cần bí mật.

Thiết lập máy khách

claude mcp add --transport http coresignal https://mcp.coresignal.com/mcp/v2

codex mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

{
  "mcpServers": {
    "coresignal": {
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

opencode mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

opencode mcp auth coresignal

{
  "servers": {
    "coresignal": {
      "type": "http",
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

{
  "mcpServers": {
    "coresignal": {
      "type": "streamableHttp",
      "url": "https://mcp.coresignal.com/mcp/v2",
      "disabled": false
    }
  }
}

cline mcp

Tải tệp xuống & danh sách cho phép tên miền

Kết quả lớn (và bất kỳ lệnh gọi nào có delivery="url") không bị đổ vào cuộc trò chuyện để tiết kiệm token đầu vào LLM. Thay vào đó, máy chủ lưu các hàng dữ liệu thành một tệp và trả về liên kết tải xuống HTTPS đã ký hết hạn sau 1 giờ:

{
  "delivery": "url",
  "url": "https://mcp.coresignal.com/mcp/v2/artifacts/…?exp=…&sig=…",
  "artifact_name": "employee_fetch-baf941dd4f8c4dfe.jsonl",
  "count": 500,
  "credits_consumed": 10000
}

Từ đây, tác nhân AI truy cập dữ liệu theo một trong ba cách:

1. Tác nhân tự tải tệp xuống — trong các máy khách có quyền truy cập shell, tác nhân thường sẽ curl liên kết vào đĩa và phân tích tệp cục bộ bằng grep/jq/pandas.
2. Tác nhân đọc lại trong cuộc trò chuyện — trong các máy khách không có shell và không có hệ thống tệp, tác nhân gọi artifact_read(artifact_name, offset, limit) để thay thế, duyệt từng phần tệp theo các lát cắt trong phiên MCP. Việc này miễn phí và hoạt động ở mọi nơi, nên không có gì làm ngập cuộc trò chuyện.
3. Bạn tải xuống thủ công — nếu bản thân tác nhân không được phép truy cập liên kết (tên miền không trong danh sách cho phép, sandbox không có quyền truy cập mạng), hãy nhấp vào liên kết, lưu tệp và cho tác nhân biết vị trí tệp: "Tôi đã tải tệp xuống ~/Downloads/employee_fetch-….jsonl — hãy phân tích từ đó." Hoạt động trong mọi máy khách có thể đọc tệp cục bộ.

Nên ưu tiên tải xuống khi máy khách của bạn hỗ trợ. artifact_read miễn phí về credit Coresignal, nhưng không miễn phí về token LLM: mỗi trang nó trả về đều trở thành một phần của cuộc trò chuyện và bị tính phí lại như token đầu vào ở mỗi lượt tiếp theo. Mỗi trang cũng bị cắt theo ngân sách token cố định — một hồ sơ nhân viên đầy đủ khoảng 8k token, nên một trang chỉ chứa một số ít hồ sơ đầy đủ bất kể limit bạn yêu cầu. Đọc một tệp lớn theo cách đó cần hàng trăm lần gọi và có thể làm cạn cửa sổ ngữ cảnh trước khi bạn đến cuối. Một tệp đã tải xuống gần như không tốn token — trợ lý có thể lọc hàng nghìn hàng cục bộ bằng grep/jq và chỉ đưa ra câu trả lời. Đó là lý do nên thiết lập tải xuống ngay từ đầu (danh sách cho phép tên miền, quyền truy cập mạng sandbox) và dành artifact_read cho các máy khách không thể tải xuống hoặc để xem nhanh vài hàng dữ liệu.

Nếu tải xuống bị chặn, không mất gì cả: các bản ghi đã được lưu trữ và thanh toán — hãy đọc chúng bằng artifact_read. Không bao giờ chạy lại lệnh tải để "khôi phục" một tệp; điều đó sẽ tính phí mỗi bản ghi lần thứ hai.

Công cụ

entity_search

Tìm kiếm employee, company hoặc job bản ghi bằng truy vấn ngôn ngữ thông thường:

"Senior Python developers at fintech companies in French"

Mỗi lần gọi tốn cố định 20 credit và trả về:

• total_count — số lượng chính xác bản ghi mà truy vấn khớp,
• tối đa 20 hàng xem trước (limit=0 chỉ trả về số lượng), mỗi hàng hiển thị các trường mà truy vấn khớp — bằng chứng cho thấy vì sao mỗi kết quả có mặt,
• một cache_id — handle 1 giờ cho tìm kiếm, tiết kiệm credit và thời gian: chuyển nó cho entity_fetch và các bản ghi khớp sẽ được thu thập ngay — không cần chạy lại (và trả phí lại) tìm kiếm, và việc phân giải cache_id tự nó miễn phí. Id bản ghi nằm phía máy chủ, nên không có gì cồng kềnh đi qua cuộc trò chuyện.

entity_fields

Tra cứu tên trường theo ý nghĩa miễn phí, tức thì — "salary" tìm các trường bồi thường, "current job title and seniority" tìm active_experience_title, experience.position_title, v.v. Dùng nó để xây dựng danh sách fields cho lệnh tải theo phạm vi tùy chỉnh mà không cần nạp toàn bộ từ vựng trường vào ngữ cảnh.

entity_fetch

Thu thập bản ghi — hoặc tối đa 20 id được chọn tay từ kết quả tìm kiếm, hoặc tối đa 1.000 bản ghi mỗi lần gọi qua một cache_id. Tính phí theo từng bản ghi tìm thấy: 20 credit cho nhân viên/công ty, 1 cho việc làm.

email_enrich

Email kinh doanh đã xác minh, có thể gửi được cho tối đa 1.000 id nhân viên — 10 credit mỗi email tìm thấy; các id không tìm thấy được miễn phí. Danh bạ EEA/UK không truy cập được (GDPR).

artifact_read

Đọc lại một tệp đã giao qua phiên MCP đã xác thực, từng trang một — miễn phí, vì các bản ghi đã được tính phí khi tải. Đây là điều làm cho việc giao tệp hoạt động ở mọi nơi, kể cả các máy khách trò chuyện không mở được liên kết hoặc không chạm được hệ thống tệp.

Ví dụ lời nhắc

Quét thị trường

"Find B2B SaaS companies in the Nordics with 50–200 employees that raised funding in the last two years."

Xây danh sách khách hàng tiềm năng với email đã xác minh

"Search for heads of data at US companies with 500+ employees. Fetch 20 full profiles to a file with verified emails."

Tìm hiểu sâu một công ty cụ thể**

"Pull the full record for flo.health — funding rounds, headcount growth, and current job openings."

...

Credit & thanh toán

Mọi phản hồi đều bao gồm credits_consumed — số tiền thực tế được tính phí, nên sự chênh lệch (gửi 1.000 id, bị tính phí cho 950 bản ghi) cho bạn biết chính xác bao nhiêu id không được tìm thấy. Máy chủ không bao giờ tiêu tiền âm thầm: các lệnh tải xác nhận phạm vi trường với bạn trước, và một lệnh tải không thể giao sẽ thất bại trước khi tốn bất kỳ credit nào.

Credit được lấy từ gói đăng ký Coresignal của nhóm bạn — quản lý khóa và thanh toán trong bảng điều khiển. Mới dùng Coresignal? Dùng thử miễn phí 7 ngày đi kèm 2.000 credit — tương đương 100 lần tìm kiếm, hoặc 100 bản ghi nhân viên/công ty, hoặc kết hợp — xem so sánh gói.

Liên kết

• Coresignal — phạm vi dữ liệu, gói và giá
• Bảng điều khiển Coresignal — tài khoản, nhóm, khóa API, credit
• Tài liệu API — các API dữ liệu nền tảng