SuperAPI AI 工具集

toolstem-sec-mcp-server

Toolstem SEC MCP Server 是一个面向 AI 智能体的 SEC EDGAR 文件情报 MCP 服务器,直接从 SEC EDGAR 公开提交 API 预计算高价值信号并以结构化 JSON 返回。提供五个复合工具,覆盖公司申报活动概览、内幕交易(Form 3/4/4-A)信号、13D/13D-A 激进投资者风险标记、8-K/8-K-A 重大事件摘要,以及 2 至 5 家公司披露信号横向对比。无需 SEC API 密钥,内置滑动窗口限流器,自动将流量控制在 SEC 每秒 10 次公平访问上限以下。支持托管端点(x402 按次付费,USDC on Base 主网结算)和自行部署(stdio/HTTP)两种方式,可用于 Claude Desktop、LangChain 等 MCP 客户端。

访问官网

工具介绍

用途

Toolstem SEC MCP Server 是为 AI 智能体设计的 SEC EDGAR 申报文件情报 MCP 服务器。其核心思路是在原始申报文件之上预计算高价值信号,并以结构化 JSON 返回,让智能体无需自行解析 EDGAR 原始数据即可获取内幕信号、机构资金流向和重大事件摘要。

主要能力

服务器提供五个复合工具(均为聚合或派生计算,不做原始数据直传):

  1. get_company_filings_summary:返回公司申报活动概览,包括最近 20 份申报及计算所得信号。

  2. get_insider_signal:探测指定回溯窗口内的 Form 3 / 4 / 4-A 内幕申报活动。必填 ticker_or_cik,可选 lookback_days(1–730,默认 90)。返回 recent_insider_filings[](含 accession 号与 SEC URL)、net_transaction_count、buy_count、sell_count 以及 insider_signal。

  3. get_institutional_signal:通过 SC 13D / 13D-A 申报探测激进投资者活动。必填 ticker_or_cik,可选 quarters_back(1–20,默认 4,约一年)。

  4. get_material_events_digest(Premium 层级):对可配置回溯窗口内所有 8-K 与 8-K/A 申报按严重程度排序生成摘要,每项 item code 映射为通俗英文标签和严重程度评级。必填 ticker_or_cik,可选 lookback_days(1–1825,默认 365)。返回 events[](最新在前)、redflag_count、category_counts。

  5. compare_disclosure_signals:对 2–5 家公司跨全部关键披露信号做并排对比。必填 tickers_or_ciks(字符串数组,2 至 5 个)。所有查询并行执行。每家公司返回 filing_velocity、material_event_count_90d、redflag_count_365d、activist_risk_flag、last_filing_date。并返回 quietest_disclosure、most_active、most_redflags、activist_targets 等“优胜者”(以 CIK 返回,需对照 companies[] 数组)。

使用方式

托管端点(推荐):将 MCP 客户端或智能体指向托管端点即可,无需 API 密钥、无需基础设施、无需注册或市场账户。计费通过 x402 协议按次调用,智能体钱包直接在 Base 主网以 USDC 支付。initialize 和 tools/list 免费(用于发现与 schema 自省),tools/call 按工具分级计费。可将配置放入 claude_desktop_config.json 并重启 Claude Desktop,然后询问,例如:“Has TSLA disclosed any material 8-K events in the last 90 days?”。也可通过官方 @langchain/mcp-adapters 库直接连接托管 URL;langchain-toolstem 封装库可代为处理 x402 支付,传入已充值的钱包密钥即可自动包含 SEC 工具。

自行部署:适合明确希望自行运行服务器的用户,支持 stdio 与 HTTP 两种方式(npm MCP stdio 传输、自托管 HTTP,本地默认最安全,也支持带认证或不带认证的远程模式)。自行部署时需自行运行进程,并提供 EDGAR 公平访问联系人(SEC_USER_AGENT_CONTACT)。自托管不产生 x402 费用。

适用场景

适合需要让 AI 智能体快速获取上市公司申报情报的场景,例如公司申报活动监控、内幕申报活动探测、激进投资者风险标记、8-K 重大事件摘要,以及多家公司披露信号横向对比。

限制

  • 无需 SEC API 密钥,数据直接来自 SEC EDGAR 公开提交 API;所有出站流量经共享滑动窗口限流器(目标 8 rps,低于 SEC 每秒 10 次硬上限 4 rps 安全余量),每次请求按 SEC 政策携带标识包与联系邮箱的 User-Agent 头,可通过环境变量覆盖联系邮箱。违反 SEC 公平访问政策可能导致 IP 被封禁。
  • v0.1 限制(内幕信号):仅返回计数与 Form 4 引用;方向感知的买卖信号计划在 v0.2(Form 4 XML 解析)提供。当前当窗口内存在申报时 insider_signal 为 null(方向未知),无内幕申报时为 "NEUTRAL"(经验证的缺失);v0.1 中 buy_count / sell_count 为 0。
  • v0.1 限制(机构信号):仅提供激进标记。v0.1 提供来自 13D/13D-A 的实时 activist_risk_flag 及 13D 申报列表;季度 13F XBRL 解析(产生 institutional_signal 的 ACCUMULATING / HOLDING / DISTRIBUTING 及 recent_13f_count)计划在 v0.2 提供,当前这两个字段为 null / 0。

价格

托管端点按 x402 协议按次计费,USDC on Base 主网结算,无 API 密钥、无订阅、无发票,智能体钱包通过 EIP-3009 每次自动结算。其中 get_material_events_digest 为 Premium 层级,资料标明为每次调用 0.50 USDC on Base 主网;其余各工具按分级计费,具体费率以 toolstem.com/sec/ 上的实时定价页为准。initialize 与 tools/list 免费。

路线图(资料所载)

Form 4 XML 解析(方向感知内幕信号 STRONG_BUYING / BUYING / NEUTRAL / SELLING / STRONG_SELLING 及净股数);13F XBRL 解析(季度机构流向信号及机构数量);8-K 文本抽取(从申报主 HTML 文档生成各重大事件的自然语言摘要)。

许可与作者

MIT 许可证。由 Toolstem 构建,数据直接来源于 SEC EDGAR。