# Crypto MCP Server

FastMCP-based crypto tools server.

## Transport (compliance-first)

- MCP SSE transport mounted at `/mcp`
- SSE stream endpoint: `/mcp/sse`
- message endpoint handled by FastMCP under `/mcp/messages/`
- no legacy `/rpc` compatibility path

## Runtime

```bash
pip install -r requirements.txt
./run.sh
```

Default URL base: `http://127.0.0.1:8505`

### Docker / Compose

Build and start the server with Compose from the project directory:

```bash
docker compose up -d --build
```

The container listens on port `8505` and exposes the MCP SSE transport at:

- `http://127.0.0.1:8505/mcp/sse`
- `http://127.0.0.1:8505/health`

To stop it:

```bash
docker compose down
```

## Tools

- `get_price`
- `get_ohlcv`
- `get_indicator` (supports: `rsi`, `ema`, `sma`, `macd`, `atr`, `bollinger`, `vwap` — each with optional params)
- `get_market_snapshot`
- `get_top_movers`
- `get_capabilities`
- `get_regime`

`get_regime` returns a composite view (trend EMA/SMA regime, RSI + MACD momentum, ATR-based volatility, Bollinger bands, VWAP) plus a **heuristic early `reversal` score** (bullish/bearish/none with 0–100 score and trigger notes) for a given symbol/timeframe.

## Health

- `GET /`
- `GET /health`

## Tests

```bash
./tests.sh
```