Spaces:
Sleeping
Sleeping
File size: 3,385 Bytes
d40b4a6 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 |
---
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
```
|