Hermes MCP

Hermes MCP is a FastAPI + MCP supervisor for market interpretation, strategy selection, and Trader control.

What Hermes does

builds a market narrative from regime data
scores strategy fit for each account/market concern
records decision snapshots for audit and dashboarding
optionally dispatches Trader control actions through a single guarded write path

Surface

MCP transport: /mcp/sse
Health: /health
Dashboard: /dashboard/
Primary tool: report()

Hermes to Trader control path

Hermes reads Trader state via strategy snapshots and writes only through Trader's canonical action tool:

apply_control_decision(payload)

Dispatch is gated locally by:

HERMES_ALLOW_ACTIONS

When the gate is false, Hermes still makes and records decisions, but returns a blocked dispatch result instead of changing Trader state.

Run

./run.sh 8590

Test

./tests.sh