Deterministic risk governance for crypto trading agents. Answers "How much can I risk?" with policy level, max position size, leverage limits, and blocked actions — computed from 9+ real-time data sources (on-chain, derivatives, macro, sentiment). Supports BTC and ETH. One tool: get_risk_policy.
Overview
RiskState MCP Server
Risk governance API for autonomous crypto trading agents.
What it does
Your agent asks: "How much can I risk?"
RiskState answers with a deterministic policy computed from 9+ real-time data sources:
- Policy level — 5 levels from BLOCK (survival) to GREEN (expansion)
- Max position size — % of portfolio cap (0-100)
- Leverage limit — Maximum allowed multiplier
- Allowed/blocked actions — What the agent can and cannot do
- Confidence score — Signal agreement × data quality
Tool: get_risk_policy
| Parameter | Type | Required | Description |
|---|---|---|---|
asset | "BTC" or "ETH" | Yes | Asset to analyze |
wallet_address | string | No | DeFi wallet for on-chain position data |
protocol | "spark" or "aave" | No | Lending protocol (default: spark) |
include_details | boolean | No | Full breakdown (subscores, macro, risk flags) |
Example Response
{
"exposure_policy": {
"policy_level": "CAUTIOUS",
"max_size_pct": 35,
"leverage_max": 1.5,
"allowed_actions": ["DCA", "WAIT", "SPOT_LONG_CONFIRMED"],
"blocked_actions": ["LEVERAGE_GT_2X", "NEW_POSITIONS_UNCONFIRMED"]
},
"classification": {
"cycle_phase": "MID",
"market_regime": "RANGE",
"macro_regime": "NEUTRAL",
"direction": "SIDEWAYS"
},
"auditability": {
"composite_score": 52,
"confidence_score": 0.72,
"policy_hash": "a3f8c2...",
"ttl_seconds": 60
}
}
Server Config
{
"mcpServers": {
"riskstate": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"RISKSTATE_API_KEY",
"ghcr.io/likidodefi/riskstate-mcp"
],
"env": {
"RISKSTATE_API_KEY": "<your_api_key>"
}
}
}
}