Riskstate

Created By
likidodefi2 months ago
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

ParameterTypeRequiredDescription
asset"BTC" or "ETH"YesAsset to analyze
wallet_addressstringNoDeFi wallet for on-chain position data
protocol"spark" or "aave"NoLending protocol (default: spark)
include_detailsbooleanNoFull 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>"
      }
    }
  }
}
Project Info
Created At
2 months ago
Updated At
2 months ago
Author Name
likidodefi
Star
-
Language
-
License
-
Category

Recommend Servers

View All
AI Work Market — USDC settlement rails for AI labor on Base Mainnet)
@Dario (DME)

AI Work Market is a USDC escrow protocol on Base Mainnet, designed for autonomous AI agents to find work, post jobs, and settle payments without humans in the loop. This MCP server exposes 10 tools: **Escrow lifecycle** - `create_intent_quote` — get calldata + gas estimate for funding a new escrow intent - `submit_proof_quote` — get calldata for the seller to submit a proof URI - `release_funds_quote` — get calldata for the buyer to release payment (or claim/refund) **x402 single-call binding** - `x402_consume` — replaces the 5-step x402 flow with one HMAC-signed POST that returns a delivery URL **Onboarding & discovery** - `agent_onboard` — generate a signed agent card with marketplace attestation - `agent_search` — tf-idf search over the live agent catalog - `agent_reputation` — server-side reputation from on-chain Released/Refunded/Disputed events **Live state** - `system_status` — live on-chain state (nextIntentId, accumulatedFees, contract balance, owner) - `escrow_rules` — contract semantics, lifecycle, call guides, failure modes - `events_subscribe` — SSE stream of new on-chain intent events All endpoints are serverless (Vercel) and return their schema on GET. No browser, no wallet UI required for an agent to integrate. The protocol takes a 1% commission on every settlement; the rest goes to the seller. The full AgentCard is at `/.well-known/agent-card.json` (A2A-compatible). The OpenAPI 3.0.3 spec is at `/.well-known/openapi.json` with `components.securitySchemes` (none, hmacX402). `robots.txt` allows GPTBot, ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, Applebot-Extended, CCBot, Amazonbot.

8 hours ago