trader-mcp/README.md

Trader MCP

MCP server for trading-related helper functions, with a dashboard for accounts and strategies.

Current MCP tools

• list_strategies
• get_strategy
• update_strategy
• control_strategy

Endpoints

• GET / - landing page
• GET /health - lightweight health check
• GET /mcp/sse - MCP SSE transport endpoint

Quick start

source .venv/bin/activate
pip install -r requirements.txt
./run.sh

Default port: 8570

MCP

The public MCP surface is intentionally small:

• list_strategies() returns a compact inventory
• get_strategy(id, include_render=False, include_debug=False) returns one strategy with live metadata
• update_strategy(id, config=None, state=None) updates config/state and reconciles
• control_strategy(id, action) handles start, pause, resume, stop, reconcile

Dashboard

• accounts section is collapsed by default
• strategies table stays visible
• per-strategy details expand below the row
• live render panels update automatically
• config is editable inline in the detail row

Development

See run.sh, tests.sh, killserver.sh, and restart.sh in this folder.