convez.ai
MCP ServerFinanceiroIntermediário
reblickulous

SEC EDGAR MCP para Claude Desktop

reblickulous/edgar-mcp

Acesse dados financeiros e filings do SEC EDGAR direto no Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que conecta Claude Desktop diretamente ao SEC EDGAR, permitindo busca de empresas públicas, recuperação de filings e extração de dados financeiros estruturados sem sair da conversa. Elimina o trabalho manual de navegação em EDGAR, downloads e cópia de dados para planilhas.

Instalação

$npx convez-ai reblickulous/edgar-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Análise comparativa de empresas (comp analysis) para due diligence
  • Extração de métricas financeiras para construir one-pagers de investimento
  • Pesquisa rápida de filings específicos (10-K, 8-K, S-1) sem navegador
  • Síntese e análise de documentos regulatórios em conversas naturais

Veredito

Ferramenta sólida e bem documentada para profissionais de finanças e M&A que precisam acessar dados públicos do SEC EDGAR sem fricção. O setup é claro e os quatro tools (lookup, search, fetch, financials) cobrem os fluxos reais de work de due diligence.

README

A tradução para o português deste README ainda está na fila.

SEC EDGAR MCP for Claude Desktop

There's a certain kind of due diligence busywork that exists purely because pulling public financial data is annoying. You know a company's SEC filings are sitting there, free, fully public — and yet actually getting to the useful part of a 10-K still involves navigating EDGAR's UI, downloading documents, and ctrl-F'ing through 200 pages of boilerplate.

This MCP fixes that. It connects Claude Desktop directly to SEC EDGAR so you can research public companies, pull filings, and extract financial data through conversation — no browser, no manual downloads, no copy-pasting into a spreadsheet.


What It Does

Four tools, all usable through natural language in Claude Desktop:

lookup_company — Find any public company's CIK number by name or ticker symbol. The CIK is EDGAR's internal identifier and the starting point for everything else.

search_filings — Pull a company's filing history filtered by type. Ask for their last five 10-Ks, recent 8-Ks, an S-1, Form D — whatever's relevant to what you're looking at.

fetch_filing — Retrieve and read the actual content of a filing. Strips the HTML and returns clean readable text so Claude can summarize, extract, or answer questions about it directly.

get_financials — The most useful one for deal work. Pulls structured financial data: revenue, gross profit, operating income, net income, EBITDA components, total assets, liabilities, cash, long-term debt, and EPS — across the last three annual periods and four quarters. Ideal for building company one-pagers and investment summaries.


How I Use It

The workflow that saves the most time is comp analysis. Instead of pulling five 10-Ks manually and building a table by hand, I can do this in one conversation:

"Look up Veeva Systems, pull their last three years of financials, and compare revenue growth and operating margins to what we're seeing in [target company]'s projections."

Claude handles the retrieval, does the math, and flags the deltas. What used to take an hour of tab management takes a few minutes.


Setup

What you'll need:

  • Claude Desktop installed and running
  • Node.js v18 or higher — download the LTS version from nodejs.org

Step 1 — Verify Node.js is installed

Open Command Prompt (search "cmd" in your Start menu) and type:

node --version

You should see something like v20.x.x. If you get an error, go install Node.js first from nodejs.org, then come back.


Step 2 — Download this project

Click the green Code button at the top of this page → Download ZIP. Unzip it somewhere easy to find, like C:\edgar-mcp\.


Step 3 — Install dependencies

Open Command Prompt. You need to navigate into the project folder. The easiest way on Windows:

  1. Open File Explorer and go to your C:\edgar-mcp\ folder
  2. Click the address bar at the top of the window
  3. Type cmd and hit Enter — this opens Command Prompt already pointed at that folder

Now run:

npm install

You'll see text scroll by as it downloads the required libraries. When it stops and returns to the prompt, you're done.


Step 4 — Add your email

The SEC requires a contact email in every API request. Open index.js in Notepad and find this line near the top:

"User-Agent": "EDGAR-MCP-Tool/1.0 (personal-use; contact@example.com)",

Replace contact@example.com with your actual email address. Save the file.


Step 5 — Register with Claude Desktop

Claude Desktop uses a config file to know which MCP servers to load. You need to add this project to it.

Open File Explorer, click the address bar, paste this and hit Enter:

%APPDATA%\Claude

Open claude_desktop_config.json in Notepad.

If the file is empty, paste this entire block:

{
  "mcpServers": {
    "sec-edgar": {
      "command": "node",
      "args": ["C:\\edgar-mcp\\index.js"]
    }
  }
}

If the file already has content (other MCPs configured), add just the "sec-edgar" block inside the existing "mcpServers": { } section, with a comma separating it from the previous entry. It should look like this:

{
  "mcpServers": {
    "some-other-mcp": { ... },
    "sec-edgar": {
      "command": "node",
      "args": ["C:\\edgar-mcp\\index.js"]
    }
  }
}

Important: Use double backslashes (\\) in the file path inside the JSON. Single backslashes will cause an error.

Save the file.


Step 6 — Restart Claude Desktop

Don't just close the window — you need a full quit. Right-click the Claude icon in your system tray (bottom-right corner of your taskbar) and click Quit. Then relaunch Claude Desktop from your Start menu or desktop shortcut.


Step 7 — Test it

In Claude Desktop, try:

"Look up Torrid Holdings on EDGAR"

If Claude runs the lookup_company tool and returns a CIK number, you're live. Try following up with:

"Pull their last three years of financials"


Troubleshooting

Claude doesn't seem to be using the EDGAR tools Make sure you fully quit Claude Desktop from the system tray — just closing the window isn't enough. It needs a complete restart to load new MCP configs.

"Cannot find module" error You need to run npm install inside the project folder. See Step 3.

HTTP errors from EDGAR Make sure you updated the User-Agent in index.js with a real email address. The SEC will eventually block requests with placeholder addresses.

The path in the config isn't working Double-check that the path in claude_desktop_config.json matches exactly where you put the files, and that you're using double backslashes (\\).


A Note on Limitations

XBRL structured financial data (get_financials) only works for public companies. Private companies file with the SEC but don't submit machine-readable financial tags, so this tool won't return data for them. For private company diligence, use fetch_filing to pull and read the actual document text.


Stack

  • Runtime: Node.js (v18+)
  • MCP SDK: @modelcontextprotocol/sdk
  • Data source: SEC EDGAR APIs — free, no auth required
  • Transport: stdio (local)

What's Next

  • Hosted version — deploy to Railway so colleagues can connect without local setup
  • Institutional ownership tool — pull 13F/13G/13D filings for cap table research
  • Full-text search — search across all EDGAR filings for specific language or deal terms
Ver o original no GitHub

Bom para

Relacionados