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.
Fair Usage Policy: This package uses the official SEC EDGAR API. Users must comply with the SEC’s Fair Access and Data Use Policy. Please review and follow the SEC’s guidelines for accessing EDGAR data to ensure responsible usage.
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.

Quick Start

Get up and running with SEC EDGAR MCP in minutes

MCP Tools Reference

Explore all 22 available MCP tools

Usage Examples

Learn through practical examples

GitHub Repository

View source code and contribute

​
Key Features

​
Why SEC EDGAR MCP?

  • MCP Protocol: Built on the standardized Model Context Protocol
  • Type-Safe: Full type hints and validation for all tools
  • Extensible: Easy to add new tools and functionality
  • Well-Documented: Comprehensive documentation with examples

​
Quick Example

Here’s how easy it is to get started: 
# Get Apple's latest 10-K filing
response = await mcp.call_tool(
    "get_recent_filings_smart",
    ticker="AAPL",
    form_type="10-K",
    limit=1
)

# Extract business description
sections = await mcp.call_tool(
    "get_filing_txt_sections",
    url=response["filings"][0]["txtUrl"],
    sections=["item_1"]
)

​
Prerequisites

Important: You must register your email with the SEC to use their EDGAR API. Set the SEC_EDGAR_USER_AGENT environment variable in the format: "Your Name (your.email@domain.com)"
  • Python 3.11 or higher
  • An MCP-compatible client (Claude Desktop, Cline, Continue.dev, etc.)
  • SEC EDGAR user agent registration

​
Getting Help

Issues

Report bugs or request features
Created and maintained by Stefano Amorelli. Built together with the community.