Metadata-Version: 2.4
Name: financial-mcp-server
Version: 0.1.2
Summary: MCP server for AI-powered stock analysis and paper trading
Author-email: Arnav Bhat <arnav.cal@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/arnavbhat1/financial-mcp
Project-URL: Repository, https://github.com/arnavbhat1/financial-mcp
Project-URL: Issues, https://github.com/arnavbhat1/financial-mcp/issues
Keywords: mcp,finance,stock,trading,paper-trading,yfinance,ai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: yfinance>=0.2.31
Requires-Dist: pyyaml>=6.0
Dynamic: license-file

# financial-mcp-server

MCP server for AI-powered stock analysis and paper trading. 14 tools for any MCP-compatible AI agent.

No API keys required. Market data from yfinance. Portfolio state in local SQLite.

## Tools

| Tool | What it does |
|------|-------------|
| `analyze_ticker` | Full analysis: fundamentals, momentum, composite score |
| `analyze_portfolio` | Holdings, allocations, performance, risk summary |
| `run_rebalance` | Score universe, generate signals, execute trades |
| `scan_universe` | Rank tickers by composite score |
| `create_portfolio` | Create a paper trading portfolio |
| `get_fundamentals` | PE, EV/EBITDA, P/B, dividend yield, market cap |
| `get_momentum` | 30d/90d momentum, volatility, relative strength |
| `get_price` | Current price |
| `score_ticker` | Composite score (0-100) with breakdown |
| `get_holdings` | Portfolio holdings |
| `get_trades` | Trade history |
| `execute_buy` | Buy shares (paper) |
| `execute_sell` | Sell shares (paper) |
| `check_risk` | Stress score, scenario drawdowns, allocations |

## Install

**pip:**
```bash
pip install financial-mcp-server
financial-mcp
```

**uvx (no install):**
```bash
uvx financial-mcp-server
```

**Claude Desktop** (`claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "financial-mcp": {
      "command": "uvx",
      "args": ["financial-mcp-server"]
    }
  }
}
```

**Claude Code:**
```bash
claude mcp add financial-mcp -- uvx financial-mcp-server
```

## License

MIT
