README.md
Minimal REST service for managing trade plans.
MCP Trade Plan Service
Minimal REST service for managing trade plans.
Endpoints
POST /trade-plansGET /trade-plans?account_id=&strategy_id=&status=GET /trade-plans/{id}POST /trade-plans/{id}/closePOST /trade-plans/{id}/cancel
Run
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
Example create payload
{
"account_id": "paper-1",
"strategy_id": "signal_calls_v1",
"signal": {
"signal_id": "sig-2026-02-26-145500",
"source": "model_x",
"ts": "2026-02-26T21:55:00Z"
},
"instrument": {
"underlying": "TSLA",
"type": "option",
"selector": {
"ticker": "TSLA240503P00115000"
}
},
"entry": {
"qty": 2,
"order": {
"type": "limit",
"cancel_if_not_filled_sec": 45
},
"max_debit_usd": 400
},
"take_profit": {
"mode": "percent",
"pct": 0.3,
"order": {
"type": "limit",
"limit_price_method": "mid",
"time_in_force": "gtc"
}
},
"position_rules": {
"max_open_plans_per_underlying": 1,
"close_on_expiry_days_lte": 1
},
"idempotency_key": "signal_calls_v1:paper-1:sig-2026-02-26-145500"
}
Tools (5)
create_trade_planCreates a new trade plan with specific entry and take-profit strategies.list_trade_plansRetrieves a list of trade plans based on account, strategy, or status filters.get_trade_planFetches details for a specific trade plan by ID.close_trade_planCloses an active trade plan.cancel_trade_planCancels a pending trade plan.Configuration
claude_desktop_config.json
{"mcpServers": {"mcp-trader": {"command": "python", "args": ["/path/to/mcp-trader/app/main.py"]}}}Try it
→Create a new trade plan for TSLA options using the signal_calls_v1 strategy.
→List all active trade plans for my paper-1 account.
→Close the trade plan with ID 12345.
→Check the status of my recent trade plan for the TSLA ticker.