Coresignal MCP

Coresignal MCP v2

Model Context Protocol 官方 Coresignal 服务——将涵盖 895M+ 名员工、70M+ 家公司和 468M+ 条职位发布的最新 B2B 数据直接引入你的 AI 助手。

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

使用自然语言搜索、获取完整记录、为联系人补充经过验证的电子邮件，并将大量搜索结果导出为可下载文件——所有操作都可以通过 Claude、Cursor、Codex、VS Code 或其他任何兼容 MCP 的客户端完成。

功能

• OAuth 2.1 身份验证——使用你的 Coresignal 控制面板账号登录；配置文件中无需填写 API 密钥。
• 自然语言搜索——每行结果都附有匹配依据，让你了解每条记录为何匹配。
• 费用透明——每条响应都会报告 credits_consumed，费用较高的调用会在扣费前请求确认。
• 字段发现——entity_fields 可免费按关键词查找合适的字段名称，无需将完整的 300+ 个字段词汇表加载到上下文中。
• 文件下载——大量搜索结果会存储在服务端，并以下载链接的形式返回，避免聊天内容过多。
• artifact_read 可免费将已交付的文件分页传回对话中，即使客户端无法访问文件系统也能使用。

前提条件

• 一个已开通有效订阅（含积分）并在控制面板中配置了团队 API 密钥的 Coresignal 账号。登录后，MCP 服务会自动获取团队密钥——你无需将其粘贴到配置文件中。还没有订阅？可先试用 7 天免费试用版，其中包含 2,000 个积分。请参阅套餐对比。

首次连接时，客户端会打开浏览器窗口，让你登录 Coresignal 控制面板。设置就是这么简单——无需环境变量，也无需密钥。

客户端设置

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

文件下载与域名允许列表

大型结果（以及任何带有 delivery="url" 的调用）不会直接输出到聊天中，以节省大模型输入令牌。服务端会将记录存储为文件，并返回一个签名 HTTPS 下载链接，该链接会在 1 小时后过期：

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

之后，Agent 可通过以下三种方式之一获取数据：

1. Agent 自行下载文件——在支持 Shell 访问的客户端中，Agent 通常会使用 curl 将链接下载到磁盘，并在本地用 grep/jq/pandas 分析文件。
2. Agent 在聊天中读取文件——在不支持 Shell 和文件系统的客户端中，Agent 会改用 artifact_read(artifact_name, offset, limit)，通过 MCP 会话分段读取文件。此方式免费且适用于所有环境，因此不会让聊天内容过载。
3. 你手动下载——如果 Agent 本身无权获取链接（域名未加入允许列表，或沙盒无法访问网络），请点击链接、保存文件，然后告知 Agent 文件所在位置：“我已将文件下载到 ~/Downloads/employee_fetch-….jsonl——请从那里进行分析。” 适用于任何能够读取本地文件的客户端。

如果客户端支持下载，请优先下载。 artifact_read 不消耗 Coresignal 积分，但会消耗大模型令牌：它返回的每一页都会成为对话的一部分，并在之后的每轮对话中再次作为输入令牌计费。每页还会限制在固定的令牌预算内——一条完整的员工记录约为 8k 个令牌，因此无论你请求的 limit 是多少，每页都只能容纳少数几条完整记录。以这种方式读取大型文件需要数百次调用，而且可能在读完之前就耗尽上下文窗口。下载文件基本不消耗令牌——助手可以在本地用 grep/jq 筛选数千条记录，并只展示答案。因此，提前配置好下载功能（域名允许列表、沙盒网络访问）很有帮助；请将 artifact_read 留给无法下载的客户端，或用于快速查看几条记录。

**如果下载受阻，不会丢失任何内容：**记录已经存储并付费，可通过 artifact_read 读取。切勿为了“恢复”文件而重新运行获取操作，否则每条记录都会再次计费。

工具

entity_search

使用自然语言查询搜索 employee、company 或 job 记录：

“法语环境中的金融科技公司高级 Python 开发人员”

每次调用固定消耗 20 积分，并返回：

• total_count——查询匹配的确切记录数；
• 最多 20 条预览记录（limit=0 时仅返回数量），每条记录会显示查询匹配的字段——即每条结果出现的依据；
• cache_id——有效期为 1 小时的搜索句柄，可节省积分和时间：将其传递给 entity_fetch，即可立即收集匹配记录，无需重新运行搜索（也无需再次付费），且解析 cache_id 本身免费。记录 ID 保留在服务端，因此不会有任何庞大的内容经过对话传递。

entity_fields

按含义免费、即时查找字段名称——"salary" 会找到薪酬字段，"current job title and seniority" 会找到 active_experience_title、experience.position_title 等字段。可用它为自定义范围的获取操作构建 fields 列表，而无需将完整字段词汇表加载到上下文中。

entity_fetch

收集记录——可以从搜索结果中挑选最多 20 个 ID，也可以通过 cache_id 单次调用获取最多 1,000 条记录。按找到的记录计费：员工／公司每条 20 个积分，职位每条 1 个积分。

email_enrich

为最多 1,000 个员工 ID 查找经过验证、可送达的商务电子邮件——每找到一封邮件收取 10 个积分；未找到的 ID 免费。无法获取欧洲经济区／英国联系人的信息（GDPR）。

artifact_read

通过经过身份验证的 MCP 会话逐页读取已交付的文件——免费，因为记录在获取时已计费。借助此工具，文件交付可以在任何环境中使用，包括无法打开链接或访问文件系统的聊天客户端。

示例提示词

市场扫描

“查找北欧员工人数为 50–200 人、且在过去两年内获得融资的 B2B SaaS 公司。”

构建包含经过验证的电子邮件的潜在客户名单

“搜索员工人数超过 500 人的美国公司中的数据主管。获取 20 份完整档案，并将经过验证的电子邮件保存到文件中。”

深入了解单家公司**

“获取 flo.health 的完整记录——融资轮次、员工人数增长和当前职位空缺。”

...

积分与计费

每个响应都包含 credits_consumed，即实际计费金额。因此，如果出现差异（发送了 1,000 个 ID，却只按 950 条记录计费），你就能准确知道有多少个 ID 未找到。服务端不会在你不知情的情况下扣除积分：获取数据前会先与你确认字段范围；如果无法交付，获取操作会在扣除任何积分之前失败。

积分从团队的 Coresignal 订阅中扣除——在控制面板中管理密钥和账单。刚开始使用 Coresignal？7 天免费试用包含 2,000 个积分——可用于 100 次搜索、100 条员工／公司记录，或混合使用——请参阅套餐对比。

链接

• Coresignal — 数据覆盖范围、套餐和定价
• Coresignal 控制面板 — 账户、团队、API 密钥和积分
• API 文档 — 底层数据 API