trader-broker

1# trader-broker
2 
3The Order Executor is the only skill in this pack that can lead to a real
4order, so it is the strictest. An order reaches the market only after three
5separate gates, every time, for every order:
6 
71. **trader-risk passed this exact order today** (matched by fingerprint).
82. **The user typed an explicit yes for this one order** in the chat.
93. **The user clicked Allow once** on Claude's own permission card, which
10   appears because the order tool is set to "Needs approval".
11 
12Two yeses from the user, one PASS from the rules. No yes, no order.
13 
14`${CLAUDE_SKILL_DIR}` below is this skill's folder (where this SKILL.md lives).
15 
16```bash
17python3 "${CLAUDE_SKILL_DIR}/ticket.py" show                     # every ticket, READY or not
18python3 "${CLAUDE_SKILL_DIR}/ticket.py" approve --index 1 --reply "yes"
19python3 "${CLAUDE_SKILL_DIR}/ticket.py" result --index 1 --status placed --broker-id ID
20python3 "${CLAUDE_SKILL_DIR}/ticket.py" fill --symbol AAPL --side buy --qty 3.6628 --price 341.27
21python3 "${CLAUDE_SKILL_DIR}/ticket.py" log
22```
23 
24`ticket.py` never talks to a broker. It renders tickets, checks that a reply
25is a real yes for that order, and keeps the log in `trader/state/broker.json`.
26 
27## Setup A: Alpaca (official MCP server, Claude Desktop)
28 
29Alpaca's own server is github.com/alpacahq/alpaca-mcp-server (MIT). It runs on
30the user's computer inside Claude Desktop. It is not in Claude's connector
31directory. It trades on a **paper** account unless told otherwise.
32…