Magellan Data Spotlight

Magellan Data MCP

面向 AI Agent 的企业所有权情报。 将 Claude、Cursor 或任何兼容 MCP 的客户端连接到 Magellan Data 的 Spotlight 平台，一次针对数千家公司的名单，查询公司之间的所有权关系——母公司、PE 支持方、企业家族以及同一投资组合中的关联公司。

托管服务。无需安装。使用 API 密钥连接，或通过 claude.ai 等托管连接器使用 OAuth 连接。

https://spotlight-mcp.magellandata.io/mcp

这是 MCP 端点，不是网页——请将其粘贴到客户端的配置中，而不是浏览器中。直接打开会返回错误，这是所有托管 MCP 服务的正常行为。

试着这样提问

连接后，可以用自然语言提出以下问题：

“读取 accounts.xlsx，告诉我其中哪些公司有 PE 支持方，以及支持方是谁。”

“我们刚完成了对 Moosend 的交易。找出同一家 PE 公司拥有的所有其他公司——它们是值得优先拓展的潜在客户。”

“我的 200 个客户中，哪些是大型母公司的子公司？将母公司名称添加到电子表格中并保存。”

“梳理 Constant Contact 母公司旗下的完整企业家族，这样我就能看到尚未覆盖的关联公司。”

Agent 会处理整个流程——提交批次、轮询直至运行完成、检查价格，并通过 input_url 将结果与原始文件合并。

快速开始

1. 获取 API 密钥。 在 magellandata.io 注册，并从 Spotlight 控制面板生成密钥。密钥格式类似 mgln_sk_live_…。每个密钥都有自己的额度余额，费用计入发起调用的密钥。

2. 连接客户端。

claude mcp add --transport http magellan-data https://spotlight-mcp.magellandata.io/mcp \
  --header "Authorization: Bearer mgln_sk_live_YOUR_KEY"

claude mcp list   # expect: magellan-data ... ✓ Connected

{
  "mcpServers": {
    "magellan-data": {
      "url": "https://spotlight-mcp.magellandata.io/mcp",
      "headers": {
        "Authorization": "Bearer mgln_sk_live_YOUR_KEY"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "magellanKey",
      "description": "Magellan Data API key (mgln_sk_live_...)",
      "password": true
    }
  ],
  "servers": {
    "magellan-data": {
      "type": "http",
      "url": "https://spotlight-mcp.magellandata.io/mcp",
      "headers": { "Authorization": "Bearer ${input:magellanKey}" }
    }
  }
}

3. 验证。 向 Agent 提问：“检查我的 Magellan Data 额度余额。” 如果返回一个数字，说明已连接。此调用免费。

身份验证

支持两种方式；请选择适合你连接方式的一种。

API 密钥（mgln_sk_live_…）——适用于 Claude Code、Cursor 等本地和命令行客户端，或任何需要手动配置的客户端。在 Spotlight 控制面板 中生成密钥，并按照上述快速开始中的说明，将其作为 Bearer 令牌传入 Authorization 请求头。费用计入发起调用的密钥。

OAuth 2.1——适用于 claude.ai 和 ChatGPT 等托管连接器。你无需进行任何 OAuth 专属设置：添加连接器时（从目录添加，或在平台保管客户端凭据时将其作为自定义连接器添加），系统会引导你前往 Spotlight 登录并批准访问权限——这是常见的“连接、登录、允许”流程——之后由客户端处理令牌。费用计入你批准访问的 Spotlight 账户。

无论采用哪种方式，每个请求都会经过身份验证，并归属于一个 Spotlight 账户——两种方式的区别仅在于凭据如何传递到服务端。

可查询内容

对于 parent_companies 和 pe_ownership，你只需为查询命中的结果付费：未发现任何信息的 URL 不收费，因此 70 个点数 × URL 数量只是费用上限，并非实际账单。其他两种按输出记录收费。无论哪种情况，运行完成后就能确定准确费用——Agent 会从运行结果中读取费用，并在下载前告知你。

点数如何计费

这部分值得了解，因为它能避免自主 Agent 悄无声息地耗尽你的余额：

• 提交批次免费。 启动处理任务、轮询其状态以及查询余额也都免费。
• 点数只在一个环节扣除： download_run。此前的所有操作都不收费。
• Agent 会先告知费用。 每次运行都包含一个 price 字段，服务端会指示已连接的客户端告知你费用，并在下载前等待你的确认。
• 重新下载永久免费。 购买某次运行的结果后，该运行就会一直保持已购买状态。如果下载链接过期，只需再次索取——不会重复收费。

如果你不想费心考虑费用：从开始操作到了解“这要花多少钱”为止，全程免费，而且 Agent 会先征求你的同意。

工具

操作流程始终是提交 → 处理 → 轮询 → 下载。结果会通过短下载链接（https://api.magellandata.io/dl/…，有效期为 1 小时）返回，而不是直接嵌入内容中，因此，即使结果集包含 200 万行，也不会占用 Agent 的上下文窗口。该链接无需身份验证标头——可直接交给 curl、pandas.read_csv 或浏览器。在无法访问一般互联网的托管聊天环境（例如 claude.ai 连接器）中，助手会将链接作为可点击链接呈现给你，让你自行打开，而不会尝试自行获取内容。

此外还有一个 magellan_playbook 提示词——一份 GTM 策略指南，涵盖扩张目标排名、deal_type 解读以及 MSA 时机触发条件。在 Claude Code 中，它会以斜杠命令的形式显示在 magellan-data 服务下。

使用示例

examples/quickstart.py 直接通过 REST API 运行完整流程，帮助你了解 Agent 在后台执行的操作，也适用于将 Magellan Data 接入非 Agent 工作流。

export MAGELLAN_API_KEY=mgln_sk_live_YOUR_KEY
python examples/quickstart.py --urls moosend.com constantcontact.com --type pe_ownership

examples/accounts.csv 和 accounts.xlsx 是一个包含 12 行数据的样例文件，无需提供自己的数据即可交给 Agent 使用。这些公司涵盖独立企业、被收购的子公司和 PE 投资组合企业，因此每种输出类型都能返回结果。丰富全部 12 家公司的数据，对于每种基于匹配的输出类型，最多需要 840 个积分（仅对找到结果的公司收费），成本足够低，可以用于实际验证流程。

脚本会在下载步骤前停止并询问，因此你可以从头到尾运行它，直到确认要继续时才会消耗积分。

examples/PROMPTS.md 提供了 Agent 提示词的操作指南，按目标难度递增排列，并预先注明每个提示词的预期费用。

Skills

skills/ 目录包含面向具体任务的操作指南，可将原始工具输出转化为完整交付成果——例如排名后的目标名单、覆盖情况图或丰富后的电子表格——而非 JSON。支持 Skills 的客户端可以从此仓库加载这些指南；不支持的客户端也可以直接使用 Markdown 文件。

仓库内容

.mcp.json                     MCP registration (Claude Code, Codex)
mcp.json                      MCP registration (Cursor)
.vscode/mcp.json              MCP registration (VS Code, prompts for key)
.claude-plugin/
  plugin.json                 Claude plugin metadata
  marketplace.json            Claude marketplace metadata
server.json                   Official MCP Registry metadata
skills/*/SKILL.md             Task playbooks
examples/
  quickstart.py               Full pipeline against the REST API
  PROMPTS.md                  Agent prompt walkthrough
  accounts.csv         12-row test fixture
  accounts.xlsx        Same fixture, spreadsheet form
assets/
  logo.png                    Wordmark, navy (for light backgrounds)
  logo-light.png              Wordmark, white (for dark backgrounds)
  social-preview.png          1280x640 social card — upload under
                              Settings > Social preview
  social-preview-light.png    Light-background alternate

若要在本地使用这些清单：

git clone https://github.com/sorrek/mcp.git

然后将客户端指向仓库根目录或特定清单路径。

故障排除

浏览器中显示端点 URL 出错。 这是预期行为。/mcp 通过 POST 使用 JSON-RPC；传输规范规定该路径上的 GET 请求用于打开事件流，因此不提供事件流的此类服务会返回 405。该路径没有可查看的内容。若要确认服务确实已启动，请让 Agent 调用 check_credits——此操作免费，并会完整验证身份验证流程。

客户端已连接，但未列出任何工具。 这几乎总是身份验证问题，而不是传输问题。请确认请求头为 Authorization: Bearer mgln_sk_live_...，包含 Bearer 前缀，并确认密钥在 Spotlight 控制面板中处于启用状态。

下载链接提示已过期（HTTP 410）。 下载链接有效期为一小时。再次调用 download_run 即可获取新链接——重新下载免费。

某次运行长时间处于 processing 状态。 大型批次需要几分钟，而非几秒。请每隔 10–30 秒轮询一次，不要紧密循环轮询。如果运行超过 20 分钟，请使用 run_id 提交问题。

说明和限制

• **批次大小：**每批最多 5,000 个 URL。更长的名单应拆分处理；只要提出要求，Agent 就会执行拆分。
• **耗时：**大型运行需要几分钟，而非几秒。建议每隔 10–30 秒轮询一次，服务说明中也有此建议。
• **输入重叠：**如果两个输入公司拥有同一家母公司或同一家 PE 公司，则两个输入都会收费。每个输出行都包含 input_url，因此在客户端去重非常简单。
• **身份验证：**每个请求都会携带 API 密钥或 OAuth 令牌（请参阅身份验证），因此使用情况始终会归属到正确的 Spotlight 账户。

路线图

• 在官方 MCP Registry 和下游目录中发布
• 为所有权记录添加 last_verified 时间戳

欢迎提交问题和功能请求——请在此仓库中提出。

支持

• API 文档： docs.magellandata.io
• 错误和请求： 提交问题
• 数据质量问题： [email protected]
• 商务咨询： magellandata.io

许可证

MIT — 本仓库。Spotlight API 本身是一项商业服务，受 Magellan Data 服务条款约束。