mcp-edgar
SEC EDGAR — 上市公司申报文件
美国证券交易委员会的申报文件数据库。美国每一家上市公司都在这里申报,每份申报文件都带有时间戳且不可更改,每项披露(收入、债务、风险因素、高管薪酬、并购活动、内幕交易)都经过结构化处理,可供机器检索。免费且权威。
属于 Pipeworx 的一部分——一个将 AI 智能体连接到 1476+ 个实时数据源的 MCP 网关。
为什么这对 AI 智能体很重要
如果你的智能体要回答任何关于美国上市公司的问题——财务数据、法律风险敞口、知识产权、高管变动、近期重大事件——答案都在 EDGAR 里。数据是结构化的(XBRL),所以你不需要解析 PDF。
两个关键流程:
1. 申报文件流程。 "显示苹果公司最近的 10-Q。" → edgar_ticker_to_cik("AAPL") → edgar_company_filings(cik) → 带有受理编号、表格类型、申报日期的申报文件列表。
2. 概念流程。 "苹果公司过去 4 个季度的收入趋势如何?" → edgar_company_concept(cik, "Revenues") → 跨期间的 XBRL 标记值时间序列。
两者通常都以 edgar_ticker_to_cik 或 resolve_entity({type: "company", value: "AAPL"}) 开头,以获取规范的 10 位 CIK。
Related MCP server: edgar-mcp
认证
无需认证。SEC EDGAR 是免费、公开、无需认证的服务。Pipeworx 会转发一个礼貌的 User-Agent 头,以遵守 SEC 的 API 指南。
可引用的 URI
pipeworx://edgar/company/{cik}/filings
pipeworx://edgar/company/{cik}/facts嵌入到你的输出中。在重组中保持稳定——公司会改名,但它们的 CIK 不会变。
值得了解的申报表格类型
表格 | 内容 | 时间 |
10-K | 年度报告 | 财年结束后约 60 天 |
10-Q | 季度报告 | 季度结束后约 45 天 |
8-K | 重大事件(并购、高管变动、财报等) | 4 个工作日内 |
DEF 14A | 委托书(高管薪酬、公司治理) | 年度股东大会前约 6 周 |
Form 4 | 内幕交易披露 | 交易后 2 个工作日内 |
13F | 机构持仓(AUM 超过 1 亿美元的基金) | 季度结束后 45 天 |
S-1 | IPO 注册 | 上市时 |
13D / 13G | 超过 5% 实益所有权披露 | 达到门槛后 10 天内 |
对于内幕交易,请特别参阅专门的 insider-trading 包——它以更清晰的模式呈现 Form 4 / 13D / 13G 的变动。
常见陷阱
概念名称漂移。 SEC 申报人偶尔会更改他们为收入标记的 XBRL 概念。默认的
Revenues概念对于较新的财年可能已过时;请尝试使用RevenueFromContractWithCustomerExcludingAssessedTax作为备选。期间不匹配。 各公司的财年结束时间不同(苹果 = 9 月,微软 = 6 月,谷歌 = 12 月)。进行比较时,务必披露期间。
CIK 格式。 某些端点需要零填充的 10 位数字(
0000320193),某些需要未填充的(320193)。Pipeworx 两种都接受;edgar_ticker_to_cik中的cik_padded字段是资源 URI 的规范形式。近似实时,而非实时。 申报文件在提交后几分钟内就会出现在 EDGAR 上,但 Pipeworx 会缓存结果。如需突发新闻级别的时效性,请设置
Cache-Control: no-cache(适用匿名限制),或查看_meta.cache.fresh_until字段。概念可用性不同。 较小的申报人标记的 XBRL 概念比大公司少。
edgar_company_concept可能会对该公司确实不报告的合法概念返回空数组。请使用edgar_company_facts查看公司实际报告哪些概念。
快速开始
添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"edgar": {
"url": "https://gateway.pipeworx.io/edgar/mcp"
}
}
}这个端点实际提供什么
tools/list 在 https://gateway.pipeworx.io/edgar/mcp 返回上表中的工具,以及共享的 Pipeworx 元工具——ask_pipeworx、discover_tools、search_within、remember/recall 以及其余网关级工具集。因此你看到的工具数量比这个表要多:一个单包端点目前会列出大约 30 个共享工具以及该包自己的工具。连接的 initialize 响应会说明其确切范围,并且是特定日期的权威答案。
这是有意为之,而不是意外的多路复用。元工具正是让限定范围的连接能够回答该包未涵盖的问题——通过 ask_pipeworx,它会在整个目录中路由——而无需你添加第二个 MCP 服务器。目前没有办法在不包含元工具的情况下挂载包端点;如果额外模式消耗的上下文比路由带来的价值还多,请一次性连接到完整网关,而不是连接到多个包端点。
或者连接到完整的 Pipeworx 网关,直接列出每个包的工具,而不仅仅是这一个:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}两个 URL 都到达同一个网关和相同的 1476+ 个数据源。唯一的区别是哪个包的工具被直接列出;ask_pipeworx 从两者中的任何一个都能访问所有工具。
与 ask_pipeworx 一起使用
无需直接调用工具,你可以用纯英语提问——这在上面的包端点和完整网关上都可以使用:
ask_pipeworx({ question: "your question about Edgar data" })网关会自动选择正确的工具并填写参数。
更多
许可证
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
SEC EDGAR filings for AI agents: company lookup, filings, financials, insider trades. No keys.
SEC EDGAR filings for AI agents: company lookup, filings, financials, insider trades. No keys.
Search SEC filings, read 10-K/8-K, query XBRL facts, track Form 4 insider trades.
SEC EDGAR 10-K/10-Q/8-K filings and XBRL company facts by ticker, CIK or company name.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables to search and retrieve SEC EDGAR filings, insider transactions, major shareholders, and executive compensation data through natural language.13 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables querying of SEC EDGAR filings and financial data via natural language, offering tools for company lookup, filing retrieval, XBRL data, and full-text search.72 npmMIT
- AlicenseNot gradedqualityBmaintenanceProvides access to SEC EDGAR data through natural language, including company filings, financial statements, and company info, without requiring an API key.MIT
- AlicenseNot gradedqualityBmaintenanceProvides free SEC filing fundamentals for US public companies, including financial statements, 10-K/10-Q summaries, and 8-K event histories. No API key or signup required.MIT