内容
# SEC EDGAR MCP 服务器 — 内幕信号、13D 激进投资者风险和申报情报
[](https://www.npmjs.com/package/toolstem-sec-mcp-server)
[](https://www.npmjs.com/package/toolstem-sec-mcp-server)
[](./LICENSE)
**面向 AI 代理的 SEC EDGAR 情报。** 五种复合工具，直接从 SEC EDGAR 公共提交 API 计算高价值信号，以结构化的 JSON 返回。
> **无需 SEC API 密钥。** 数据直接从 SEC EDGAR 公共提交 API 获取。内置的滑动窗口限速器自动将流量保持在 SEC 的 10 次/秒公平访问上限以下。
---
## 快速开始 — 主机端点（推荐）
将您的 MCP 客户端或代理指向主机端点。**无需 API 密钥，无需基础设施，无需设置。** 账单按次调用，通过 [x402](https://www.x402.org) — 代理的钱包直接支付 USDC 在 Base 主网。
```
https://mcp.toolstem.com/mcp/sec
```
- **无需 SEC API 密钥，无需注册，无需市场账户** — 代理的钱包直接支付。
- **无需基础设施** — 无需安装、托管或运行。
- **无需设置** — 连接 MCP 客户端并调用工具。
- `initialize` 和 `tools/list` **免费** （发现和模式检查）。
- `tools/call` **分级计费** （见下文 [定价](#定价)）。
### Claude 桌面版
将以下内容放入您的 `claude_desktop_config.json` 中：
```json
{
"mcpServers": {
"toolstem-sec": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.toolstem.com/mcp/sec"
]
}
}
}
```
重启 Claude 桌面版，然后询问：*“TSLA 是否在过去 90 天内披露了任何重要的 8-K 事件？”*
### 任意 MCP 客户端（LangChain.js）
官方 [`@langchain/mcp-adapters`](https://www.npmjs.com/package/@langchain/mcp-adapters) 库直接连接到主机 URL：
```ts
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",
// 通过标头添加 x402 签名中间件，或在本地运行 x402 代理并将 url 指向它。参见 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: "TSLA 是否在过去 90 天内披露了任何重要的 8-K 事件？" });
```
### LangChain 快速入门 (`langchain-toolstem`)
[`langchain-toolstem`](https://www.npmjs.com/package/langchain-toolstem) 包装器为您处理 x402 支付 - 将一个有资金的钱包密钥传递，SEC 工具将自动包含：
```typescript
import { createToolstemTools } from 'langchain-toolstem';
const tools = await createToolstemTools({ walletPrivateKey: process.env.WALLET_KEY });
// SEC 工具自动包含 - 代理按次调用支付 USDC
```
更喜欢自己运行服务器而不是 stdio/HTTP？参见 [高级：自行托管](#高级自行托管) 在底部。
在 [Toolstem 游戏场](https://www.toolstem.com/playground/) 中实时试用工具。
---
## 定价
- **MCP `initialize` 和 `tools/list` 免费** - 无需支付即可发现服务器及其工具表面。
- **`tools/call` 分级计费** ，在 Base 主网上通过 [x402](https://www.x402.org) 以 USDC 支付。无需 API 密钥，无需注册，无需市场账户 - 代理直接从其自己的钱包支付。
| 层级 | 每笔调用价格 | 工具 |
|------|----------------|-------|
| 便宜 | **$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 支付协议。代理按次调用在 Base 上以 USDC 支付 - 无需 API 密钥，无需订阅，无需发票。代理的钱包通过 EIP-3009 自动结算每次调用。
在 [toolstem.com/sec/](https://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` （int 1-730，**默认值 90**） | 标准（$0.05） |
| 3 | `get_institutional_signal` | `ticker_or_cik` （字符串） | `quarters_back` （int 1-20，**默认值 4**） | 标准（$0.05） |
| 4 | `get_material_events_digest` | `ticker_or_cik` （字符串） | `lookback_days` （int 1-1825，**默认值 365**） | **高级（$0.50）** |
| 5 | `compare_disclosure_signals` | `tickers_or_ciks` （字符串[2..5]） | - | **高级（$0.50）** |
---
### 1. `get_company_filings_summary`
公司申报活动的概述：最近 20 次申报 + 计算信号。
| 信号 | 描述 |
|--------|-------------|
| `filing_velocity` | `ACCELERATING` / `NORMAL` / `SLOWING` 与过去 365 天的平均值相比 |
| `material_event_count_90d` | 过去 90 天内 8-K 申报的次数 |
| `disclosure_volume_trend` | `RISING` / `STABLE` / `FALLING` 基于 10-K 尺寸比较 |
| `latest_form_types` | 过去 90 天内提交的独特表格类型 |
**示例输出（缩写）：**
```json
{
"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[]` （ accession 号码 + SEC 网址），`net_transaction_count` ，`buy_count` ，`sell_count` 和 `insider_signal` 。
> **v0.1 限制 - 仅限计数。** v0.1 仅返回计数和 Form 4 引用；**方向感知买入/卖出信号在 v0.2 中发货** （Form 4 XML 解析）。今天，`insider_signal` 在窗口内存在申报时为 `null` （方向未知），当没有内幕申报时为 `"NEUTRAL"` （验证缺失）。 `buy_count` / `sell_count` 在 v0.1 中为 `0` 。
**示例输出（缩写）：**
```json
{
"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 网址 |
> **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` 。
**示例输出（缩写）：**
```json
{
"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/](https://toolstem.com/sec/) 上的实时定价页面获取当前费率。
按可配置的回顾窗口内的所有 8-K 和 8-K/A 申报的严重性排名摘要。每个项目代码映射到普通英语标签和严重性评级。必填：`ticker_or_cik`。可选：`lookback_days` （1-1825，默认 365）。
| 严重性 | 示例 |
|----------|---------|
| 🔴 红色 | 网络安全事件（1.05），重述（4.02），破产（1.03），退市（3.01） |
| 🟡 黄色 | 收购（2.01），新债务（2.03），高管离职（5.02） |
| 🟢 绿色 | 收益发布（2.02），Reg FD（7.01），股东投票（5.07） |
返回：`events[]` （按最新时间排序），`redflag_count` ，`category_counts` 。
**示例输出（缩写）：**
```json
{
"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": "对以前发布的财务报表的不依赖", "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` （字符串[2..5]）。所有查找并行运行。
返回每家公司：`filing_velocity` ，`material_event_count_90d` ，`redflag_count_365d` ，`activist_risk_flag` ，`last_filing_date` 。
返回获胜者（作为 **CIK** ，而非 ticker - 与 `companies[]` 数组进行交叉引用）： `quietest_disclosure` ，`most_active` ，`most_redflags` ，`activist_targets` 。
**示例输出（缩写）：**
```json
{
"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" }
}
```
---
## 高级：自行托管
> **大多数用户应使用上述 [托管端点](#quickstart--hosted-endpoint-recommended) ** - 它不需要 API 密钥，不需要基础设施，也不需要设置。本节适用于专门想要自己运行服务器的用户。当自行托管时，您负责运行进程并提供 EDGAR 公平访问联系人（`SEC_USER_AGENT_CONTACT` ）。
### Claude 桌面版（自行托管 stdio）
本地运行 stdio - 无 x402 费用，您提供自己的 EDGAR 公平访问联系人：
```json
{
"mcpServers": {
"toolstem-sec": {
"command": "npx",
"args": ["-y", "toolstem-sec-mcp-server"],
"env": {
"SEC_USER_AGENT_CONTACT": "you@yourorg.com"
}
}
}
}
```
### npm （MCP stdio 传输）
```bash
npm install -g toolstem-sec-mcp-server
toolstem-sec-mcp-server
### 自托管 HTTP
三种模式：
**仅限本地（默认 - 最安全）：**
```bash
toolstem-sec-mcp-server --http
# 绑定 127.0.0.1:3000 - 仅限此机器可访问
```
**远程身份验证：**
```bash
ALLOW_REMOTE=1 MCP_AUTH_TOKEN=my-secret toolstem-sec-mcp-server --http
# 绑定 0.0.0.0:3000 - 每 /mcp 请求都需要 Bearer 令牌
```
**远程无身份验证（请自行承担风险）：```
ALLOW_REMOTE=1 MCP_AUTH_DISABLED=1 toolstem-sec-mcp-server --http
# 绑定 0.0.0.0:3000 - 无身份验证
```
| 变量 | 描述 |
|----------|-------------|
| `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 次/秒，安全裕度 4 次/秒低于 SEC 的 10 次/秒硬上限）。每个请求都包含一个 `User-Agent` 头，该头标识包并包含 SEC 政策要求的联系人邮箱。通过以下方式覆盖联系人邮箱：
```bash
SEC_USER_AGENT_CONTACT=you@yourorg.com 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](https://toolstem.com/sec/) 构建。数据直接来源于 [SEC EDGAR](https://www.sec.gov/developer)。
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器