Business
Data source: SEC EDGAR
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/sec-edgar/
claude_desktop_config.json
{
"mcpServers": {
"gnist-sec-edgar": {
"url": "https://context.gnist.ai/mcp/sec-edgar/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/sec-edgar/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_filings", "arguments": {"query": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/sec-edgar/
5 endpoints available:
GET /rest/sec-edgar/search_filingsGET /rest/sec-edgar/get_company_filingsGET /rest/sec-edgar/get_financial_factsGET /rest/sec-edgar/get_filing_sectionGET /rest/sec-edgar/report_feedback
Shell
curl "https://context.gnist.ai/rest/sec-edgar/search_filings?query=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/sec-edgar/search_filings",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"query": "example"
},
)
print(resp.json())
Command Line
Command
gc sec-edgar
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (5)
search_filingsFull-text search over all public SEC filings (10-K, 10-Q, 8-K, proxy, and more).
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search terms — phrase-matched against filing text. |
form_type | any | optional | |
company | any | optional | |
date_from | any | optional | |
date_to | any | optional | |
max_results | integer | optional | (default: 20) |
get_company_filingsRetrieve recent SEC filings for any public company by ticker or CIK.
| Parameter | Type | Required | Description |
|---|---|---|---|
ticker_or_cik | string | required | Company identifier — either a ticker symbol (e.g. "AAPL", "MSFT") or a numeric CIK (e.g. "320193" or "0000320193"). |
form_type | any | optional | Filter to a specific form type: "10-K", "10-Q", "8-K", etc. Omit to return all recent filings. |
limit | integer | optional | Maximum filings to return (default 10). (default: 10) |
get_financial_factsRetrieve XBRL-tagged financial data for a company concept across all reporting periods.
| Parameter | Type | Required | Description |
|---|---|---|---|
ticker_or_cik | string | required | Ticker symbol (e.g. "AAPL") or numeric CIK (e.g. "320193"). |
concept | string | required | XBRL concept tag name. Case-sensitive, CamelCase. |
unit | string | optional | Unit of measure — "USD", "shares", or "USD/shares". Default "USD". (default: "USD") |
taxonomy | string | optional | XBRL taxonomy — "us-gaap" (default) or "dei". (default: "us-gaap") |
get_filing_sectionExtract a specific section from a public SEC filing as plain text.
| Parameter | Type | Required | Description |
|---|---|---|---|
accession_number | string | required | EDGAR accession number — e.g. "0000320193-23-000106". |
section | string | required | Section to extract. Named sections: "business", "risk_factors", "mda", "financial_statements", "executive_compensation", "quantitative_risk", "controls". Also accepts raw item numbers... |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |