sec-edgar-mcp
模型与 MCP 活跃维护

sec-edgar-mcp

SEC-API-io/sec-edgar-mcp

MCP协议直连Claude、ChatGPT等50余款AI代理,免安装免托管即可读取SEC EDGAR数据,自动获取财报、招股书与官方披露,供模型引用权威信息。

1
Stars 标星
0
Forks 分支
1
Watchers 关注
0
Open Issues
Other
主要语言
MIT
开源协议
7.4 MB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:SEC-API-io/sec-edgar-mcp
git clone https://github.com/SEC-API-io/sec-edgar-mcp.git
git clone git@github.com:SEC-API-io/sec-edgar-mcp.git
README.md master
# SEC EDGAR Data MCP Give any AI agent access to SEC EDGAR data. No install, no local process, no API wrapper to maintain. Access 20 million filings over one hosted MCP server. [![Claude](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Claude-D97757?logo=claude&logoColor=fff)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/claude-desktop.md) [![Claude Code](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Claude_Code-D97757?logo=claude&logoColor=fff)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/claude-code.md) [![ChatGPT](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/ChatGPT-000000)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/chatgpt-developer-mode.md) [![Codex](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Codex-000000)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/codex-cli.md) [![Gemini](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Gemini-4285F4?logo=googlegemini&logoColor=fff)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/google-gemini-cli.md) [![Cursor](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Cursor-000?logo=cursor&logoColor=fff)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/cursor.md) [![VS Code](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/VS_Code-0098FF)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/vs-code-copilot.md) [![Windsurf](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Windsurf-09B6A2?logo=windsurf&logoColor=fff)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/windsurf.md) [![Zed](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Zed-084CCF?logo=zedindustries&logoColor=fff)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/zed.md) [![JetBrains](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/JetBrains-000?logo=jetbrains&logoColor=fff)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/jetbrains-ai-assistant.md) [![Perplexity](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Perplexity-1FB8CD?logo=perplexity&logoColor=fff)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/perplexity.md) [![Le Chat](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Le_Chat-FA520F?logo=mistralai&logoColor=fff)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/mistral-le-chat.md) [![LangChain](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/LangChain-1C3C3C?logo=langchain&logoColor=fff)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/langchain-and-langgraph.md) [![n8n](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/n8n-EA4B71?logo=n8n&logoColor=fff)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/n8n.md) [**+ 41 more clients**](https://github.com/SEC-API-io/sec-edgar-mcp/blob/master/docs/setup/README.md), from Cline and Goose to LlamaIndex, CrewAI and Zapier. [![Documentation](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Documentation-sec--api.io-blue)](https://sec-api.io/docs/mcp-server) [![License: MIT](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/License-MIT-green.svg)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/LICENSE) [![Tools](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Tools-49-orange)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/tools/README.md) [![Clients](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/Clients-55-blueviolet)](https://raw.githubusercontent.com/SEC-API-io/sec-edgar-mcp/master/docs/setup/README.md)

MCP server URL:

https://api.sec-api.io/mcp?apiKey=YOUR_API_KEY

Get an API key at sec-api.io.

./assets/intro.gif

Quarterly earnings Institutional holdings Executive pay
Form 8-K Item 2.02 and 10-Q risk factors Form 13F holdings Executive compensation

Quick start

Add this to your client's MCP configuration:

{
  "mcpServers": {
    "sec-api": {
      "type": "http",
      "url": "https://api.sec-api.io/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

Restart the client. It should report 49 tools.

Your client does not use JSON config? See the
setup guides for per-client instructions.

What you get

Coverage Detail
20M+ EDGAR filings, 100M+ exhibits From license agreements, investor presentations and other Reg FD disclosures, over insider trading, credit and bond agreements, bylaws, IPOs, secondaries and shelf offerings, M&A terms, government contracts, audit reports, SEC enforcement actions, AAERs and executive employment agreements, to board composition, subsidiaries, public float and cybersecurity incidents.
1.1M+ entities, survivorship-bias free Every SEC-regulated filer that ever reported, including delisted companies, dissolved funds, terminated advisers and entities no longer reporting. Insiders, public and private companies, financial advisers, ETFs, mutual funds, hedge funds, money-market funds, institutional investors, foreign private issuers, BDCs, REITs, shell companies, brokers, dealers, asset-backed securities issuers and SROs.
All 500+ EDGAR form types Annual and quarterly reports (10-K, 10-Q, 20-F, 40-F), proxy statements (DEF 14A, PRE 14A) and proxy voting records, registration statements and prospectuses, and everything in between, including form types no longer in use.
Full historical range, 1993 to present Updated in real time as EDGAR ingests new filings.

All of it reaches your agent through the 49 tools
below. Documents come back as raw source, PDF or a single extracted section.
Structured data comes back as JSON.

Examples

Questions and AI-generated answers. Click to expand.

Find the link to NVIDIA's latest 8-K.
NVIDIA's most recent 8-K was filed on **2 July 2026**, reporting under Item 5.02, departure or appointment of directors and officers. - Document: [nvda-20250628.htm](https://www.sec.gov/Archives/edgar/data/1045810/000104581026000060/nvda-20250628.htm) - Filing index: [0001045810-26-000060-index.htm](https://www.sec.gov/Archives/edgar/data/1045810/000104581026000060/0001045810-26-000060-index.htm) - Accession number: `0001045810-26-000060` Want the full text of Item 5.02?
Summarize the differences between the risk factors from Lam Research's two most recent 10-K filings.
Comparing the [FY2026 10-K](https://www.sec.gov/Archives/edgar/data/707549/000070754926000037/lrcx-20260628.htm) and the [FY2025 10-K](https://www.sec.gov/Archives/edgar/data/707549/000070754925000075/lrcx-20250629.htm), risk disclosure grew by about 20 percent. Three changes stand out. **New legal exposure.** Lam now warns that law enforcement may investigate or charge the company or its employees over improper receipt or misuse of designated technology or third-party confidential information under national and economic-security measures, with civil or criminal liability. **Cybersecurity risk doubled in length.** The 2026 filing names specific threats for the first time: prompt injection, ransomware, and state-sponsored intrusion. **A compliance admission.** The regulatory factor now concedes "there have been, and may continue to be, instances of our compliance policies and procedures not being effective." ...
Summarize the debt covenants in Boeing's most recent credit agreement.
Boeing's most recent facility is a **$3.0 billion 364-day credit agreement** signed in August 2025, with Citibank and JPMorgan Chase as syndication agents. | Covenant | Term | | ----------------- | ------------------------------------------------ | | Leverage ratio | Maximum consolidated debt to total capital | | Minimum liquidity | Floor on unrestricted cash and equivalents | | Negative pledge | Restricts liens on principal properties | | Cross-default | Triggers on other indebtedness above a threshold | | ERISA liability | Capped at a stated amount | | ... | ... |
What are the terms of Plug Power's latest shelf offering?
Plug Power filed a [**Form S-3ASR**](https://www.sec.gov/Archives/edgar/data/1093691/000110465925052737/tm2515625-1_s3asr.htm) in May 2025 covering a **$1 billion at-the-market common stock offering**, later updated by a [424B5](https://www.sec.gov/Archives/edgar/data/1093691/000110465925079028/tm2523585-1_424b5.htm). - Initial sales agent: B. Riley Securities - Later sales agent: Yorkville Securities - Commission: 3.0 to 5.0 percent of gross proceeds - ...
Summarize the latest earnings from the technology sector.
**212** Item 2.02 earnings filings from technology companies between 1 and 12 August 2026. - **AMD**: Q2 revenue of $11.536 billion, up 50 percent year over year. - **Arista Networks**: first $3 billion quarter. - **Palantir**: the outlier, with 93 percent revenue growth. - ...
Which companies disclosed a cybersecurity incident this quarter?
Seven Form 8-K Item 1.05 filings between July and August 2026. Three are new disclosures. | Company | Incident | Filing | | ----------- | ----------------------------- | --------------------------------------------------------------------------------------------------------------- | | Amgen | Cloud data exfiltration | [0000318154-26-000119](https://www.sec.gov/Archives/edgar/data/318154/000031815426000119/amgn-20260729.htm) | | Navient | Ransomware attack | [0001140361-26-027441](https://www.sec.gov/Archives/edgar/data/1593538/000114036126027441/ef20077249_8k.htm) | | AdaptHealth | Social engineering compromise | [0001104659-26-080297](https://www.sec.gov/Archives/edgar/data/1725255/000110465926080297/ahco-20260627x8k.htm) | | ... | ... | ... |

More worked examples, with the tool calls behind them, in
use cases.

Tools

Full reference with input schemas, response shapes and examples:
docs/tools/README.md

Tool Purpose Category
filing-search Search SEC EDGAR filings from 1993 to present to retrieve metadata Search and discovery
full-text-search Full-text search over SEC EDGAR filings Search and discovery
filing-to-pdf Fetch any SEC EDGAR filing and exhibit as PDF Filings and documents
get-edgar-file Download any SEC EDGAR filing or exhibit in its original format Filings and documents
extractor Extract a section from a 10-K/10-Q/8-K filing Filings and documents
xbrl-to-json Convert XBRL financials to normalized JSON Filings and documents
form-13f-holdings Search Form 13F institutional holdings Ownership and insiders
form-13f-cover-pages Search Form 13F cover pages Ownership and insiders
form-13d-13g Search Schedule 13D/13G beneficial-ownership filings Ownership and insiders
insider-trading Search insider trading disclosures (Form 3/4/5) Ownership and insiders
form-144 Search Form 144 intent-to-sell filings Ownership and insiders
form-nport Search Form N-PORT fund portfolio holdings Funds
form-npx Search Form N-PX proxy voting records Funds
form-npx-file Get a Form N-PX file by accession number Funds
form-ncen Search Form N-CEN investment company census Funds
form-adv-firms Search Form ADV firm registrations Investment advisers
form-adv-individuals Search Form ADV individual registrations Investment advisers
form-adv-brochures Get Form ADV Part 2 brochures for an adviser Investment advisers
form-adv-schedule-a-direct-owners Get Form ADV Schedule A, direct owners of an adviser Investment advisers
form-adv-schedule-b-indirect-owners Get Form ADV Schedule B, indirect owners of an adviser Investment advisers
form-adv-schedule-d-1-b Get Form ADV Schedule D-1-B, other business names Investment advisers
form-adv-schedule-d-5-k Get Form ADV Schedule D-5-K, separately managed accounts Investment advisers
form-adv-schedule-d-7-a Get Form ADV Schedule D-7-A, financial industry affiliations Investment advisers
form-adv-schedule-d-7-b-1 Get Form ADV Schedule D-7-B-1, private funds advised Investment advisers
form-s1-424b4 Search S-1 / 424B4 registration filings Offerings and registrations
form-d Search Form D private-placement filings Offerings and registrations
form-c Search Form C Regulation Crowdfunding offerings Offerings and registrations
form-8k Search structured 8-K material-event filings Offerings and registrations
reg-a-search Search Regulation A / A+ offerings Offerings and registrations
reg-a-form-1a Search structured Reg A Form 1-A filings Offerings and registrations
reg-a-form-1k Search structured Reg A Form 1-K filings Offerings and registrations
reg-a-form-1z Search structured Reg A Form 1-Z filings Offerings and registrations
compensation Search executive compensation data Governance and compensation
compensation-by-key Get executive compensation by CIK or ticker Governance and compensation
audit-fees Search auditor / audit-fee disclosures Governance and compensation
directors-and-board-members Search directors and board members Governance and compensation
float Fetch public float and share count Company and entity
subsidiaries Search Exhibit 21 subsidiary disclosures Company and entity
edgar-entities Search EDGAR entity master Company and entity
mapping Company identifier mapping (CIK/ticker/CUSIP/name) Company and entity
sec-enforcement-actions Search SEC enforcement actions Enforcement
sec-litigation-releases Search SEC litigation releases Enforcement
sec-administrative-proceedings Search SEC administrative proceedings Enforcement
aaers Search Accounting and Auditing Enforcement Releases (AAER) Enforcement
aaer-file Fetch an AAER document file Enforcement
sro Search SRO (self-regulatory organization) rule filings Enforcement
form-x-17a-5 Search Form X-17A-5 (broker-dealer FOCUS reports) Broker-dealers
edgar-ingestion-log Get all SEC filings ingested at a date Ingestion logs
api-key-usage Get sec-api API key monthly bandwidth usage Account

Documentation

Guide What it covers
Getting started Key, config, first query, in five minutes
Setup guides Per-client configuration for every MCP client
Tool reference All 49 tools, one page each
Query language Lucene syntax and the field vocabulary
Authentication Key handling and rotation
Transport Streamable HTTP, and the stdio bridge
Response format Envelopes, text blocks, raw documents
Limits and errors Paging and error text

Transport

The server is remote and speaks Streamable HTTP. There is nothing to install and
no stdio server to run.

Clients that only support stdio can bridge to it:

npx mcp-remote https://api.sec-api.io/mcp?apiKey=YOUR_API_KEY

Verify the server from a terminal without any client:

curl -s https://api.sec-api.io/mcp?apiKey=YOUR_API_KEY \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Limits

Some tools return large payloads. See
limits and errors before wiring them into an
agent loop.

Citation

@software{secapi_sec_edgar_mcp,
  author  = {{SEC-API.io}},
  title   = {{SEC EDGAR MCP: Model Context Protocol server for SEC EDGAR filings}},
  year    = {2026},
  version = {1.1.1},
  url     = {https://github.com/sec-api/sec-edgar-mcp}
}

See CITATION.cff.

License

MIT. Use of the MCP server is governed by the
sec-api.io terms.

Need help?

Contact us at support@sec-api.io.