trader-mcp

Trader MCP v0.5.0

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

Release notes

This release marks the point where the stack is genuinely usable:

• grid trader places, replaces, recenters, and resizes orders as expected
• strategy execution is stable enough to run continuously
• shared execution now uses real fees for sizing
• strategy state and dashboard behaviour are aligned with live trading flow
• the public MCP surface stays compact while the runtime behaviour is much more complete

What works now

• grid trading with live order placement and reconciliation
• observe, pause, resume, stop, and reconcile control actions
• live render panels and inline strategy config editing
• account overview in the dashboard, kept intentionally out of the way

Next ideas

Further improvements may include more strategies, a cleaner shared config schema, and extra render widgets such as candles or line graphs. These are useful follow-ups, but they are not blockers for the current release.

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.