Secedgar MCP Server
UnclaimedQuery SEC EDGAR filings, XBRL financials, and company data through MCP. STDIO & Streamable HTTP.
Install
docker run -e EDGAR_USER_AGENT="MyApp my@email.com" -p 3010:3010 secedgar-mcp-serverSet up this server
More in AI & ML
Browse the full directoryUnclaimed listing
Is this your MCP server?
This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.
Claim this serverSecurity profile
Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works
23 of 23 tools
Documented tools (23)
From project documentation. A server handshake does not verify each tool’s description or behavior.
caveats
surface a filer missing one or two calendar quarters, a concept that resolved to a retired XBRL tag for one company, period ends that differ inside one aligned period, and concepts whose unit differs across companies
item_distribution
counts every code across the scanned window before the filter, so a zero-hit filter comes back with the items that are present rather than a dead end
periods
bounds the inline matrix (1-12, default 4) and the window shrinks further when companies x concepts x periods is too large to return in one response; the full aligned series is always materialized as a df<id> dataframe for growth rates and spreads via secedgardataframequery
quarter
targets a reporting period ("2026-Q1"); omit it for the newest quarter whose 45-day filing deadline has passed. The applied quarter and its filing window are echoed back
related_tags
flags alternate-definition tags some filers use as their primary line (e.g. cash → restricted-cash-inclusive total, equity → NCI-inclusive total), so a whole-universe screen on the base tag isn't silently under-inclusive — query those separately
secedgar_company_search
Find companies and retrieve entity info with optional recent filings
secedgar_compare_companies
Compare named companies across several concepts, aligned on calendar periods
secedgar_dataframe_describe
List canvas dataframes with provenance, TTL, and schema
secedgar_dataframe_drop
Drop a canvas dataframe by name. Opt-in via EDGARDATAFRAMEDROPENABLED=true — off by default since TTL already handles cleanup
secedgar_dataframe_query
Run a single-statement SELECT across dataframes
secedgar_fetch_frames
Fetch SEC XBRL frames for one concept × one period across all reporting companies
secedgar_find_holders
Reverse 13F lookup — which institutional managers reported holding an issuer
secedgar_get_beneficial_owners
5%+ blockholders of an issuer, parsed from structured SCHEDULE 13D / 13G filings
secedgar_get_filing
Fetch a specific filing's metadata and document content
secedgar_get_financials
Get historical XBRL financial data for a company
secedgar_get_fund_holdings
ETF and mutual fund portfolio holdings from the quarterly NPORT-P report
secedgar_get_insider_transactions
Form 4 / 4-A insider transactions (buys, sells, grants, exercises) parsed from ownership XML
secedgar_get_institutional_holdings
13F-HR quarterly institutional holdings parsed from the information table
secedgar_get_material_events
8-K filings with item codes decoded and filterable — earnings, officer changes, non-reliance
secedgar_get_snapshot
One-call financial profile — the latest value of every supported concept, grouped by statement
secedgar_search_concepts
Discover supported XBRL concept names or reverse-lookup a raw tag
secedgar_search_filings
Search EDGAR filings since 1993 — full-text (2001+) plus archive-backed browse for pre-2001 ranges
total_holdings_in_filing
counts raw info-table rows; totalpositions counts distinct positions after consolidation (both before limit)
Tool change history
FAQ
Questions about Secedgar MCP Server
- How do I connect Secedgar MCP Server to Claude?
- The listing records `docker run -e EDGAR_USER_AGENT="MyApp my@email.com" -p 3010:3010 secedgar-mcp-server` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Cursor, VS Code as compatible clients.
- Is Secedgar MCP Server free?
- The listed licence is Apache-2.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
- What can Secedgar MCP Server do?
- Secedgar MCP Server documents 23 tools to the agent, including caveats, item_distribution, periods. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.