io.github.cyanheads/secedgar-mcp-server
v0.15.13Query SEC EDGAR filings, XBRL financials, and company data via MCP. STDIO or Streamable HTTP.
Endpoint health
online- Last checked
- 11/20/2026, 9:18:08 AM
- Latency
- 246 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Fsecedgar-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/secedgar-mcp-server": {
"url": "https://secedgar.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
16 shown · authentication unknown
Secedgar Company Search
secedgar_company_search
Find companies and retrieve entity info with optional recent filings. Entry point for most EDGAR workflows — resolves tickers, names, or CIKs to entity details, with accession numbers in the result feeding secedgar_get_filing for document content. A name SEC's ticker file misses is looked up in EDGAR's entity index of every filer, then in 10-K subsidiaries exhibits, whose filers the not-found error names as possible parents. When a date or form filter carries the scan past the recent submissions window, the full filtered filing history is also staged as df_<id> — inspect it with secedgar_dataframe_describe, then analyze it with secedgar_dataframe_query.
Schema valid · SHA-256 0f2c6738a635…
View input schema
{ "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "description": "Company ticker symbol (e.g., \"AAPL\", \"VOO\"), name (e.g., \"Apple\"), or CIK number (e.g., \"320193\"). Ticker is the fastest lookup and works for equities, ETFs, and mutual funds; a multi-class share ticker resolves in either form (\"BRK-B\" or \"BRK.B\"), and an uppercase ticker also resolves as market-data feeds write it: venue-coded (\"UEC.N\"), a preferred class run together (\"CFGPH\"), or a class root (\"GLOP\"). Name search matches current and former names, preferring a name the query matches exactly over one it only starts or appears in, and never matching from inside a word (\"SY Bancorp\" does not find \"Embassy Bancorp\"); an exact or starts-with match ignores commas, periods, apostrophes, extra spaces, and the spaces between single initials (\"QXO Inc\" finds \"QXO, Inc.\"; \"U.S. Bancorp\" finds \"US BANCORP\"; \"Macys\" finds \"Macy's, Inc.\"; \"JM Smucker\" finds \"J M SMUCKER Co\"). The corporate suffix (Inc, Corp, Co, Ltd, PLC, LLC, LP, N.V., S.A., AG, SE) can be left off (\"Apple\" finds \"Apple Inc.\"; \"Rio Tinto\" lists both the Ltd and the PLC) or spelled out (\"Beacon Financial Corporation\" finds \"Beacon Financial Corp\"), but a suffix you include must match — Corp, Inc, Co, and Ltd stay distinct from each other, since separate registrants differ only by which one they use. A name with its words in another order also matches when nothing else does (\"Charles Schwab\" finds \"SCHWAB CHARLES CORP\"). A former ticker resolves to the company that last held it (\"AMRK\" finds Gold.com). A name SEC's ticker file misses is looked up in EDGAR's entity index, which also holds filers with no ticker (\"Exxon Mobil\" finds EXXON MOBIL CORP); a private company found only in a 10-K's subsidiaries exhibit fails as not found, naming the filer of that exhibit as its possible parent." }, "include_filings": { "default": true, "description": "Include recent filings in the response. Set to false for entity-info-only lookups.", "type": "boolean" }, "forms": { "description": "Filter filings to specific form types (e.g., [\"10-K\", \"10-Q\", \"8-K\"]), matched exactly (case-insensitive) — list an amendment such as \"10-K/A\" to include it. Without this, returns all form types.", "type": "array", "items": { "type": "string" } }, "filing_limit": { "default": 10, "description": "Maximum number of filings to return in the inline list; when more match, the notice names where the rest are. Capped at 50: a larger value, up to 1000, returns what 50 returns.", "type": "integer", "minimum": 1, "maximum": 1000 }, "filed_after": { "description": "Only include filings filed on or after this date (YYYY-MM-DD). A date filter routes the scan into the older submissions archive pages, so it reaches filings that predate the recent window — the last year or 1,000 filings, whichever holds more (e.g. a company's 2005 10-K).", "anyOf": [ { "type": "string", "const": "" }, { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "YYYY-MM-DD" } ] }, "filed_before": { "description": "Only include filings filed on or before this date (YYYY-MM-DD). Use alone or with filed_after; together they bound the archive-page scan.", "anyOf": [ { "type": "string", "const": "" }, { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "YYYY-MM-DD" } ] } }, "required": [ "query" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }
Connections
streamable-http
https://secedgar.caseyjhand.com/mcp