Meta Agent Tools
PT

Back to the catalog

io.github.stefanoamorelli/sec-edgar-mcp

SEC EDGAR MCP server that provides access to the US public filings through the US SEC EDGAR API

Open source Open in the app JSON README (API)

About

SEC EDGAR MCP server that provides access to the US public filings through the US SEC EDGAR API

Details

Kind
MCP servers
Topic
Finance & crypto
Publisher
stefanoamorelli
Origin
official
Category
ferramentas
Transport
local
Version
1.0.5
Stars
357
Forks
94
Open pull requests
33
Last push
2026-08-21T10:17:34Z
Repository state
ativo
Language
Python
License
AGPL-3.0
Added
2026-08-29 04:01:27
Updated
2026-09-13 04:59:07
Origin id
io.github.stefanoamorelli/sec-edgar-mcp

README

# SEC EDGAR MCP

<p align="center">
  <a href="https://pypi.org/project/sec-edgar-mcp/"><img alt="PyPI" src="https://img.shields.io/pypi/v/sec-edgar-mcp.svg" /></a>
  <img alt="Python: 3.11+" src="https://img.shields.io/badge/python-3.11+-brightgreen.svg" />
  <img alt="License: AGPL-3.0" src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg" />
  <a href="https://doi.org/10.5281/zenodo.17123165"><img alt="DOI" src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.17123165-blue.svg" /></a>
  <a href="https://github.com/stefanoamorelli/sec-edgar-mcp/actions/workflows/evals.yml"><img alt="Evals" src="https://github.com/stefanoamorelli/sec-edgar-mcp/actions/workflows/evals.yml/badge.svg" /></a>
</p>

MCP server for accessing SEC EDGAR filings. Connects AI assistants to company filings, financial statements, and insider trading data with exact numeric precision.

Built on [sec-edgar-toolkit](https://github.com/stefanoamorelli/sec-edgar-toolkit).

https://github.com/user-attachments/assets/d310eb42-b3ca-467d-92f7-7d132e6274fe

<details>
<summary>See demo video</summary>

<a href="https://www.loom.com/share/17fcd7d891fe496f9a6b8fb85ede66bb">
  <img style="max-width:300px;" src="https://cdn.loom.com/sessions/thumbnails/17fcd7d891fe496f9a6b8fb85ede66bb-7f8590d1d4bcc2fb-full-play.gif">
</a>

</details>

> [!NOTE]
> This project is not affiliated with or endorsed by the U.S. Securities and Exchange Commission. EDGAR and SEC are trademarks of the SEC.

## Quick Start

```json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SEC_EDGAR_USER_AGENT=Your Name (your@email.com)",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}
```

The `-i` flag is required for MCP's JSON-RPC communication.

For other installation methods (pip, uv), see the [documentation](https://sec-edgar-mcp.amorelli.tech/setup/quickstart).

## Tools

| Category | Tools |
|----------|-------|
| **Company** | CIK lookup, company info, company facts |
| **Filings** | 10-K, 10-Q, 8-K retrieval, section extraction |
| **Financials** | Balance sheet, income statement, cash flow (XBRL-parsed) |
| **Insider Trading** | Form 3/4/5 transactions |

All responses include SEC filing URLs for verification.

## HTTP Transport

For platforms like [Dify](https://dify.ai), use streamable HTTP instead of stdio:

```bash
python -m sec_edgar_mcp.server --transport streamable-http --port 9870
```

No authentication is included. Use only on private networks.

## Evaluations

[Promptfoo](https://github.com/promptfoo/promptfoo)-based test suite. See [`evals/`](evals/) for details.

```bash
cd evals && npm install && npm run eval
```

## Documentation

Full docs: [sec-edgar-mcp.amorelli.tech](https://sec-edgar-mcp.amorelli.tech/)

## Contributors

<a href="https://github.com/stefanoamorelli/sec-edgar-mcp/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=stefanoamorelli/sec-edgar-mcp" />
</a>

## Citation

If you use this software in research, please cite it:

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17123166.svg)](https://doi.org/10.5281/zenodo.17123166)

```bibtex
@software{amorelli_sec_edgar_mcp_2025,
  title = {{SEC EDGAR MCP (Model Context Protocol) Server}},
  author = {Amorelli, Stefano},
  version = {1.0.6},
  year = {2025},
  month = {9},
  url = {https://doi.org/10.5281/zenodo.17123166},
  doi = {10.5281/zenodo.17123166}
}
```

See [CITATION.cff](CITATION.cff) for additional formats.

## License

[AGPL-3.0](LICENSE). For commercial licensing: stefano@amorelli.tech

More