[Docs](/docs) / SEC EDGAR # SEC EDGAR GA `edgar_search` finds filings, and `edgar_fetch` reads one filing whole or one section of it, or returns the financial facts a company reported in XBRL. Every filing and fact carries the accession number it came from. ## Call it The two tools are served on `/edgar` and, like every tool you have switched on, on `/mcp`. ``` https://mcp.deep.navy/edgar ``` ``` https://mcp.deep.navy/mcp ``` ## Filings deep.navy reads EDGAR's daily form index each day after EDGAR's nightly index update and indexes primary 10-K, 10-Q and 8-K filings. A 400-day backfill covering September 2, 2025 through October 6, 2026 is in progress; complete historical coverage has not yet been verified. An empty search result does not prove that a company has no filings. Historical results become available as ingestion completes; check the SEC source when completeness matters. Companyfacts queries use the SEC API independently of our filing index. **Search.** `edgar_search` finds filings by keywords, by company (a `ticker`, resolved to its CIK, or the `cik` itself), by `formTypes` and by `filedAfter` and `filedBefore`, up to 100 results per call. Continue with `nextPageToken` as `pageToken` and unchanged filters. It needs a query, a ticker or a CIK; without a query it lists the newest filings that match the filters. **Sections.** `edgar_fetch` takes an `accession` or the sec.gov `url` of a filing's primary document and returns it as markdown and text, whole or one `section` by its heading, such as "Item 1A" for risk factors or "Item 7" for MD\&A, with a `truncated` flag when you cap the length with `maxCharacters`. Every filing is labelled by rule `edgar.v1`: a document is a filing only because the sync wrote it from a form index entry, so nothing else can be mistaken for one. EDGAR is read within the SEC's fair-access rules, with a declared user agent and paced request allocations within the SEC’s published ten-requests-per-second fair-access ceiling. See the [SEC access guide](https://www.sec.gov/search-filings/edgar-search-assistance/accessing-edgar-data) and [API documentation](https://www.sec.gov/search-filings/edgar-application-programming-interfaces). ## Facts With a `facts` query, `edgar_fetch` returns XBRL financial facts from EDGAR's companyfacts API instead of a document. **Concepts.** Name the company by `ticker` or `cik` and list the `concepts` you want. Concept names are the company's own XBRL tags, in any taxonomy and matched without regard to case, and `us-gaap:Revenues` pins the taxonomy. Companies tag the same idea differently: Apple reports its revenue as `RevenueFromContractWithCustomerExcludingAssessedTax`, and its last `Revenues` fact is from its 2018 annual report. With no concepts you get every concept, newest facts first. `unmatchedConcepts` lists requested concepts absent from the company facts response. Inspect it and retry with the company’s actual tag rather than treating an omitted value as zero. **Periods.** `periods` takes fiscal years such as `2025` or calendar frames such as `CY2025`, `CY2025Q3` or `CY2025Q3I`. `limit` is 1 to 500 facts, 100 by default, newest period first. ## edgar_search GA It returns filings with their accession number, company, tickers, form type, filing date, reporting period, the document's URL on sec.gov, a matching passage and a score. Pass the accession number to `edgar_fetch`. ### What comes back | Field | Type | Meaning | | ------------------ | --------- | ------------------------------------------------------------------------------------- | | results | Filing\[] | They are the matching filings, best first, or newest first when there is no query. | | results.​accession | string | It is the accession number, such as `0000320193-25-000079`. Pass it to `edgar_fetch`. | | results.​cik | string | It is the company's CIK. | | results.​company | string | It is the company name EDGAR lists. | | results.​tickers | string\[] | They are the company's ticker symbols. | | results.​formType | string | It is the form, such as `10-K` or `8-K`. | | results.​filedAt | timestamp | It is the filing date. | | results.​period | string | It is the period the filing reports on, as `YYYY-MM-DD`, when known. | | results.​url | string | It is the document's URL on sec.gov. | | results.​title | string | It is the document's title. | | results.​snippet | string | It is the passage that matched your query. | | results.​score | float | It is the relevance. Scores compare within one response only. | Unset optional fields are omitted; explicitly set zero and false values are preserved. Empty lists are explicit arrays, and 64-bit integers are strings, as protojson writes them. `edgar_search` ### A company's annual reports Apple's 10-K filings, found by ticker, with the accession number to pass to edgar_fetch. **Request** ``` { "ticker": "AAPL", "formTypes": [ "10-K" ], "numResults": 3 } ``` **Response** ``` { "results": [ { "accession": "0000320193-25-000079", "cik": "320193", "company": "Apple Inc.", "tickers": [ "AAPL" ], "formType": "10-K", "filedAt": "2025-10-31T00:00:00Z", "period": "2025-09-27", "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm", "title": "aapl-20250927" } ] } ``` Captured 2026-10-05 17:28 UTC from production `edgar_search` ### Search filing text across companies Quarterly reports that discuss tariffs and supply chain risk, with the matching passage from each filing. **Request** ``` { "query": "tariffs supply chain risk", "formTypes": [ "10-Q" ], "numResults": 3 } ``` **Response** ``` { "results": [ { "accession": "0001193125-25-258667", "cik": "860730", "company": "HCA Healthcare, Inc.", "tickers": [ "HCA" ], "formType": "10-Q", "filedAt": "2025-10-30T00:00:00Z", "period": "2025-09-30", "url": "https://www.sec.gov/Archives/edgar/data/860730/000119312525258667/hca-20250930.htm", "title": "10-Q", "snippet": "chain or other expenditures; workforce disruptions; supply and pharmaceutical shortages and disruptions (including as a result of tariffs or geopolitical disruptions); and the impact of federal government", "score": 0.5 }, { "accession": "0000105770-25-000093", "cik": "105770", "company": "WEST PHARMACEUTICAL SERVICES INC", "tickers": [ "WST" ], "formType": "10-Q", "filedAt": "2025-10-23T00:00:00Z", "period": "2025-09-30", "url": "https://www.sec.gov/Archives/edgar/data/105770/000010577025000093/wst-20250930.htm", "title": "wst-20250930", "snippet": "to them;\n•interruptions or weaknesses in our supply chain, including from reasons beyond our control such as extreme weather, longer-term climate changes, natural disasters, pandemic, war, accidental", "score": 0.5 }, { "accession": "0001104659-25-105543", "cik": "1027838", "company": "TACTILE SYSTEMS TECHNOLOGY INC", "tickers": [ "TCMD" ], "formType": "10-Q", "filedAt": "2025-11-03T00:00:00Z", "period": "2025-09-30", "url": "https://www.sec.gov/Archives/edgar/data/1027838/000110465925105543/tcmd-20250930x10q.htm", "title": "Tactile Systems Technology, Inc._September 30, 2025", "snippet": "However, recent changes and announcements in U.S. and global tariff frameworks have negatively impacted, and could continue to negatively impact, our supply chain and increase our cost of goods sold.", "score": 0.12804314 } ] } ``` Captured 2026-10-05 17:28 UTC from production ## edgar_fetch GA For a document it returns the filing, the markdown and text, and the section you asked for. For a `facts` query it returns the company and its facts, each with its unit, period, value, form, the accession it was reported in and the frame EDGAR picked for that period. ### What comes back | Field | Type | Meaning | | ---------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------- | | filing | Filing | It is the filing, with the same fields as an `edgar_search` result, when you asked for a document. | | markdown | string | It is the document, or the section, as markdown. | | text | string | It is the same content as plain text. | | truncated | bool | It is true when the content was cut at `maxCharacters`. | | section | string | It is the section that was returned, or empty for the whole document. | | facts.​cik · company | string | They are the company, when you asked for facts. | | facts.​facts | Fact\[] | They are the XBRL facts, newest period first. | | facts.​facts.​taxonomy · concept | string | They are the company's own XBRL tag, such as `us-gaap` and `RevenueFromContractWithCustomerExcludingAssessedTax`. | | facts.​facts.​unit | string | It is the unit, such as `USD`, `shares` or `USD/shares`. | | facts.​facts.​periodStart · periodEnd | timestamp | They are the period the value covers. | | facts.​facts.​value | double | It is the reported value. | | facts.​facts.​fiscalYear · fiscalPeriod | string | They are the fiscal year and period EDGAR records for the fact, such as `2025` and `FY` or `Q3`. | | facts.​facts.​form · accession · filedAt | string · timestamp | They are the filing the fact was reported in. Pass the accession to `edgar_fetch`. | | facts.​facts.​frame | string | It is the calendar frame, such as `CY2025`, when EDGAR picked this fact for that period. | Unset optional fields are omitted; explicitly set zero and false values are preserved. Empty lists are explicit arrays, and 64-bit integers are strings, as protojson writes them. `edgar_fetch` ### One section of a 10-K Item 1A, Risk Factors, of Apple's 2025 annual report, cut at 1,500 characters and flagged as truncated. **Request** ``` { "accession": "0000320193-25-000079", "section": "Item 1A", "maxCharacters": 1500 } ``` **Response** ``` { "filing": { "accession": "0000320193-25-000079", "cik": "320193", "company": "Apple Inc.", "tickers": [ "AAPL" ], "formType": "10-K", "filedAt": "2025-10-31T00:00:00Z", "period": "2025-09-27", "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm", "title": "aapl-20250927" }, "markdown": "Item 1A.    Risk Factors\n\nThe following summarizes factors that could have a material adverse effect on the Company’s business, reputation, results of operations, financial condition and stock price. The Company may not be able to accurately predict, control or mitigate these risks. Statements in this section are based on the Company’s beliefs and opinions regarding matters that could materially adversely affect the Company in the future and are not representations as to whether such matters have or have not occurred previously. The risks and uncertainties described below are not exhaustive and should not be considered a complete statement of all potential risks or uncertainties that the Company faces or may face in the future.\n\nThis section should be read in conjunction with Part II, Item 7, “Management’s Discussion and Analysis of Financial Condition and Results of Operations” and the consolidated financial statements and accompanying notes in Part II, Item 8, “Financial Statements and Supplementary Data” of this Form 10-K.\n\nMacroeconomic and Industry Risks\n\nThe Company’s operations and performance depend significantly on global and regional economic conditions and adverse economic conditions can materially adversely affect the Company’s business, results of operations, financial condition and stock price.\n\nThe Company has international operations with sales outside the U.S. representing a majority of the Company’s total net sales. In addition, the C", "text": "Item 1A.    Risk Factors\n The following summarizes factors that could have a material adverse effect on the Company’s business, reputation, results of operations, financial condition and stock price. The Company may not be able to accurately predict, control or mitigate these risks. Statements in this section are based on the Company’s beliefs and opinions regarding matters that could materially adversely affect the Company in the future and are not representations as to whether such matters have or have not occurred previously. The risks and uncertainties described below are not exhaustive and should not be considered a complete statement of all potential risks or uncertainties that the Company faces or may face in the future.\n This section should be read in conjunction with Part II, Item 7, “Management’s Discussion and Analysis of Financial Condition and Results of Operations” and the consolidated financial statements and accompanying notes in Part II, Item 8, “Financial Statements and Supplementary Data” of this Form 10-K.\n Macroeconomic and Industry Risks\n The Company’s operations and performance depend significantly on global and regional economic conditions and adverse economic conditions can materially adversely affect the Company’s business, results of operations, financial condition and stock price.\n The Company has international operations with sales outside the U.S. representing a majority of the Company’s total net sales. In addition, the C", "truncated": true, "section": "Item 1A" } ``` Captured 2026-10-05 17:31 UTC from production `edgar_fetch` ### Reported financial facts Apple's revenue and net income for the CY2025 frame as XBRL facts, under Apple's own XBRL tags, each tied to the 10-K it was reported in. **Request** ``` { "facts": { "ticker": "AAPL", "concepts": [ "RevenueFromContractWithCustomerExcludingAssessedTax", "NetIncomeLoss" ], "periods": [ "CY2025" ], "limit": 4 } } ``` **Response** ``` { "facts": { "cik": "320193", "company": "Apple Inc.", "facts": [ { "taxonomy": "us-gaap", "concept": "RevenueFromContractWithCustomerExcludingAssessedTax", "unit": "USD", "periodStart": "2024-09-29T00:00:00Z", "periodEnd": "2025-09-27T00:00:00Z", "value": 416161000000, "fiscalYear": "2025", "fiscalPeriod": "FY", "form": "10-K", "accession": "0000320193-25-000079", "filedAt": "2025-10-31T00:00:00Z", "frame": "CY2025" }, { "taxonomy": "us-gaap", "concept": "NetIncomeLoss", "unit": "USD", "periodStart": "2024-09-29T00:00:00Z", "periodEnd": "2025-09-27T00:00:00Z", "value": 112010000000, "fiscalYear": "2025", "fiscalPeriod": "FY", "form": "10-K", "accession": "0000320193-25-000079", "filedAt": "2025-10-31T00:00:00Z", "frame": "CY2025" } ] } } ``` Captured 2026-10-05 17:31 UTC from production Read [provenance and trust](/docs/provenance) for source timestamps, historical limitations and handling untrusted text. See [limits and errors](/docs/limits) for request receipts and retry behavior. --- This is the Markdown copy of https://deep.navy/docs/edgar.