EDGAR Filings
SEC filing figures with accession numbers: symbols, segment revenue, BDC credit, Form 4
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.1.3
- Listing updated
- today
Similar MCP servers
About EDGAR Filings
EDGAR Filings is an open-source MCP server for legal and government. It runs locally on your machine and is started by your AI client.
The aim is to stop a model from guessing financial facts. Each figure returned is tagged with its accession number, XBRL concept, period and an EDGAR index URL, so a reader can open the filing and confirm it. The README frames the problem as models inventing segment mix, insider trades and BDC credit quality.
It is built on the edgartools library and covers four narrow jobs: every trading symbol on the latest 10-K or 10-Q, dimensioned segment revenue, non-accrual rates for business development companies, and the newest Form 4 insider summaries. The tools warn about known pitfalls, such as dual-class tickers overwriting the common symbol, Form 4 grants and option exercises not counting as open-market trades, and a parse gap when non-accrual extraction returns none.
The SEC requires a fair-access identity, so an EDGAR_IDENTITY value with a real name and email is mandatory. The first launch downloads pandas and pyarrow, which can make a client look stuck.
Install
Run in a terminal
claude mcp add edgar-mcp --env EDGAR_IDENTITY='<EDGAR_IDENTITY>' -- uvx edgar-filings-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"edgar-mcp": {
"command": "uvx",
"args": [
"edgar-filings-mcp"
],
"env": {
"EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"edgar-mcp": {
"command": "uvx",
"args": [
"edgar-filings-mcp"
],
"env": {
"EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"edgar-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"edgar-filings-mcp"
],
"env": {
"EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"edgar-mcp": {
"command": "uvx",
"args": [
"edgar-filings-mcp"
],
"env": {
"EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"edgar-mcp": {
"command": "uvx",
"args": [
"edgar-filings-mcp"
],
"env": {
"EDGAR_IDENTITY": "<EDGAR_IDENTITY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
EDGAR_IDENTITYSEC fair-access User-Agent: 'Name you@email.com'Required
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- get_trading_symbols
- Returns every TradingSymbol on the latest 10-K or 10-Q.
- get_segment_revenue
- Returns dimensioned XBRL revenue by product, business or geographic axis.
- get_bdc_nonaccrual
- Returns BDC non-accrual rate, fair value, named investments and extraction method.
- get_form4
- Returns newest Form 4 summaries, transaction lines, open_market and code_counts.
What it does
- Trading symbols
- Lists every TradingSymbol on the latest 10-K or 10-Q.
- Segment revenue
- Returns revenue split by product, business or geographic axes.
- BDC non-accrual
- Reports non-accrual rate, fair value, named investments and extraction method.
- Form 4 summaries
- Shows the newest insider filings with transaction lines and an open-market flag.
- Checkable citations
- Every number carries accession, concept, period and EDGAR URL.
- Built-in warnings
- Tools flag known traps such as dual-class tickers and 10-K/A amendments.
Good for
- Check NVDA data center segment revenue against its filing
- Review a BDC's non-accrual rate and the investments behind it
- Scan recent insider transactions and separate open-market trades from grants
- Find all listed symbols a filer reports
Pricing
Open source
MIT licence
EDGAR Filings FAQ
What identity does the SEC need?
Set EDGAR_IDENTITY to a real name and email address, as the SEC fair-access policy asks.
Which filing forms are supported?
The 10-K and 10-Q for symbols, segments and BDC data (10-K is the default), plus Form 4.
How do I install it?
Add uvx edgar-filings-mcp to your client's MCP config, or install from the Git repository or a clone.
Why is the first start slow?
The first uvx run downloads edgartools with pandas and pyarrow; running it once in a terminal caches them.
What is the licence?
MIT; it is not affiliated with the SEC.
Is EDGAR Filings free?
Yes. EDGAR Filings is open source, so you can use and self-host it for free.
How do I add EDGAR Filings to Claude Code?
Run this command in your terminal: claude mcp add edgar-mcp --env EDGAR_IDENTITY='<EDGAR_IDENTITY>' -- uvx edgar-filings-mcp
What are the best alternatives to EDGAR Filings?
The closest alternatives to EDGAR Filings are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


