# Trader-MCP compatibility note

This note is for Hermes-MCP developers.

## Trader taxonomy expected by Hermes

Canonical strategy set currently used by Hermes supervision:
- `grid_trader`
- `trend_follower`
- `exposure_protector`

## Trader contract locations

Primary contract and runtime docs live in `trader-mcp/`:
- `trader-mcp/Hermes_Trader_Contract_v0.1.md`
- `trader-mcp/Hermes_Trader_Action_Contract_v0.1.md`
- `trader-mcp/Strategy_Contract.md`
- `trader-mcp/Strategy_Runtime.md`
- `trader-mcp/MCP_SURFACE_PROPOSAL.md`
- `trader-mcp/TODO.md`

## Hermes-facing data

Hermes should read strategy snapshots via `report()`.
Important fields:
- `identity`
- `control`
- `fit`
- `supervision`
- `position`
- `state`
- `assessment`
- `execution`

## Hermes control path

Hermes should write through one canonical Trader tool:
- `apply_control_decision(payload)`

Trader may still use these internally or for operator workflows:
- `control_strategy()`
- `set_strategy_policy()`

The current supervision hints used by Hermes include:
- `inventory_pressure`
- `switch_readiness`
- `desired_companion`

`grid_trader` semantics are intentionally conservative now:
- `ready_for_handoff` means true depletion, not merely directional conditions
- `watch_handoff` means directional pressure plus moderate imbalance
- `prefer_hold` means the grid does not self-report handoff pressure

Policies are still applied on reconcile and instance creation.