SEC EDGAR MCP server for AI agents
Let Claude, ChatGPT or your own agent read SEC EDGAR: 3 typed functions through one MCP server. No SEC EDGAR API key needed.
- Site
- sec.gov
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just SEC EDGAR
An MCP server for SEC EDGAR alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/sec_edgarEvery site
One MCP server for SEC EDGAR and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 3
companyFactsA public company's own reported XBRL facts from its 10-K / 10-Q filings.Arguments
Name Type Required companystringTicker "AAPL", CIK "320193" or name "Apple".Yes conceptsstring[]Extra XBRL concepts, e.g. ["ResearchAndDevelopmentExpense"].No Returns
sec_edgarCompanyFactsinterface sec_edgarFact { key: string; // "revenue", "netIncome", … or the requested concept concept: string; // "us-gaap:NetIncomeLoss" label: string; unit: string; // "USD", "USD/shares", "shares" value: number; periodStart: string | null; // null for a point-in-time value periodEnd: string; fiscalYear: number | null; fiscalPeriod: string | null; // "FY" | "Q1" | "Q2" | "Q3" form: string; // "10-K", "10-Q" filed: string; accessionNumber: string; } interface sec_edgarKeyFact { key: string; latest: sec_edgarFact | null; // most recent period, any form latestAnnual: sec_edgarFact | null; // most recent full fiscal year, from a 10-K } interface sec_edgarCompanyFacts { cik: string; name: string; ticker: string | null; filingsUrl: string; facts: sec_edgarKeyFact[]; // revenue, netIncome, operatingIncome, epsDiluted, epsBasic, totalAssets, // totalLiabilities, stockholdersEquity, cash, sharesOutstanding, publicFloat conceptCount: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/sec_edgar/companyFactsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.sec_edgar.companyFacts({ company: "AAPL" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.sec_edgar.companyFacts({"company": "AAPL"}))curl -X POST https://api.bowmark.ai/v1/sites/sec_edgar/companyFacts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"company":"AAPL"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.sec_edgar.companyFacts({ company: "AAPL" });findCompanyFind SEC-registered public companies by ticker, CIK or name from EDGAR's own company_tickers.json; returns CIK, ticker and legal name.Arguments
Name Type Required querystringYes limitnumberNo Returns
sec_edgarCompany[]interface sec_edgarCompany { cik: string; // ten digits, zero-padded ticker: string; name: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/sec_edgar/findCompanyCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.sec_edgar.findCompany({ query: "MSFT" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.sec_edgar.findCompany({"query": "MSFT"}))curl -X POST https://api.bowmark.ai/v1/sites/sec_edgar/findCompany \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"MSFT"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.sec_edgar.findCompany({ query: "MSFT" });listFilingsA company's filing history (10-K, 10-Q, 8-K, proxy statements) with dates and document links, from data.sec.gov/submissions.Arguments
Name Type Required companystringTicker "AAPL", CIK "320193" or name "Apple".Yes formsstring[]E.g. ["10-K", "10-Q"]; "10-K/A" matches only when named.No limitnumberDefault 20, max 200.No Returns
sec_edgarFilingsinterface sec_edgarFiling { form: string; filingDate: string; reportDate: string | null; accessionNumber: string; primaryDocument: string | null; description: string | null; url: string; // the primary document on www.sec.gov } interface sec_edgarFilings { cik: string; name: string; tickers: string[]; filings: sec_edgarFiling[]; // newest first olderFilingsExist: boolean; // EDGAR has filings older than its ~1,000-row recent window }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/sec_edgar/listFilingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.sec_edgar.listFilings({ company: "AAPL", forms: ["10-K"] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.sec_edgar.listFilings({"company": "AAPL", "forms": ["10-K"]}))curl -X POST https://api.bowmark.ai/v1/sites/sec_edgar/listFilings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"company":"AAPL","forms":["10-K"]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.sec_edgar.listFilings({ company: "AAPL", forms: ["10-K"] });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/sec_edgar/<function> - OpenAPI
/v1/sites/sec_edgar/openapi.json