Three independent engines, each answering a different question before a trade is placed. Deterministic, hash-audited, and callable by a human or an agent.
| Engine | The question it answers | Endpoint | Auth |
|---|---|---|---|
| Risk Engine | How much exposure is allowed? | POST /v1/risk-state |
API key |
| Market Structure Engine | Are we near a structural inflection? | POST /v1/market-structure |
API key |
| Trading Playbook Engine | Is a setup live right now? | GET /api/playbook-data |
public |
BTC/USD and ETH/USD. Spot, perpetual futures, and DeFi borrowing aware. Not a signal. Not an oracle. A policy engine that governs size.
POST /v1/risk-state { "asset": "BTC" }
→ max_size: 35% · leverage_max: 1.5x · blocked: ["LEVERAGE_GT_2X"]
A keyless remote MCP server — nothing to install:
https://api.riskstate.ai/mcp
Add it as a custom connector in Claude or ChatGPT, then ask what the risk state of BTC is.
On the official MCP registry as ai.riskstate/mcp.
npm install @riskstate/market-structure-engine # or @riskstate/trading-playbook-engine
pip install riskstate-market-structure # or riskstate-trading-playbook
npx @riskstate/mcp-server # stdio MCP server| Repo | What's inside |
|---|---|
risk-engine |
REST docs for /v1/risk-state + the SKILL.md agent-discovery file |
market-structure-engine |
Typed TS + Python client, response types, examples, offline fixture |
trading-playbook-engine |
The same integration kit for the playbook registry |
mcp |
MCP server — published as @riskstate/mcp-server |
agent-setups |
Reference architectures wiring autonomous agents to external risk governance |
The engines themselves are closed-source. These repos are the integration surface: clients, types, docs and examples.
Risk Engine live view · Market Structure · Playbooks · API demo
Running a desk or a fund? The /v2 endpoints aggregate risk across a whole book — portfolio limits, stress scenarios, expected shortfall, audit trail. See institutional docs.
riskstate.ai · Docs · The stack · @riskstate_ai · API v1.4.0 · Risk governance data, not financial advice.