This guide covers all installation methods for SEC EDGAR MCP with detailed instructions and troubleshooting tips.

​
Prerequisites

Before installing SEC EDGAR MCP, ensure you have:
  • Python 3.11 or higher (for local installation)
  • Docker (for Docker installation)
  • A valid email address to register with SEC EDGAR
  • An MCP-compatible client

​
Installation Methods

Docker provides the easiest and most consistent installation experience.
1

Install Docker

If you don’t have Docker installed:
2

Pull the Docker Image

docker pull stefanoamorelli/sec-edgar-mcp:latest
3

Verify the Installation

docker run --rm stefanoamorelli/sec-edgar-mcp:latest --version

​
Local Installation with UV

UV is a fast Python package manager that simplifies dependency management.
1

Install UV

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
2

Clone the Repository

git clone https://github.com/stefanoamorelli/sec-edgar-mcp.git
cd sec-edgar-mcp
3

Install Dependencies

uv sync
4

Set Python Path (for development)

export PYTHONPATH=/path/to/sec-edgar-mcp:$PYTHONPATH

​
Conda Installation

Install from the Anaconda Cloud repository.
1

Install Anaconda or Miniconda

Download from Anaconda.com if not already installed.
2

Create a New Environment (Optional)

conda create -n sec-edgar-mcp python=3.11
conda activate sec-edgar-mcp
3

Install the Package

conda install -c stefanoamorelli sec-edgar-mcp

​
Development Installation

For contributors or those who want to modify the code.
1

Fork and Clone

# Fork the repository on GitHub first
git clone https://github.com/YOUR_USERNAME/sec-edgar-mcp.git
cd sec-edgar-mcp
2

Create Virtual Environment

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
3

Install in Development Mode

pip install -e ".[dev]"
4

Install Pre-commit Hooks

pre-commit install

​
Platform-Specific Instructions

​
System Requirements

  • macOS 10.15 (Catalina) or later
  • Xcode Command Line Tools (for git)

​
Additional Steps

  1. Install Homebrew (if needed): 
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  2. Install Python 3.11+: 
    brew install python@3.11

​
Known Issues

  • If you encounter SSL certificate errors, update certificates: 
    brew install ca-certificates

​
Verifying Your Installation

After installation, verify everything is working: 
# Check Docker installation
docker run --rm -e SEC_EDGAR_USER_AGENT="Test User (test@example.com)" \
  stefanoamorelli/sec-edgar-mcp:latest --help

​
Common Installation Issues

​
Next Steps

Configuration

Configure SEC EDGAR MCP for your needs

Client Integration

Connect to your MCP client
Created and maintained by Stefano Amorelli. Built together with the community.