crypto-mcp/README.md

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

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:

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:

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

./tests.sh