Skip to content
Back to search

sec-edgar-mcp

A SEC EDGAR MCP (Model Context Protocol) Server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/stefanoamorelli--sec-edgar-mcp/badge.svg)](/listings/stefanoamorelli--sec-edgar-mcp)

HTML

<a href="/listings/stefanoamorelli--sec-edgar-mcp"><img src="/api/listings/stefanoamorelli--sec-edgar-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

{
  "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).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 112 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # SEC EDGAR MCP
  2. <p align="center">
  3. <a href="https://pypi.org/project/sec-edgar-mcp/"><img alt="PyPI" src="https://img.shields.io/pypi/v/sec-edgar-mcp.svg" /></a>
  4. <img alt="Python: 3.11+" src="https://img.shields.io/badge/python-3.11+-brightgreen.svg" />
  5. <img alt="License: AGPL-3.0" src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg" />
  6. <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>
  7. <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>
  8. </p>
  9. MCP server for accessing SEC EDGAR filings. Connects AI assistants to company filings, financial statements, and insider trading data with exact numeric precision.
  10. Built on [sec-edgar-toolkit](https://github.com/stefanoamorelli/sec-edgar-toolkit).
  11. https://github.com/user-attachments/assets/d310eb42-b3ca-467d-92f7-7d132e6274fe
  12. <details>
  13. <summary>See demo video</summary>
  14. <a href="https://www.loom.com/share/17fcd7d891fe496f9a6b8fb85ede66bb">
  15. <img style="max-width:300px;" src="https://cdn.loom.com/sessions/thumbnails/17fcd7d891fe496f9a6b8fb85ede66bb-7f8590d1d4bcc2fb-full-play.gif">
  16. </a>
  17. </details>
  18. > [!NOTE]
  19. > This project is not affiliated with or endorsed by the U.S. Securities and Exchange Commission. EDGAR and SEC are trademarks of the SEC.
  20. ## Quick Start
  21. ```json
  22. {
  23. "mcpServers": {
  24. "sec-edgar-mcp": {
  25. "command": "docker",
  26. "args": [
  27. "run", "-i", "--rm",
  28. "-e", "SEC_EDGAR_USER_AGENT=Your Name (your@email.com)",
  29. "stefanoamorelli/sec-edgar-mcp:latest"
  30. ]
  31. }
  32. }
  33. }
  34. ```
  35. The `-i` flag is required for MCP's JSON-RPC communication.
  36. For other installation methods (pip, uv), see the [documentation](https://sec-edgar-mcp.amorelli.tech/setup/quickstart).
  37. ## Tools
  38. | Category | Tools |
  39. |----------|-------|
  40. | **Company** | CIK lookup, company info, company facts |
  41. | **Filings** | 10-K, 10-Q, 8-K retrieval, section extraction |
  42. | **Financials** | Balance sheet, income statement, cash flow (XBRL-parsed) |
  43. | **Insider Trading** | Form 3/4/5 transactions |
  44. All responses include SEC filing URLs for verification.
  45. ## HTTP Transport
  46. For platforms like [Dify](https://dify.ai), use streamable HTTP instead of stdio:
  47. ```bash
  48. python -m sec_edgar_mcp.server --transport streamable-http --port 9870
  49. ```
  50. No authentication is included. Use only on private networks.
  51. ## Evaluations
  52. [Promptfoo](https://github.com/promptfoo/promptfoo)-based test suite. See [`evals/`](evals/) for details.
  53. ```bash
  54. cd evals && npm install && npm run eval
  55. ```
  56. ## Documentation
  57. Full docs: [sec-edgar-mcp.amorelli.tech](https://sec-edgar-mcp.amorelli.tech/)
  58. ## Contributors
  59. <a href="https://github.com/stefanoamorelli/sec-edgar-mcp/graphs/contributors">
  60. <img src="https://contrib.rocks/image?repo=stefanoamorelli/sec-edgar-mcp" />
  61. </a>
  62. ## Citation
  63. If you use this software in research, please cite it:
  64. [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17123166.svg)](https://doi.org/10.5281/zenodo.17123166)
  65. ```bibtex
  66. @software{amorelli_sec_edgar_mcp_2025,
  67. title = {{SEC EDGAR MCP (Model Context Protocol) Server}},
  68. author = {Amorelli, Stefano},
  69. version = {1.0.6},
  70. year = {2025},
  71. month = {9},
  72. url = {https://doi.org/10.5281/zenodo.17123166},
  73. doi = {10.5281/zenodo.17123166}
  74. }
  75. ```
  76. See [CITATION.cff](CITATION.cff) for additional formats.
  77. ## License
  78. [AGPL-3.0](LICENSE). For commercial licensing: stefano@amorelli.tech

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.