# ⚡ Financial Alpha MCP Server (Claude Desktop & Antigravity)

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![MCP Protocol](https://img.shields.io/badge/MCP-2024--11--05-brightgreen)](https://modelcontextprotocol.io)

![Financial Alpha MCP Banner](banner.jpg)

Turn **Claude Desktop**, **Antigravity IDE**, or your custom AI agents into institutional quantitative financial analysts.

Connect Claude directly to real-time market data, automated SEC EDGAR 10-K filings parsing, and technical backtesting strategies through the standard Model Context Protocol (MCP).

```
   +--------------------+       JSON-RPC Stdio       +------------------------------+
   |   Claude Desktop   | <=======================> |  Financial Alpha MCP Server  |
   |  / Antigravity IDE |                            |  - Real-Time Price Feeds     |
   +--------------------+                            |  - SEC EDGAR 10-K Audits     |
                                                     |  - Moving Average Backtest   |
                                                     +------------------------------+
```

---

## 🚀 Quickstart (Free Lite)

1. Clone this repository:
```bash
git clone https://github.com/takiahmed24/financial-alpha-mcp.git
cd financial-alpha-mcp
```

2. Add to your `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "finance": {
      "command": "python",
      "args": ["C:/path/to/financial-alpha-mcp/mcp_lite.py"]
    }
  }
}
```

3. Restart Claude Desktop and ask:  
> *"What is NVDA's current price and volume today?"*

---

## ⚡ Features

- **Real-time Stock Quotes**: Fetch ticker prices, day range, and volume directly into Claude.
- **Polymarket Alpha Scanner**: Scan active prediction markets and implied probability spreads.
- **Local SQLite Integration**: Fast local caching and offline testing.

---

## 📄 License
MIT License. Free and open source for personal and commercial use.