{"openapi":"3.0.3","info":{"title":"Gnist Context — SEC EDGAR","description":"SEC filings — 10-K, 10-Q, 8-K, and other company disclosures.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/sec-edgar/`\n- **Toolkit page:** `/toolkits/sec-edgar`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/sec-edgar/search_filings":{"post":{"tags":["Business"],"summary":"search_filings","description":"Full-text search over all public SEC filings (10-K, 10-Q, 8-K, proxy, and more).\n\nArgs:\n    query: Search terms — phrase-matched against filing text.\n           Examples: \"artificial intelligence\", \"climate risk\", \"supply chain\".\n    form_type: Filter to a specific form type: \"10-K\", \"10-Q\", \"8-K\", \"DEF 14A\".\n               Omit to search all form types.\n    company: Filter by company name (partial match).\n    date_from: Earliest filing date — YYYY-MM-DD.\n    date_to: Latest filing date — YYYY-MM-DD.\n    max_results: Maximum filings to return (1–100, default 20).\n\nReturns:\n    List of matching filings with accession number, form type, filing date,\n    company name, reporting period, and EDGAR viewer URL.","operationId":"sec_edgar_search_filings","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Search terms — phrase-matched against filing text.","type":"string"},"form_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"max_results":{"default":20,"type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/sec-edgar/get_company_filings":{"post":{"tags":["Business"],"summary":"get_company_filings","description":"Retrieve recent SEC filings for any public company by ticker or CIK.\n\nArgs:\n    ticker_or_cik: Company identifier — either a ticker symbol (e.g. \"AAPL\", \"MSFT\")\n                   or a numeric CIK (e.g. \"320193\" or \"0000320193\").\n    form_type: Filter to a specific form type: \"10-K\", \"10-Q\", \"8-K\", etc.\n               Omit to return all recent filings.\n    limit: Maximum filings to return (default 10).\n\nReturns:\n    Company metadata (name, CIK, ticker, industry) and a list of filings,\n    each with accession number, form type, dates, and document URL.","operationId":"sec_edgar_get_company_filings","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"ticker_or_cik":{"description":"Company identifier — either a ticker symbol (e.g. \"AAPL\", \"MSFT\") or a numeric CIK (e.g. \"320193\" or \"0000320193\").","type":"string"},"form_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to a specific form type: \"10-K\", \"10-Q\", \"8-K\", etc. Omit to return all recent filings."},"limit":{"default":10,"description":"Maximum filings to return (default 10).","type":"integer"}},"required":["ticker_or_cik"],"type":"object"}}}}}},"/rest/sec-edgar/get_financial_facts":{"post":{"tags":["Business"],"summary":"get_financial_facts","description":"Retrieve XBRL-tagged financial data for a company concept across all reporting periods.\n\nCommon concepts (us-gaap taxonomy):\n- Revenue: \"Revenues\" or \"RevenueFromContractWithCustomerExcludingAssessedTax\"\n- Net income: \"NetIncomeLoss\"\n- Total assets: \"Assets\"\n- Cash: \"CashAndCashEquivalentsAtCarryingValue\"\n- EPS (basic): \"EarningsPerShareBasic\" (use unit=\"USD/shares\")\n\nArgs:\n    ticker_or_cik: Ticker symbol (e.g. \"AAPL\") or numeric CIK (e.g. \"320193\").\n    concept: XBRL concept tag name. Case-sensitive, CamelCase.\n    unit: Unit of measure — \"USD\", \"shares\", or \"USD/shares\". Default \"USD\".\n    taxonomy: XBRL taxonomy — \"us-gaap\" (default) or \"dei\".\n\nReturns:\n    Company name, concept label, and a list of facts sorted newest-first.","operationId":"sec_edgar_get_financial_facts","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"ticker_or_cik":{"description":"Ticker symbol (e.g. \"AAPL\") or numeric CIK (e.g. \"320193\").","type":"string"},"concept":{"description":"XBRL concept tag name. Case-sensitive, CamelCase.","type":"string"},"unit":{"default":"USD","description":"Unit of measure — \"USD\", \"shares\", or \"USD/shares\". Default \"USD\".","type":"string"},"taxonomy":{"default":"us-gaap","description":"XBRL taxonomy — \"us-gaap\" (default) or \"dei\".","type":"string"}},"required":["ticker_or_cik","concept"],"type":"object"}}}}}},"/rest/sec-edgar/get_filing_section":{"post":{"tags":["Business"],"summary":"get_filing_section","description":"Extract a specific section from a public SEC filing as plain text.\n\nArgs:\n    accession_number: EDGAR accession number — e.g. \"0000320193-23-000106\".\n    section: Section to extract. Named sections: \"business\", \"risk_factors\",\n             \"mda\", \"financial_statements\", \"executive_compensation\",\n             \"quantitative_risk\", \"controls\".\n             Also accepts raw item numbers: \"1\", \"1A\", \"7\", \"7A\", \"8\", \"9A\", \"11\".\n\nReturns:\n    Section name, source URL, and extracted plain text (up to ~8000 chars).","operationId":"sec_edgar_get_filing_section","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"accession_number":{"description":"EDGAR accession number — e.g. \"0000320193-23-000106\".","type":"string"},"section":{"description":"Section to extract. Named sections: \"business\", \"risk_factors\", \"mda\", \"financial_statements\", \"executive_compensation\", \"quantitative_risk\", \"controls\". Also accepts raw item numbers...","type":"string"}},"required":["accession_number","section"],"type":"object"}}}}}},"/rest/sec-edgar/report_feedback":{"post":{"tags":["Business"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"sec_edgar_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Business","description":"Data sources: Business"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}