the13f

the13f-mcp

适用于 the13f 的 Model Context Protocol 服务。将机构 13F 情报 引入 Claude Desktop、Cursor、VS Code + Continue 以及任何兼容 MCP 的宿主，无需你编写 HTTP 代码。

重要限制

仅供研究使用。数据来源于 SEC Form 13F 公开披露文件，披露时间最多可能滞后季度末 45 天。机构过去的持仓情况并不能预测未来表现。本文内容均不构成投资建议。每个工具的响应都包含 disclaimer 字段；宿主 LLM 应在生成分析时一并呈现该字段。

安装

uvx the13f-mcp

如果你更愿意自行管理 Python 环境，也可以运行 pip install the13f-mcp。需要 Python 3.11+。

获取免费的 API 密钥

免费，无需付款，也无需信用卡：

1. 访问 https://the13f.com/developers/
2. 输入你的邮箱并完成 Cloudflare Turnstile 验证
3. 复制你的 pf13f_ 密钥——只显示一次
4. 将其作为 THE13F_API_KEY 粘贴到 MCP 宿主配置中（见下文）
5. 重启宿主

免费套餐：每天 100 次读取调用；配额于 UTC 午夜重置。信号和报告工具将在后续小版本中推出，届时将上线付费套餐。

配置 MCP 宿主

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%/Claude/claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "the13f": {
      "command": "uvx",
      "args": ["the13f-mcp"],
      "env": {
        "THE13F_API_KEY": "pf13f_..."
      }
    }
  }
}

重启 Claude Desktop。MCP 工具列表中应会显示 the13f 工具。

Cursor

设置 → MCP → 添加服务。将相同的 JSON 代码块粘贴到“Custom”字段中。

使用 Continue 的 VS Code

设置 → experimental.modelContextProtocolServers → 添加一个 stdio 传输，运行 uvx the13f-mcp，并在 env 中设置 THE13F_API_KEY。密钥显示页面 https://the13f.com/developers/signup-success 提供了可直接复制粘贴的代码片段，其中已填入密钥。

可用工具 — v0.1.0（读取套餐，免费）

工具	功能
list_quarters	所有包含持仓数据的季度及最新季度
search_managers	按名称自动补全 13F 申报机构
get_manager_holdings	指定 CIK + 季度的完整持仓
get_manager_holdings_bulk	一次调用最多处理 25 组 (cik, quarter)
list_all_managers	包含 8,600 多家申报机构及各机构摘要统计数据的全集
find_similar_managers	在全集中查找与某个投资组合匹配的机构
get_consensus_portfolio	每季度持仓机构最多的证券
get_market_regime	机构市场状态快照（IIOI 综合指标、状态、转变）
get_sector_flows	各行业资金流向及风险态势

计划推出的工具 — 后续版本

版本	工具	要求
v0.2.0	get_security_signals、get_security_signals_bulk、get_portfolio_signals	Standard 套餐订阅
v0.3.0	generate_manager_report、generate_security_report、generate_sector_report、check_report_status、wait_and_download_report	Standard 套餐 + 已存储的卡片；两步确认

免费套餐中的读取工具足以帮助你探索数据并据此构建提示词。信号和报告工具会暂缓推出，直到付费套餐的计费流程准备就绪。

提示词示例

“提取伯克希尔·哈撒韦截至 2025 年第 4 季度的前 20 大持仓，并总结哪些持仓的环比增长最大。”

“我以等权重持有 AAPL、MSFT 和 NVDA。找出投资组合与我最相似的 5 家机构。”

“上个季度，13F 申报机构大幅减持最多的是哪个行业？列出引领减持的前三家机构。”

MCP 宿主的 LLM 会选择合适的工具、填写参数、呈现 disclaimer，并以结构化 JSON 返回结果。

环境变量

变量	默认值	控制内容
THE13F_API_KEY	（无）	你的 pf13f_ 密钥。没有该密钥时，工具会返回结构化响应，提示“需要免费注册”，并附上注册页面链接。
THE13F_API_BASE_URL	https://api.the13f.com	用于在本地开发时连接正在运行的 the13f gui_server 副本的覆盖值。
THE13F_MCP_TIMEOUT	30	每次请求的 HTTP 超时时间，单位为秒。最短为 5 秒。

源码

公开源码：https://github.com/pickelfintech/the13f-mcp。PyPI、Glama.ai 和 MCP 社区目录指向的都是此 快照。GitHub 仓库是 GitLab 仓库 gitlab.com/pickel-fintech/the13f-mcp 的推送镜像；GitLab 仍是主仓库， 也包含发布 CI。两边都接受 Bug 报告和 PR。

许可证

MIT — 详见 LICENSE。此客户端调用的托管服务 api.the13f.com 是独立服务。需要免费 API 密钥（每天 100 次调用）；请前往 https://the13f.com/developers/ 注册。

支持

[email protected] — 如需尽快排查问题，请附上任何失败工具调用返回的 request_id 字段。

许可证

MIT。详见 LICENSE。MCP 服务源码采用 MIT 许可证；the13f API 的使用则受 https://the13f.com/terms.html 中的服务条款约束。