Toolstem Sec MCO Server

SEC EDGAR MCP 服务 — 内部人士信号、13D 激进投资者风险与申报文件情报

面向 AI Agent 的 SEC EDGAR 情报。 五种组合工具直接从 SEC EDGAR 的公开提交 API 预先计算高价值信号，并以结构化 JSON 返回。

无需 SEC API 密钥。 数据直接来自 SEC EDGAR 的公开提交 API。内置滑动窗口速率限制器会自动将流量控制在 SEC 的 10 rps 公平访问上限以内。

---

快速开始 — 托管端点（推荐）

将 MCP 客户端或 Agent 指向托管端点。无需 API 密钥、基础设施或设置。 通过 x402 按调用计费 — Agent 的钱包直接在 Base 主网上支付 USDC。

https://mcp.toolstem.com/mcp/sec

• 无需 SEC API 密钥、注册或市场账号 — 由 Agent 的钱包直接支付。
• 无需基础设施 — 无需安装、托管或持续运行任何内容。
• 无需设置 — 连接 MCP 客户端并调用工具。
• initialize 和 tools/list 免费（发现和架构自省）。
• tools/call 按工具分级收费（详见下方的定价）。

Claude Desktop

将以下内容放入你的 claude_desktop_config.json：

{
  "mcpServers": {
    "toolstem-sec": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.toolstem.com/mcp/sec"
      ]
    }
  }
}

重启 Claude Desktop，然后询问：“TSLA 在过去 90 天内是否披露过任何重大 8-K 事件？”

任意 MCP 客户端（LangChain.js）

官方 @langchain/mcp-adapters 库可直接连接托管 URL：

import { MultiServerMCPClient } from "@langchain/mcp-adapters";
import { ChatOpenAI } from "@langchain/openai";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const client = new MultiServerMCPClient({
  toolstem_sec: {
    transport: "http",
    url: "https://mcp.toolstem.com/mcp/sec",
    // Add your x402-signing middleware via headers, OR run an x402
    // proxy locally and point url at it. See https://www.x402.org/clients.
  },
});

const tools = await client.getTools();
const agent = createReactAgent({ llm: new ChatOpenAI({ model: "gpt-4o-mini" }), tools });
await agent.invoke({ messages: "Has TSLA disclosed any material 8-K events in the last 90 days?" });

LangChain 快速入门（langchain-toolstem）

langchain-toolstem 封装程序会为你处理 x402 付款 — 传入已充值的钱包密钥，SEC 工具便会自动包含在内：

import { createToolstemTools } from 'langchain-toolstem';
const tools = await createToolstemTools({ walletPrivateKey: process.env.WALLET_KEY });
// SEC tools included automatically — agents pay per call in USDC

想通过 stdio/HTTP 自行运行服务？请参阅文末的高级：自托管。

在 Toolstem playground 中实时试用这些工具。

---

定价

• MCP initialize 和 tools/list 免费 — 无需付费即可发现服务及其工具。
• tools/call 按工具分级收费，通过 x402 使用 Base 主网上的 USDC 付款。无需 API 密钥、注册或市场账号 — Agent 直接使用自己的钱包付款。

等级	每次调用价格	工具
低价	$0.005	get_company_filings_summary
标准	$0.05	get_insider_signal、get_institutional_signal
高级	$0.50	get_material_events_digest、compare_disclosure_signals

各工具的价格明细：

工具	等级	每次调用
get_company_filings_summary	标准	$0.005 USDC
get_insider_signal	标准	$0.05 USDC
get_institutional_signal	标准	$0.05 USDC
get_material_events_digest	高级	$0.50 USDC
compare_disclosure_signals	高级	$0.50 USDC

计费方式

Toolstem 使用 x402 支付协议。Agent 在 Base 上按次使用 USDC 付款 — 无需 API 密钥、订阅或发票。Agent 的钱包通过 EIP-3009 自动结算每次调用。

查看 toolstem.com/sec/ 上的实时定价页面，了解当前费率。

---

五种工具

这五种工具都是复合型／精选型工具（会计算派生信号或汇总多个 EDGAR 端点，不会原样传递数据）。注释：readOnlyHint: true、destructiveHint: false、idempotentHint: true、openWorldHint: true。

#	工具	必需输入	可选输入（默认值）	等级（价格／次调用）
1	get_company_filings_summary	ticker_or_cik（字符串）	—	经济型（$0.005）
2	get_insider_signal	ticker_or_cik（字符串）	lookback_days（整数，1–730，默认值为 90）	标准（$0.05）
3	get_institutional_signal	ticker_or_cik（字符串）	quarters_back（整数，1–20，默认值为 4）	标准（$0.05）
4	get_material_events_digest	ticker_or_cik（字符串）	lookback_days（整数，1–1825，默认值为 365）	高级（$0.50）
5	compare_disclosure_signals	tickers_or_ciks（string[2..5]）	—	高级（$0.50）

---

1. get_company_filings_summary

公司申报活动概览：最近 20 份申报文件 + 计算得出的信号。

信号	描述
filing_velocity	与过去 365 天的平均值相比，ACCELERATING（加快）／NORMAL（正常）／SLOWING（减缓）
material_event_count_90d	过去 90 天内 8-K 申报文件的数量
disclosure_volume_trend	根据 10-K 文件大小比较得出的 RISING（上升）／STABLE（稳定）／FALLING（下降）
latest_form_types	过去 90 天内提交的不同表格类型

输出示例（节选）：

{
  "ticker": "AAPL",
  "cik": "0000320193",
  "company_name": "Apple Inc.",
  "signals": {
    "filing_velocity": "NORMAL",
    "material_event_count_90d": 4,
    "disclosure_volume_trend": "RISING",
    "latest_form_types": ["8-K", "4", "DEF 14A"]
  },
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

---

2. get_insider_signal

探查可配置回溯窗口内的 Form 3／4／4/A 内部人申报活动。必需：ticker_or_cik。可选：lookback_days（1–730，默认值为 90）。

返回：recent_insider_filings[]（访问编号 + SEC URL）、net_transaction_count、buy_count、sell_count 和 insider_signal。

v0.1 限制——仅统计数量。 v0.1 仅返回数量和 Form 4 引用；识别买入／卖出方向的信号将在 v0.2 推出（解析 Form 4 XML）。目前，如果窗口内存在申报文件，insider_signal 为 null（方向未知）；如果没有内部人申报文件，则为 "NEUTRAL"（已确认不存在）。在 v0.1 中，buy_count／sell_count 均为 0。

输出示例（节选）：

{
  "ticker": "MSFT",
  "cik": "0000789019",
  "company_name": "MICROSOFT CORP",
  "lookback_days": 90,
  "insider_signal": null,
  "net_transaction_count": 0,
  "buy_count": 0,
  "sell_count": 0,
  "recent_insider_filings": [
    {
      "accession_number": "0001127602-26-001234",
      "filing_date": "2026-04-15",
      "sec_url": "https://www.sec.gov/Archives/edgar/data/789019/000112760226001234/0001127602-26-001234-index.htm"
    }
  ],
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

---

3. get_institutional_signal

通过 SC 13D／13D/A 申报文件探查激进投资者活动。必需：ticker_or_cik。可选：quarters_back（1–20，默认值为 4，约等于 1 年）。

字段	描述
activist_risk_flag	如果过去 365 天内提交过任何 SC 13D 或 13D/A，则为 true
recent_13d_filings	13D 申报文件列表，包含表格类型、日期和 SEC URL

v0.1 限制——仅提供激进投资者标记。 v0.1 提供**实时的 activist_risk_flag（来自 13D／13D-A）**以及 13D 申报文件列表。季度 13F XBRL 解析——该功能会生成 institutional_signal（ACCUMULATING／HOLDING／DISTRIBUTING）和 recent_13f_count——将在 v0.2 推出。目前这两个字段分别为 null／0。

输出示例（节选）：

{
  "ticker": "NVDA",
  "cik": "0001045810",
  "company_name": "NVIDIA CORP",
  "quarters_back": 4,
  "institutional_signal": null,
  "recent_13f_count": 0,
  "activist_risk_flag": false,
  "recent_13d_filings": [],
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

---

4. get_material_events_digest ⚡ 高级等级

高级等级——在 Base 主网上每次调用收费 $0.50 USDC，通过 x402 结算。当前费率请查看 toolstem.com/sec/ 上的实时定价页面。

对可配置回溯窗口内所有 8-K 和 8-K/A 申报文件生成按严重程度排序的摘要。每个项目代码都会映射为通俗易懂的标签和严重程度评级。必需：ticker_or_cik。可选：lookback_days（1–1825，默认值为 365）。

严重程度	示例
🔴 RED	网络安全事件（1.05）、重述（4.02）、破产（1.03）、退市（3.01）
🟡 YELLOW	收购（2.01）、新增债务（2.03）、高管离职（5.02）
🟢 GREEN	财报发布（2.02）、Reg FD（7.01）、股东投票（5.07）

返回：events[]（按时间从新到旧排序）、redflag_count、category_counts。

输出示例（节选）：

{
  "ticker": "TSLA",
  "cik": "0001318605",
  "company_name": "Tesla, Inc.",
  "lookback_days": 180,
  "redflag_count": 1,
  "category_counts": { "RED": 1, "YELLOW": 3, "GREEN": 7 },
  "events": [
    {
      "accession_number": "0001628280-26-005678",
      "filing_date": "2026-04-10",
      "form": "8-K",
      "items": [
        { "code": "4.02", "label": "Non-Reliance on Previously Issued Financial Statements", "category": "financial", "severity": "RED" }
      ],
      "sec_url": "https://www.sec.gov/Archives/edgar/data/1318605/000162828026005678/0001628280-26-005678-index.htm"
    }
  ],
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

---

5. compare_disclosure_signals

并排比较 2–5 家公司的所有关键披露信号。必需参数：tickers_or_ciks（string[2..5]）。所有查询均并行运行。

每家公司返回：filing_velocity、material_event_count_90d、redflag_count_365d、activist_risk_flag、last_filing_date。

返回赢家（以 CIK 表示，而非股票代码——请与 companies[] 数组交叉核对）：quietest_disclosure、most_active、most_redflags、activist_targets。

输出示例（缩略）：

{
  "companies": [
    {
      "ticker": "AAPL",
      "cik": "0000320193",
      "filing_velocity": "NORMAL",
      "material_event_count_90d": 4,
      "redflag_count_365d": 0,
      "activist_risk_flag": false,
      "last_filing_date": "2026-04-25"
    },
    {
      "ticker": "MSFT",
      "cik": "0000789019",
      "filing_velocity": "ACCELERATING",
      "material_event_count_90d": 7,
      "redflag_count_365d": 0,
      "activist_risk_flag": false,
      "last_filing_date": "2026-04-26"
    }
  ],
  "winners": {
    "quietest_disclosure": "0000320193",
    "most_active": "0000789019",
    "most_redflags": null,
    "activist_targets": []
  },
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

---

进阶：自托管

大多数用户应使用上方的托管端点——无需 API 密钥、基础设施或设置。本节适用于明确希望自行运行服务的用户。自托管时，你需要负责运行进程，并提供 EDGAR 公平访问联系信息（SEC_USER_AGENT_CONTACT）。

Claude Desktop（通过 stdio 自托管）

通过 stdio 在本地运行——不产生 x402 费用，需自行提供 EDGAR 公平访问联系信息：

{
  "mcpServers": {
    "toolstem-sec": {
      "command": "npx",
      "args": ["-y", "toolstem-sec-mcp-server"],
      "env": {
        "SEC_USER_AGENT_CONTACT": "[email protected]"
      }
    }
  }
}

npm（MCP stdio 传输）

npm install -g toolstem-sec-mcp-server
toolstem-sec-mcp-server

自托管 HTTP

三种模式：

仅限本地（默认——最安全）：

toolstem-sec-mcp-server --http
# Binds 127.0.0.1:3000 — reachable only from this machine

远程访问并启用身份验证：

ALLOW_REMOTE=1 MCP_AUTH_TOKEN=my-secret toolstem-sec-mcp-server --http
# Binds 0.0.0.0:3000 — requires Bearer token on every /mcp request

远程访问且不启用身份验证（风险自负）：

ALLOW_REMOTE=1 MCP_AUTH_DISABLED=1 toolstem-sec-mcp-server --http
# Binds 0.0.0.0:3000 — no authentication

变量	说明
PORT	HTTP 端口（默认值为 3000）
ALLOW_REMOTE	设为 1，绑定到 0.0.0.0 而非 127.0.0.1
MCP_AUTH_TOKEN	/mcp 路由的 Bearer 令牌（ALLOW_REMOTE=1 时必需）
MCP_AUTH_DISABLED	设为 1，即使 ALLOW_REMOTE=1 也跳过身份验证（不建议）
SEC_USER_AGENT_CONTACT	SEC EDGAR User-Agent 标头中的联系邮箱

---

SEC EDGAR 公平访问政策

所有出站流量均通过共享滑动窗口速率限制器（目标为 8 rps，比 SEC 的 10 rps 硬性上限低 4 rps 的安全余量）。每个请求都包含一个 User-Agent 标头，用于标识软件包和符合 SEC 政策要求的联系邮箱。可通过以下方式覆盖联系邮箱：

[email protected] toolstem-sec-mcp-server

违反 SEC 的公平访问政策可能导致你的 IP 被封锁。此服务经过设计，可自动保持合规。

---

v0.2 路线图

• Form 4 XML 解析——带方向性的内部人员信号（STRONG_BUYING / BUYING / NEUTRAL / SELLING / STRONG_SELLING），并提供净股数
• 13F XBRL 解析——季度机构资金流信号（ACCUMULATING / HOLDING / DISTRIBUTING），并提供机构数量
• 8-K 文本提取——从申报文件的主要 HTML 文档中，为每起重大事件生成自然语言摘要

---

许可证与作者

MIT License——请参阅 LICENSE。

由 Toolstem 构建。数据直接来源于 SEC EDGAR。