# Trader-MCP compatibility note

This note is for Hermes-MCP developers.

## Trader taxonomy expected by Hermes

Canonical strategy set currently being stabilized:
- `grid`
- `Exposure Protector` (defensive exposure rebalancer)
- `trend_follower`
- `idle`
- `defensive`
- `mean_reversion`
- `breakout`
- `event_driven`

## Trader contract locations

Primary contract and runtime docs live in `trader-mcp/`:
- `trader-mcp/Hermes_Trader_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`
- `position`
- `state`
- `assessment`
- `execution`

## Hermes control path

Hermes should use:
- `set_strategy_policy()` for high-level policy (`risk_posture`, `priority`)
- `control_strategy()` for lifecycle (`start`, `stop`, `pause`, `resume`, `reconcile`)

Policies are applied on reconcile and instance creation.