# Trader MCP - Project

## Purpose
Trading helpers, strategy control, and a small MCP surface. Keep app logic isolated and the public API compact.

## Architecture
- FastAPI app
- FastMCP mounted at `/mcp` using SSE at `/mcp/sse`
- App-specific logic under `src/<app_name>/*`
- State persistence via SQLite (add only as needed)
- Logs and pid files under `./logs/`

## MCP surface
- `list_strategies`
- `get_strategy`
- `update_strategy`
- `control_strategy`

## Notes
- `get_strategy()` can optionally include render and debug data.
- `update_strategy()` updates config/state and reconciles.
- `control_strategy()` handles `start`, `pause`, `resume`, `stop`, and `reconcile`.

## Upgrade plans

The next phase should focus on making trader easier to operate, not just more capable:

- standardize a shared config vocabulary across strategies
- streamline how strategies appear in the dashboard and how they are configured
- add more render widgets where they improve clarity, such as candle and line charts
- keep the debug log useful, but visually lighter when possible
- extend the strategy set only once the shared config and display model are clean

## Routes
- `GET /` minimal landing page
- `GET /health` liveness
- `GET /mcp/sse` MCP SSE endpoint