SEC EDGAR MCP Server
Summary: A read-only MCP server (stdio) that resolves a stock ticker to its SEC CIK and returns filing metadata with official EDGAR links — no API key needed, and no filing contents are ever read.
get_latest_filing— returns the newest filing for a ticker, optionally restricted to exact form types (e.g.["10-K"]), with filing date, accession number, and SEC index/primary-document links.list_filings_by_year— lists every filing a company submitted in a given calendar year (by filing date, not fiscal year), newest first, filterable by form type and paged vialimit/offset.list_form_types— shows valid EDGAR submission-type codes (with descriptions and filing counts) from a bundled quarterly snapshot, usable to learn whatformsaccepts.Resources — read the same data as JSON by ticker or CIK:
edgar://companies/{ticker}/profile,/latest,edgar://issuers/{cik}/profile,/latest, andedgar://form-types.Prompts — ready-made instructions for reviewing a latest filing, reviewing a year of filings, and explaining form types.
Robust results — every tool returns a
status(ok,not_found,ambiguouswith candidate issuers,invalid_inputwith the offending field,upstream_errorwith retry hints) so clients can act without protocol errors.Fair-access handling — rate limiting (≤10 req/s), caching, retries with backoff, and a configurable
User-Agentvia environment variables.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SEC EDGAR MCP Server Show me Apple's latest 10-K filing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SEC EDGAR MCP Server
A read-only Model Context Protocol server, over stdio, that
takes a stock ticker, resolves it to the SEC's Central Index Key (CIK), and returns filing
metadata with official EDGAR links. It exposes three tools, five resources and three prompts.
No API key is needed: SEC EDGAR is public, and the server only identifies itself with a
descriptive User-Agent. The server never reads, downloads or summarises filing contents; it
tells you which filings exist and where they are on sec.gov.
Published on PyPI as mcp-server-edgar and listed
on the Official MCP Registry
as io.github.SudiptoHaldar/mcp-server-edgar.
Install and run
The server is a Python package with a console entry point. The simplest way to run it is with uv, which fetches Python 3.11 or newer when needed:
uvx mcp-server-edgarOr install it into any environment with Python 3.11 or newer:
pip install mcp-server-edgar
mcp-server-edgarThe executable speaks MCP on stdin and stdout and is meant to be launched by an MCP client, so on its own it waits for a client. To try it interactively, use the MCP Inspector:
npx -y @modelcontextprotocol/inspector uvx mcp-server-edgarRelated MCP server: Ticker Scout MCP server
Configure your MCP client
Claude Desktop and most other JSON-configured clients take an mcpServers entry. The optional
env block sets the SEC fair-access contact (see Configuration):
{
"mcpServers": {
"sec-edgar": {
"command": "uvx",
"args": ["mcp-server-edgar"],
"env": {
"MCP_EDGAR_USER_AGENT": "acme-research/1.0 (ops@acme.example)"
}
}
}
}Claude Code:
claude mcp add sec-edgar -- uvx mcp-server-edgarTools
All three tools are read-only and return a JSON object whose status field says what happened
(see Results and errors). Years always refer to the filing date, the day the SEC received a
filing, never to the period the filing covers.
get_latest_filing — Latest SEC filing
Newest filing for a ticker, optionally restricted to given form types.
Argument | Type | Default | Meaning |
| string | required | Stock ticker, e.g. |
| list of strings | all forms | Exact form types, case-insensitive: |
| string or integer | none | SEC CIK (1–10 digits), only after an |
Example call get_latest_filing("AAPL", ["10-K"]); result abridged, values as of 2026-11-01:
{
"status": "ok",
"company": {"cik": "0000320193", "name": "Apple Inc.", "ticker": "AAPL", "exchange": "Nasdaq"},
"forms": ["10-K"],
"filing": {
"form": "10-K",
"filing_date": "2025-10-31",
"report_date": "2025-09-27",
"accession_number": "0000320193-25-000079",
"filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
"primary_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
},
"message": "Newest 10-K by Apple Inc. (AAPL): filed 2025-10-31."
}filing is null when the company has no filing of the requested forms.
list_filings_by_year — Filings by year
Every filing a company submitted during one calendar year, newest first, in pages.
Argument | Type | Default | Meaning |
| string | required | As above |
| integer | required | Calendar year of the filing date, 1993 or later; a future year returns an empty list |
| list of strings | all forms | As above |
| integer | 100 | Page size; larger values are clamped to the server's cap |
| integer | 0 | Filings to skip; pass the previous result's |
| string or integer | none | As above |
The year is the filing year, not the fiscal year: Apple's 10-K for the fiscal year ending
September 2025 was filed on 2025-10-31, so it belongs to year=2025; a 10-K filed in January
2026 for a fiscal year 2025 belongs to year=2026. Older years are served from the SEC's
history files automatically.
Example call list_filings_by_year("AAPL", 2025, ["10-K", "10-Q"]); result abridged, values as
of 2026-11-01:
{
"status": "ok",
"company": {"cik": "0000320193", "name": "Apple Inc.", "ticker": "AAPL", "exchange": "Nasdaq"},
"year": 2025,
"forms": ["10-K", "10-Q"],
"limit": 100,
"offset": 0,
"total_count": 4,
"returned_count": 4,
"next_offset": null,
"filings": [
{
"form": "10-K",
"filing_date": "2025-10-31",
"report_date": "2025-09-27",
"accession_number": "0000320193-25-000079",
"filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
"primary_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
}
],
"message": "Apple Inc. (AAPL): 4 filings of form 10-K, 10-Q with a filing date in 2025."
}To page, call again with offset set to next_offset until it is null. Pages never overlap.
A year with no filings is ok with total_count 0.
list_form_types — EDGAR form types
The EDGAR submission-type codes filed in recent quarters, most common first. Use it to learn
which values forms accepts: form is exactly the code EDGAR uses (10-K, 10-K/A,
SCHEDULE 13G/A, 424B2, NPORT-P).
Argument | Type | Default | Meaning |
| string | none | Case-insensitive text matched against the code and its description; |
| integer | 100 | Entries per page |
| integer | 0 | Entries to skip; pass the previous |
The catalogue is a snapshot bundled with the package, counted over the four completed
quarters before the release and refreshed with each release; catalogue.generated_on and
catalogue.quarters say which. Calling it makes no request to the SEC. description and
topics come from the SEC Forms List when the form number is known, otherwise null.
Example call list_form_types("10-K"); result abridged, values as of 2026-11-01:
{
"status": "ok",
"query": "10-K",
"total_count": 6,
"returned_count": 6,
"next_offset": null,
"catalogue": {"generated_on": "2026-11-01", "quarters": ["2025Q4", "2026Q1", "2026Q2", "2026Q3"]},
"form_types": [
{"form": "10-K", "description": "Annual report pursuant to Section 13 or 15(d)", "amendment": false, "filings": 6723},
{"form": "10-K/A", "description": "Annual report pursuant to Section 13 or 15(d)", "amendment": true, "filings": 616}
],
"message": "6 form types match '10-K' in 2025Q4-2026Q3."
}Results and errors
Every tool answers with a JSON object. Anticipated conditions are reported in status, never as
a protocol error, so a client can act on them:
| Meaning | Also carries |
| The request succeeded |
|
| No SEC issuer is listed under the ticker | — |
| Several issuers share the ticker; none is chosen |
|
| An argument was rejected before any request was made |
|
| SEC EDGAR did not answer in time, was rate-limited or returned bad data |
|
Every object also carries a one-line message. A filing record always has form,
filing_date, report_date (the period covered, context only, may be null),
accession_number and filing_url (the official filing index page on sec.gov);
primary_document_url points at the main document when the SEC lists one and the file name is
safe, otherwise it is null.
Resources
Clients that can attach resources as context may read these JSON documents directly, without a tool call. They are built by the same code path as the tools, so a resource and its tool always agree.
URI | Payload |
|
|
|
|
| The profile addressed by CIK (any 1–10-digit spelling) |
| The latest filing addressed by CIK |
|
|
Use the edgar://issuers/{cik}/… routes when a ticker is ambiguous; the CIK must be listed in
the SEC ticker map. Resources have no status envelope: an unknown ticker, a malformed or
unlisted CIK or an unmatched URI is a resource-not-found error, and an ambiguous ticker or an
SEC outage is a resource error, each carrying the same message text the tools use.
Prompts
Prompts are reusable instructions a person selects from the client's prompt menu; the client inserts the rendered text and the model then uses the tools. They carry no live data.
Prompt | Title | Arguments | The rendered text asks the model to |
| Review latest SEC filing |
| call |
| Review filings for a calendar year |
| call |
| Explain EDGAR form types |
| call |
Every prompt ends with the same guardrails: metadata and official sec.gov links only, the server
does not read filing contents, cite the EDGAR link for every filing, give no investment advice,
and on an ambiguous answer ask which issuer is meant before calling again with that cik.
Configuration
All settings are environment variables with defaults. Unset or empty values take the default; a bad value stops startup with exit code 1 and one line on stderr naming the variable.
Variable | Default | Accepted | Purpose |
|
| non-empty, must contain | SEC fair-access identification with a maintainer contact; set your own |
|
| number > 0 | HTTP timeout for SEC requests |
|
| integer ≥ 0 (0 = no cache) | Cache lifetime of the SEC ticker map |
|
| integer ≥ 0 | Cache lifetime of a company's submissions |
|
| integer 1..1000 | Largest page |
|
| integer 1..10 | Request ceiling; the SEC allows at most 10 requests per second and the server cannot be set higher |
|
|
| Log level |
The SEC asks every automated client to identify itself with a contact address, so set
MCP_EDGAR_USER_AGENT to your own product name and e-mail. Logs go to stderr only; stdout
carries the protocol.
How it uses SEC EDGAR
Ticker to CIK:
https://www.sec.gov/files/company_tickers_exchange.json, cached for a day. One ticker listed under several CIKs is reported asambiguous; one CIK with several tickers (GOOGL,GOOG) is one issuer.Filings:
https://data.sec.gov/submissions/CIK##########.json(CIK zero-padded to ten digits), cached for an hour. Older years are read from the history files the submissions document lists, and only those whose date range overlaps the requested year.Links: the filing index page
…/Archives/edgar/data/<cik>/<accession>/<accession>-index.htmis always returned; the primary document link is built from the SEC's file name after rejecting anything that is not a plain file name.Fair access: at most 10 requests per second, a descriptive
User-Agent, in-memory caching per process, and bounded retries with backoff on HTTP 429 and transient 5xx responses. When the SEC still does not answer, the tool returnsupstream_errorwith a retry hint rather than an empty result. See the SEC's EDGAR API documentation.
Known limits
Metadata and links only: no filing contents, no XBRL financial facts, no summaries, no investment advice.
yearmeans the calendar year the SEC received the filing, not the fiscal year it reports on.Years before 1993 (the start of electronic filing) are rejected as
invalid_input.Only issuers in the SEC ticker map can be looked up; funds and private filers without a listed ticker are out of scope, and the server never queries an arbitrary CIK.
The form-type catalogue is a snapshot taken before each release, not a live list.
Transport is stdio only; there is no HTTP endpoint and no authentication.
Caches live in memory for the lifetime of one server process.
This project is not affiliated with or endorsed by the U.S. Securities and Exchange Commission.
Development
git clone https://github.com/SudiptoHaldar/mcp_server_edgar
cd mcp_server_edgar
uv sync
uv run pytest -q # unit tests never touch the network
uv run pytest -q -m live # opt-in checks against the real SEC
uv run ruff check .
uv run mcp dev src/mcp_edgar/server.py # MCP Inspector GUI
uv run python scripts/inspector_checklist.py # 27-row CLI checklist (needs Node and network)Before a release, refresh the bundled form-type catalogue, then build:
uv run python scripts/refresh_form_types.py
uv buildReleases are published by the tag-triggered workflow in .github/workflows/release.yml: a
vX.Y.Z tag on this repository builds, publishes to PyPI (Trusted Publishing, with attestations)
and to the MCP Registry, and verifies both.
Issues and pull requests: https://github.com/SudiptoHaldar/mcp_server_edgar/issues.
License
MIT, see LICENSE. SEC EDGAR data is public domain and is served here under the SEC's fair-access rules.
Available Tools
3 toolsget_latest_filingLatest SEC filingARead-onlyIdempotent
Newest SEC filing for a stock ticker, with official EDGAR links.
Resolves the ticker to its SEC CIK and returns the filing with the latest filing_date
(the date the SEC received it). forms restricts the search to exact form types,
case-insensitive: ["10-K"] matches 10-K but not 10-K/A; omit it to consider every
form. report_date (the period the filing covers) is returned as context only, so a 10-K
filed in January 2026 for the fiscal year ending September 2025 has a 2026 filing_date.
Args:
ticker: Stock ticker symbol, e.g. "AAPL". Case and surrounding whitespace are
ignored; BRK.B and BRK-B are equivalent.
forms: Optional list of SEC form types, e.g. ["10-K", "10-Q"].
cik: Optional SEC CIK (1-10 digits, string or integer) to pick one issuer when a
previous call returned "ambiguous"; it must be listed under ticker.
Returns:
A JSON object with status and a one-line message. On "ok": company {cik, name,
ticker, exchange}, forms (normalised list or null) and filing {form, filing_date,
report_date, accession_number, filing_url, primary_document_url}, or filing null when
the company has no filing of those forms; filing_url (the filing index page) is
always present, primary_document_url may be null. The other statuses (not_found,
ambiguous with candidates, invalid_input with field, upstream_error with
retryable) are defined in the server instructions.
Example:
get_latest_filing("AAPL", ["10-K"]) returns Apple's most recent annual report.
Inputs: ticker (required), cik, forms. Returns: object
list_filings_by_yearFilings by yearARead-onlyIdempotent
Filings a company submitted to the SEC during one calendar year, newest first, paged.
year selects filings by filing_date, the date the SEC received the filing, not by
report_date (the period the filing covers): a 10-K for the fiscal year ending September
2025 that was filed in January 2026 belongs to year=2026. forms restricts the list to
exact form types, case-insensitive (["10-K"] matches 10-K but not 10-K/A). Older
years are served from the SEC's history files automatically.
Args:
ticker: Stock ticker symbol, e.g. "AAPL"; case and surrounding whitespace are ignored.
year: Calendar year of the filing date, 1993 or later; a future year returns an empty list.
forms: Optional list of SEC form types, e.g. ["10-K", "10-Q"]; omit it for every form.
limit: Page size (default 100); larger values are clamped to the server's cap.
offset: Filings to skip, for paging; pass the previous result's next_offset.
cik: Optional SEC CIK (1-10 digits, string or integer) to pick one issuer when a
previous call returned "ambiguous"; it must be listed under ticker.
Returns:
A JSON object with status and a one-line message. On "ok": company {cik, name,
ticker, exchange}, year, forms, limit (the effective page size), offset,
total_count, returned_count, next_offset (null on the last page) and filings
(newest first; each has form, filing_date, report_date, accession_number, filing_url,
primary_document_url); an empty year is "ok" with total_count 0. Page with
offset=next_offset until null. The other statuses (not_found, ambiguous with
candidates, invalid_input with field, upstream_error with retryable) are
defined in the server instructions.
Example:
list_filings_by_year("AAPL", 2025, ["10-K", "10-Q"]) lists Apple's 2025 reports.
Inputs: year (required), ticker (required), cik, forms, +2 more. Returns: object
list_form_typesEDGAR form typesARead-onlyIdempotent
EDGAR form types (submission-type codes) filed in recent quarters, most common first.
Use this to learn which values the forms argument of get_latest_filing and
list_filings_by_year accepts: form is exactly the code EDGAR uses (10-K, 10-K/A,
SCHEDULE 13G/A, 424B2, NPORT-P). The list is a snapshot bundled with the server (see
catalogue.generated_on and catalogue.quarters); filings counts filings of that type
over those quarters; description and topics come from the SEC Forms List when the form
number is known, otherwise null. Amendments end with /A. No request is made to the SEC.
Args:
query: Optional case-insensitive text matched against the code and description
("10-K" lists 10-K, 10-K/A, 10-KT, ...; "/A" lists amendments).
limit: Maximum entries per page (default 100; clamped to the server's cap).
offset: Entries to skip, for paging; pass the previous result's next_offset.
Returns:
A JSON object with status and a one-line message. On "ok": query, limit,
offset, total_count, returned_count, next_offset (null on the last page),
catalogue {generated_on, quarters, sources} and form_types (each: form,
description, amendment, filings, topics). "invalid_input" carries field, as
defined in the server instructions; no other status occurs.
Example:
list_form_types("13G") lists the Schedule 13G submission types and their counts.
Inputs: limit, query, offset. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct need: paged historical listings by year, the single newest filing, and a static form-type catalogue. The only soft overlap is that `get_latest_filing` is semantically a special case of `list_filings_by_year` with a form filter, but the descriptions make the boundary clear (latest vs. paged by year).
All three tools use snake_case verb_noun naming with consistent `list_`/`get_` prefixes (`list_filings_by_year`, `get_latest_filing`, `list_form_types`). The `_by_year` qualifier is descriptive rather than inconsistent, and the resource nouns are unambiguous.
Three tools are internally coherent and each earns its place, but the surface feels thin for a general 'SEC EDGAR' server. There is no way to resolve a ticker/CIK on its own, retrieve a filing by accession number, or search filings across companies, which are natural first-class operations.
Core lookups (list by year/form, latest filing, valid form codes) are covered, and responses expose accession numbers and EDGAR URLs. However, there is no lifecycle beyond listing: no fetch-by-accession-number, no document/section content retrieval, no company profile/ticker lookup, and no cross-issuer form search, leaving agents with dead ends after obtaining a URL.
Maintenance
Related MCP Connectors
Resolves all 10,000+ US public stock tickers to SEC CIK numbers, recent 10-K/10-Q/8-K filings, an.
SEC EDGAR 10-K/10-Q/8-K filings and XBRL company facts by ticker, CIK or company name.
Resolves stock tickers to SEC CIK numbers, recent 10-K/10-Q/8-K filings, and entity metadata.
Look up SEC EDGAR filings and get alerts when a watched company files or a form type appears.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables deep analysis of SEC EDGAR filings through universal company search, document content extraction, and advanced filing search capabilities. Provides AI-ready access to business descriptions, risk factors, financial statements, and full-text search across any public company's SEC documents.-
- 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.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching SEC EDGAR for companies, retrieving recent filings (e.g., 10-K, 10-Q), and accessing structured XBRL financial facts.143 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables querying SEC EDGAR public company filings and XBRL financial data, such as 10-K, 10-Q, 8-K, insider trading disclosures, and revenue trends, without authentication.286 npm1MIT