---
title: SEC Financial Report MCP Server - API
emoji: 📊
colorFrom: blue
colorTo: green
sdk: docker
pinned: true
license: mit
app_port: 7860
short_description: MCP Server for SEC EDGAR financial data with remote access
---

# 📊 SEC Financial Report MCP Server

**Model Context Protocol Server** for SEC EDGAR financial data analysis.

🔌 **Remote Access** - Connect from Claude Desktop, Cline, or any MCP client  
✨ **Natural Language** - Query financial data through conversation  
📈 **Formatted Output** - Get beautiful, AI-ready responses

## 📊 Features

- **Company Search**: Search companies by name, ticker, or CIK
- **Company Info**: Industry, SIC code, fiscal year details
- **SEC Filings**: 10-K, 10-Q, 20-F reports with dates and links
- **Financial Data**: Revenue, Net Income, EPS, Cash Flow
- **Multi-Year Analysis**: Comprehensive metrics extraction
- **Smart Formatting**: Beautiful, AI-ready output with emoji

## 📈 Supported Data

- **Report Types**: 10-K (Annual), 10-Q (Quarterly), 20-F (Foreign)
- **Standards**: US-GAAP, IFRS
- **Metrics**: Revenue, Net Income, EPS, Operating Expenses, Cash Flow

## 🚀 Quick Start

### 1. Add to Your MCP Client

**Claude Desktop** (`%APPDATA%\Claude\claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "sec-financial-data": {
      "url": "https://jc321-easyreportsmcpserver.hf.space/sse"
    }
  }
}
```

### 2. Restart Claude Desktop

### 3. Start Using!

"Search for Microsoft and show me their latest financial data" ✨

## 🛠️ Available Tools (7)

| Tool | Description |
|------|-------------|
| `search_company` | Search by company name |
| `get_company_info` | Get detailed company info |
| `get_company_filings` | List SEC filings (10-K, 10-Q, 20-F) |
| `get_financial_data` | Get data for specific period |
| `extract_financial_metrics` ⭐ | Multi-year comprehensive metrics |
| `get_latest_financial_data` | Most recent data available |
| `advanced_search_company` | Smart search (name/ticker/CIK) |

## 💬 Usage Examples

**Quick Lookup**:  
"Search for Tesla and show me their latest financial data"

**Trend Analysis**:  
"Extract 5 years of financial metrics for Apple and analyze revenue growth"

**Company Comparison**:  
"Compare NVIDIA and AMD revenue for the past 3 years"

**Output Format**:
```
💰 Financial Data for 2024Q3:
{
  "period": "2024Q3",
  "revenue": "$65.59B",
  "net_income": "$24.67B",
  "eps": "$3.30"
}
```

## ⚙️ Technical Stack

**Protocol**: Model Context Protocol 2024-11-05  
**Transport**: Server-Sent Events (SSE)  
**Framework**: FastAPI with Uvicorn  
**Platform**: Hugging Face Spaces  
**Data Source**: SEC EDGAR API

## 📜 Compliance

**SEC User-Agent** (Required by SEC EDGAR API):  
Juntao Peng Financial Report Metrics App (jtyxabc@gmail.com)

**Rate Limiting**: Follows SEC guidelines (10 requests/second max)

## 🏗️ Infrastructure

- **Platform**: Hugging Face Spaces (CPU Upgrade, Always-On)
- **Uptime**: 99.9% availability
- **Response**: <200ms cached, 1-3s fresh data
- **Concurrency**: Up to 200 concurrent requests
- **Health Check**: Every 30 seconds

## 📚 Documentation

- **[Usage Guide](./USAGE.md)** - Complete usage instructions
- **[Test Script](./test_mcp_sse.py)** - Test all endpoints

## 🔧 Local Development

```bash
# Start server
python mcp_server_sse.py

# Run tests
python test_mcp_sse.py
```