{"openapi":"3.1.0","info":{"title":"sec-edgar","version":"0.1.0","description":"Resolves a ticker, CIK or company name (fuzzy, top 5) to 10-digit CIK, tickers, exchange, legal name, SIC code and description. Data comes from SEC EDGAR.; Lists SEC filings for a CIK or ticker, filtered by form types (10-K, 10-Q, 8-K, S-1, DEF 14A), date range and limit (max 50), with document links. Data comes from SEC EDGAR.; Lists a company's 8-K filings in the last N days (max 90) with item codes decoded to plain English, e.g. 2.02 Results of Operations, 5.02 Officer changes. Data comes from SEC EDGAR.","x-guidance":"SEC EDGAR resolves a ticker, CIK or fuzzy company name to the 10-digit CIK, tickers, exchange, legal name and SIC code (`resolve_company`), lists filings by form type and date range with direct document links (`list_filings`), and decodes recent 8-K item codes into plain-English events (`recent_8k_events`). All data comes from SEC EDGAR (sec.gov, data.sec.gov), fetched live and rate-limited to SEC fair-access rules. Every response carries source URLs and asOf. Tools: `resolve_company`, `list_filings`, `recent_8k_events`.","contact":{"email":"jeff@fosterinstruments.com"}},"servers":[{"url":"https://sec-edgar.x402supply.com"}],"paths":{"/mcp":{"post":{"operationId":"sec-edgar_call","summary":"Call sec-edgar via MCP tools/call","tags":["sec-edgar"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"const":"tools/call"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"const":"resolve_company"},"arguments":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":120,"description":"Ticker (AAPL), CIK (320193 or 0000320193) or company name (apple computer)"}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"const":"tools/call"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"const":"list_filings"},"arguments":{"type":"object","properties":{"company":{"type":"string","minLength":1,"maxLength":20,"description":"CIK (320193) or ticker (AAPL)"},"forms":{"type":"string","maxLength":100,"description":"Comma-separated form types, e.g. 10-K,10-Q. Default all forms"},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Earliest filing date, YYYY-MM-DD"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Latest filing date, YYYY-MM-DD"},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Maximum filings to return, 1-50","default":10}},"required":["company"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"const":"tools/call"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"const":"recent_8k_events"},"arguments":{"type":"object","properties":{"company":{"type":"string","minLength":1,"maxLength":20,"description":"CIK (320193) or ticker (AAPL)"},"days":{"type":"integer","minimum":1,"maximum":90,"description":"Look-back window in days, 1-90","default":30}},"required":["company"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}}]}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"JSON-RPC 2.0 response envelope. `result.content[0].text` is a JSON-encoded string matching the schema in `x-mcp-result-schema`.","properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"result":{"type":"object","properties":{"content":{"type":"array","items":{"type":"object","properties":{"type":{"const":"text"},"text":{"type":"string"}}}}}}},"x-mcp-result-schema":{"type":"object","required":["query","matchType","count","matches","source","asOf"],"properties":{"query":{"type":"string"},"matchType":{"type":"string"},"count":{"type":"integer"},"matches":{"type":"array","items":{"type":"object","required":["cik","name","tickers","exchanges","score"],"properties":{"cik":{"type":"string"},"name":{"type":"string"},"tickers":{"type":"array","items":{"type":"string"}},"exchanges":{"type":"array","items":{"type":"string"}},"sic":{"type":["string","null"]},"sicDescription":{"type":["string","null"]},"score":{"type":"number"}}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}}},{"type":"object","description":"JSON-RPC 2.0 response envelope. `result.content[0].text` is a JSON-encoded string matching the schema in `x-mcp-result-schema`.","properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"result":{"type":"object","properties":{"content":{"type":"array","items":{"type":"object","properties":{"type":{"const":"text"},"text":{"type":"string"}}}}}}},"x-mcp-result-schema":{"type":"object","required":["cik","name","count","filings","source","asOf"],"properties":{"cik":{"type":"string"},"name":{"type":"string"},"count":{"type":"integer"},"filings":{"type":"array","items":{"type":"object","required":["form","filingDate","accessionNumber","url"],"properties":{"form":{"type":"string"},"filingDate":{"type":"string"},"reportDate":{"type":["string","null"]},"accessionNumber":{"type":"string"},"url":{"type":["string","null"]},"indexUrl":{"type":"string"},"items":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]}}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}}},{"type":"object","description":"JSON-RPC 2.0 response envelope. `result.content[0].text` is a JSON-encoded string matching the schema in `x-mcp-result-schema`.","properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"result":{"type":"object","properties":{"content":{"type":"array","items":{"type":"object","properties":{"type":{"const":"text"},"text":{"type":"string"}}}}}}},"x-mcp-result-schema":{"type":"object","required":["cik","name","days","count","events","source","asOf"],"properties":{"cik":{"type":"string"},"name":{"type":"string"},"days":{"type":"integer"},"count":{"type":"integer"},"events":{"type":"array","items":{"type":"object","required":["form","filingDate","accessionNumber","items","url"],"properties":{"form":{"type":"string"},"filingDate":{"type":"string"},"reportDate":{"type":["string","null"]},"accessionNumber":{"type":"string"},"items":{"type":"array","items":{"type":"object","required":["code","event"],"properties":{"code":{"type":"string"},"event":{"type":"string"}}}},"url":{"type":["string","null"]},"indexUrl":{"type":"string"}}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}}}]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/tools/resolve_company":{"post":{"operationId":"sec-edgar_resolve_company_http","summary":"Resolves a ticker, CIK or company name (fuzzy, top 5) to 10-digit CIK, tickers, exchange, legal name, SIC code and description. Data comes from SEC EDGAR.","tags":["sec-edgar"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":120,"description":"Ticker (AAPL), CIK (320193 or 0000320193) or company name (apple computer)"}},"required":["query"],"additionalProperties":false},"example":{"query":"AAPL"}}}},"responses":{"200":{"description":"Tool result (plain JSON, not MCP-wrapped)","content":{"application/json":{"schema":{"type":"object","required":["query","matchType","count","matches","source","asOf"],"properties":{"query":{"type":"string"},"matchType":{"type":"string"},"count":{"type":"integer"},"matches":{"type":"array","items":{"type":"object","required":["cik","name","tickers","exchanges","score"],"properties":{"cik":{"type":"string"},"name":{"type":"string"},"tickers":{"type":"array","items":{"type":"string"}},"exchanges":{"type":"array","items":{"type":"string"}},"sic":{"type":["string","null"]},"sicDescription":{"type":["string","null"]},"score":{"type":"number"}}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}},"example":{"query":"AAPL","matchType":"ticker","count":1,"matches":[{"cik":"0000320193","name":"Apple Inc.","tickers":["AAPL"],"exchanges":["Nasdaq"],"sic":"3571","sicDescription":"Electronic Computers","score":1}],"source":["https://www.sec.gov/files/company_tickers_exchange.json","https://data.sec.gov/submissions/CIK0000320193.json"],"asOf":"2026-10-09T17:49:13.901Z"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/tools/list_filings":{"post":{"operationId":"sec-edgar_list_filings_http","summary":"Lists SEC filings for a CIK or ticker, filtered by form types (10-K, 10-Q, 8-K, S-1, DEF 14A), date range and limit (max 50), with document links. Data comes from SEC EDGAR.","tags":["sec-edgar"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string","minLength":1,"maxLength":20,"description":"CIK (320193) or ticker (AAPL)"},"forms":{"type":"string","maxLength":100,"description":"Comma-separated form types, e.g. 10-K,10-Q. Default all forms"},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Earliest filing date, YYYY-MM-DD"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Latest filing date, YYYY-MM-DD"},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Maximum filings to return, 1-50","default":10}},"required":["company"],"additionalProperties":false},"example":{"company":"AAPL","forms":"10-Q","limit":1}}}},"responses":{"200":{"description":"Tool result (plain JSON, not MCP-wrapped)","content":{"application/json":{"schema":{"type":"object","required":["cik","name","count","filings","source","asOf"],"properties":{"cik":{"type":"string"},"name":{"type":"string"},"count":{"type":"integer"},"filings":{"type":"array","items":{"type":"object","required":["form","filingDate","accessionNumber","url"],"properties":{"form":{"type":"string"},"filingDate":{"type":"string"},"reportDate":{"type":["string","null"]},"accessionNumber":{"type":"string"},"url":{"type":["string","null"]},"indexUrl":{"type":"string"},"items":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]}}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}},"example":{"cik":"0000320193","name":"Apple Inc.","count":1,"filings":[{"form":"10-Q","filingDate":"2026-07-31","reportDate":"2026-06-27","accessionNumber":"0000320193-26-000020","url":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm","indexUrl":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/","items":[],"description":"10-Q"}],"source":["https://data.sec.gov/submissions/CIK0000320193.json"],"asOf":"2026-10-09T17:49:14.089Z"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/tools/recent_8k_events":{"post":{"operationId":"sec-edgar_recent_8k_events_http","summary":"Lists a company's 8-K filings in the last N days (max 90) with item codes decoded to plain English, e.g. 2.02 Results of Operations, 5.02 Officer changes. Data comes from SEC EDGAR.","tags":["sec-edgar"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string","minLength":1,"maxLength":20,"description":"CIK (320193) or ticker (AAPL)"},"days":{"type":"integer","minimum":1,"maximum":90,"description":"Look-back window in days, 1-90","default":30}},"required":["company"],"additionalProperties":false},"example":{"company":"AAPL","days":90}}}},"responses":{"200":{"description":"Tool result (plain JSON, not MCP-wrapped)","content":{"application/json":{"schema":{"type":"object","required":["cik","name","days","count","events","source","asOf"],"properties":{"cik":{"type":"string"},"name":{"type":"string"},"days":{"type":"integer"},"count":{"type":"integer"},"events":{"type":"array","items":{"type":"object","required":["form","filingDate","accessionNumber","items","url"],"properties":{"form":{"type":"string"},"filingDate":{"type":"string"},"reportDate":{"type":["string","null"]},"accessionNumber":{"type":"string"},"items":{"type":"array","items":{"type":"object","required":["code","event"],"properties":{"code":{"type":"string"},"event":{"type":"string"}}}},"url":{"type":["string","null"]},"indexUrl":{"type":"string"}}}},"source":{"type":"array","items":{"type":"string"}},"asOf":{"type":"string"}}},"example":{"cik":"0000320193","name":"Apple Inc.","days":90,"count":2,"events":[{"form":"8-K/A","filingDate":"2026-09-01","reportDate":"2026-04-17","accessionNumber":"0001140361-26-035325","items":[{"code":"5.02","event":"Departure/Appointment of Directors or Officers"}],"url":"https://www.sec.gov/Archives/edgar/data/320193/000114036126035325/ef20081427_8ka.htm","indexUrl":"https://www.sec.gov/Archives/edgar/data/320193/000114036126035325/"},{"form":"8-K","filingDate":"2026-07-30","reportDate":"2026-07-30","accessionNumber":"0000320193-26-000018","items":[{"code":"2.02","event":"Results of Operations and Financial Condition"},{"code":"9.01","event":"Financial Statements and Exhibits"}],"url":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260730.htm","indexUrl":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/"}],"source":["https://data.sec.gov/submissions/CIK0000320193.json"],"asOf":"2026-10-09T17:49:14.262Z"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}}}}