MCP Container

sec-edgar-mcp

A SEC EDGAR MCP (Model Context Protocol) Server

GitHubWebsiteDocs

GitHub Stars

121

User Rating

Not Rated

Favorites

0

Views

88

Forks

38

Issues

3

Installation
Difficulty
Intermediate
Estimated Time
10-20 minutes
Requirements
Python 3.9+

Installation

Installation

Prerequisites

Python: 3.9 or higher

Installation Steps

1. Clone Repository

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

2. Install Dependencies

bash
pip install -r requirements.txt

3. Start Server

bash
python app.py

Troubleshooting

Common Issues

Issue: Server won't start Solution: Check Python version and reinstall dependencies.

Configuration

Configuration

Basic Configuration

MCP Server Setup

Edit config.json to configure the MCP server: 
json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "python",
      "args": ["app.py"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Security Settings

Store API keys in environment variables or secure configuration files
Set appropriate file access permissions

Examples

Examples

Basic Usage

Programmatic Usage

python
import requests

response = requests.get('http://localhost:5000/mcp/call', params={
    'tool': 'getLatestFiling',
    'parameters': {'company': 'Apple'}
})
print(response.json())

Automation Script

bash
#!/bin/bash
for file in *.txt; do
  mcp-tool process "$file"
done

Use Cases

An AI assistant querying for the latest 10-K filing for a specific company
Creating an automation tool to analyze corporate financial data
Investors quickly searching for past filings of specific companies
Financial researchers analyzing market trends using EDGAR data
Author Information
Stefano Amorelli
Stefano Amorelli
Tallinn, Estonia
GitHub

25

Followers

85

Repositories

2

Gists

0

Total Contributions

Tags
aiartificial-intelligenceedgaredgar-databasefinancegenaillmmcpmcp-servermodel-context-protocolmodel-context-protocol-server
Related MCPs
open-streetmap-mcp logo
open-streetmap-mcp
107

An OpenStreetMap MCP server implementation that enhances LLM capabilities with location-based services and geospatial data.

Python
beanquery-mcp logo
beanquery-mcp
31

Beancount MCP Server is an experimental implementation that utilizes the Model Context Protocol (MCP) to enable AI assistants to query and analyze Beancount ledger files using Beancount Query Language (BQL) and the beanquery tool.

Python
hk-finance-mcp-server logo
hk-finance-mcp-server
11

This is an MCP server that provides access to finance-related data in Hong Kong through a FastMCP interface. It offers various statistics, including business registrations, residential mortgage loans, credit card surveys, and ATM information. This resource is particularly valuable for developers and analysts seeking detailed insights into the Hong Kong financial market.

Python