SEC EDGAR MCP

Community

stefanoamorelli

A SEC EDGAR MCP (Model Context Protocol) Server

Publisher	stefanoamorelli
Repository	`sec-edgar-mcp`
Language	Python
Forks	78
Stars	270
Available tools	0
Transport type	stdio
Categories	Finance
License	AGPL-3.0
Links	GitHub Homepage

Connect tools to AI workflows
SEC EDGAR MCP exposes MCP capabilities that can be used by compatible AI clients and agents.
0 available tools
Browse the callable actions below, including names and descriptions when provided by the server.
Ready-to-copy setup
Use the installation snippets to configure this server in your preferred MCP client.
Open source signals
270 stars and 78 forks from the linked repository.

SEC EDGAR MCP

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 edgartools.

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

[!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, conda, uv), see the documentation.

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, 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-based test suite. See evals/ for details.

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

Documentation

Full docs: sec-edgar-mcp.amorelli.tech

Contributors

Citation

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

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 for additional formats.

License

AGPL-3.0. For commercial licensing: stefano@amorelli.tech

Installation

TypingMind

Prerequisites:

Node.js 18+

{
  "mcpServers": {
    "stefanoamorelli-sec-edgar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sec-edgar-mcp"
      ]
    }
  }
}

Use SEC EDGAR MCP MCP with multiple AI models

TypingMind connects MCP tools at the workspace level, so once SEC EDGAR MCP is connected, you can use it with different AI models in TypingMind instead of setting it up separately for each model. This MCP runs locally through the TypingMind MCP connector on your device.

Setup guide to use the local connector

Use this when the MCP server needs access to local files, apps, or private resources on your computer.

Open the MCP settings

In TypingMind, go to Settings, Advanced Settings, then Model Context Protocol and choose Setup Connector.

Open TypingMind in your browser.
Click the Settings icon.
Go to Advanced Settings.
Open the Model Context Protocol section.
Click Setup Connector and choose This Device.

TypingMind MCP connector setup screen with This Device selected

Run the connector command

Choose This Device, copy the command from TypingMind, and run it in Terminal. Keep the process running while you use MCP.

Copy the setup command shown by TypingMind.
Open Terminal on macOS or Windows Terminal on Windows.
Paste and run the command.
Approve the package install if Terminal asks you to proceed.
Keep the Terminal window running while using MCP tools.

Add SEC EDGAR MCP as a server

When the connector status is Ready, click Edit Servers and paste the MCP server configuration.

Wait until the connector status shows Ready.
Click Edit Servers.
Paste the SEC EDGAR MCP MCP server configuration.
Save the server list.
Refresh if you want to confirm the connector is still ready.

TypingMind MCP settings showing active server and Edit Servers button

Use it across models

Save the server list, open Plugins, enable the SEC EDGAR MCP MCP tools, then select any supported AI model in TypingMind and use the tools in chat or assign them to an AI agent.

Open the Plugins page in TypingMind.
Enable the SEC EDGAR MCP MCP tools.
Start a chat and choose the AI model you want to use.
Use the MCP tools in chat or assign them to an AI agent.
Switch to another AI model whenever needed without reconnecting MCP.

TypingMind chat using enabled MCP tools with a selected AI model

Frequently asked questions

What is the SEC EDGAR MCP MCP server used for?

SEC EDGAR MCP is an MCP server that lets compatible AI clients connect to external tools and context. In TypingMind, you can add this MCP server once and make its tools available in your AI workspace.

Can I use SEC EDGAR MCP MCP with multiple AI models in TypingMind?

Yes. TypingMind connects MCP tools at the workspace level, so you can use SEC EDGAR MCP with different AI models such as Claude, ChatGPT, Gemini, or other models you have configured in TypingMind without setting up the MCP server separately for each model.

Why use SEC EDGAR MCP MCP with TypingMind?

TypingMind is one of the best frontends for LLM chat because it brings multiple AI models, prompts, plugins, AI agents, API keys, and MCP tools into one workspace. With SEC EDGAR MCP connected, you can use its MCP tools across your preferred models while keeping your chat workflow organized in TypingMind.

How do I connect SEC EDGAR MCP MCP to TypingMind?

SEC EDGAR MCP runs through the TypingMind local MCP connector. This is best when the MCP server needs access to local files, desktop apps, command-line tools, or private resources on your computer.

What tools does SEC EDGAR MCP MCP provide in TypingMind?

SEC EDGAR MCP exposes MCP capabilities that can be enabled from the TypingMind Plugins page and used in chat or assigned to AI agents.

Do I need to share my API keys with TypingMind to use SEC EDGAR MCP MCP?

No. TypingMind is local-first and lets you keep your model providers, API keys, prompts, and MCP configuration under your control. If SEC EDGAR MCP requires authentication, add the required headers, OAuth settings, or local configuration for that MCP server when you create the connection.

Related MCP Servers

View all

PayPal

paypal

CommunityPopular

Official PayPal MCP server. Process payments, manage subscriptions, handle disputes, and access transaction history via PayPal's REST APIs.

6.7K

18 tools

View details

TradingView MCP Server

atilaahmettaner

CommunityPopular

Real-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.

Ramp

Ramp MCP server. Access corporate card transactions, receipts, approval workflows, and expense reports. Automate finance ops from AI clients.

Financial Datasets

An MCP server for interacting with the Financial Datasets stock market API.

SEC EDGAR MCP

Quick Start

Tools

HTTP Transport

Evaluations

Documentation

Contributors

Citation

License

Installation

Use SEC EDGAR MCP MCP with multiple AI models

Setup guide to use the local connector

Open the MCP settings

Run the connector command

Add SEC EDGAR MCP as a server

Use it across models

Frequently asked questions

Related MCP Servers

Set up your own AI workspace now