Spaces:
Sleeping
Sleeping
| 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 | |
| ``` | |