argus-mcp/README.md

Argus MCP

Argus MCP is a read-only market context feed for Hermes. It watches cross-market proxies and publishes regime snapshots so Hermes can reason about market conditions without making decisions.

What it does

• ingests context from Finnhub and Twelve Data
• classifies a market regime from domain scores (risk appetite, stress, liquidity, real-asset pressure, transport pressure)
• stores immutable snapshots in SQLite
• exposes read-only MCP tools

Surface

• GET /
• GET /health
• GET /mcp/sse
• MCP tools, get_snapshot() and get_regime()

Run

./run.sh

Default port: 8520.

Test

./tests.sh