# MCP Financial Tools

Actionable financial intelligence for AI agents via the [Model Context Protocol](https://modelcontextprotocol.io/).

## Tools

| Tool | Description |
|------|-------------|
| `get_insider_buys` | Scored insider buying signals from SEC Form 4 filings |
| `get_earnings_iv_plays` | High-IV earnings plays for volatility crush strategies |
| `analyze_stock` | Comprehensive stock analysis with technicals + options |
| `get_market_pulse` | Market overview with indices, VIX, sector performance |
| `screen_options_wheel` | Best cash-secured put candidates for wheel strategy |
| `get_congressional_trades` | Congressional stock trade signals from House disclosures |

All data from free public sources (SEC EDGAR, Yahoo Finance). No API keys required.

## Install

```bash
pip install mcp-financial-tools
```

## Usage with Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "financial-tools": {
      "command": "mcp-financial-tools"
    }
  }
}
```

Then ask Claude things like:
- "What insider buying signals are there this week?"
- "Analyze NVDA for me"
- "What's the market pulse right now?"
- "Find earnings IV crush plays for next week"
- "Screen for wheel strategy candidates under $200"

## License

MIT
