TRADER_COMPATIBILITY_NOTE.md 1.0 KB

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.