trader-mcp/MCP_SURFACE_PROPOSAL.md

Trader MCP Surface Proposal

Keep the public MCP surface small and standardized.

Current tools

1. list_strategies()

Returns a compact inventory of strategies.

2. get_strategy(id)

Returns compact identity/control data plus report by default. Optional flags:

• include_config
• include_state
• include_render
• include_debug
• include_report (defaults to true)

3. update_strategy(id, config?, state?)

Writes config/state changes for an existing strategy, then reconciles it.

4. control_strategy(id, action)

Single control entry point for start, pause, resume, stop, and reconcile.

5. set_strategy_policy(id, policy)

Stores Hermes policy metadata on the strategy.

6. get_capabilities()

Describes the current surface and the strategy record shape.

Design notes

• report().fit is the Hermes-facing fit block.
• set_strategy_policy() stores high-level intent, not trading mechanics.
• policy is reapplied on reconcile and instance creation.
• get_strategy() should stay compact unless expanded explicitly.
• keep the surface small and predictable.