Important Disclaimer: EDGAR® and SEC® are trademarks of the U.S. Securities and Exchange Commission. This open-source project is created by Stefano Amorelli and built by the community is not affiliated with or approved by the U.S. Securities and Exchange Commission.
SEC EDGAR MCP Logo SEC EDGAR MCP is an open-source Model Context Protocol (MCP) server that provides AI assistants with seamless access to SEC EDGAR (Electronic Data Gathering, Analysis, and Retrieval) financial data. Query company filings, extract financial metrics, analyze business segments, and process XBRL data - all through natural language.

Key Features

Why SEC EDGAR MCP?

  • MCP Protocol: Built on the standardized Model Context Protocol
  • Type-Safe: Full type hints and validation for all 21 tools
  • Extensible: Modular architecture with core utilities and caching
  • Well-Documented: Comprehensive documentation with examples

Quick Example

Here’s how easy it is to get started:
You: "Show me recent insider trading activity for Apple executives"
Assistant: I'll search for Apple's company information and then analyze recent insider transactions using our comprehensive insider trading tools.

🔧 Tools used: company_search, get_insider_transactions, analyze_insider_patterns
📊 Result: Found 12 insider transactions in the last 30 days, including 3 executive stock sales totaling $2.1M

Prerequisites

Important: No registration is required, but according to SEC API policy, you must set a User-Agent header containing your email address for all requests. Set the SEC_EDGAR_USER_AGENT environment variable in the format: "Your Name (your.email@domain.com)"
API Compliance: Since this package uses the official SEC EDGAR API, you must respect SEC API restrictions and data policy. This includes rate limits and proper User-Agent identification as required by SEC policy.
  • Python 3.11 or higher
  • An MCP-compatible client (Claude Desktop, Cline, Continue.dev, etc.)
  • SEC EDGAR User-Agent header configuration

Getting Help

Issues

Report bugs or request features

Created and maintained by Stefano Amorelli. Built together with the community.