Ask Claude how BTC really is.
Add RiskState to Claude as a custom connector — one URL, no API key, 2 minutes. Claude gets live BTC/ETH risk state, market structure and trading playbooks instead of guessing from training data.
https://api.riskstate.ai/mcpCustom connectors are available on Claude Pro, Max, Team and Enterprise plans (claude.ai and the desktop app). Claude Code works too — see step 3.
Set up in 3 steps
- 1
Open the connectors settings
In claude.ai (or the Claude desktop app), go to Settings → Connectors.
- 2
Add the custom connector
Click "Add custom connector", name it RiskState, and paste the URL https://api.riskstate.ai/mcp. No authentication is required — leave the auth fields empty and confirm.
- 3
Ask about BTC or ETH
In any chat, make sure the connector is enabled in the search & tools menu, then ask: "What's the current risk state of BTC?". In Claude Code, add it with: claude mcp add --transport http riskstate https://api.riskstate.ai/mcp
What you can ask
Each question maps to one of the three engine tools. Click to copy.
Three engines, three tools
The connector exposes the RiskState Stack as chat tools. Data refreshes roughly every 2 minutes.
5-level risk policy for BTC or ETH: max position size, leverage cap, direction bias, allowed and blocked actions — plus composite, structural and tactical scores, market regime, volatility regime and cycle phase.
Structural events firing now, expected asymmetry, distance to the next bullish and bearish triggers, key levels (ATH, 200W MA, 180-day range) and a friction map of support/resistance walls.
The registry of rule-based trade setups for BTC and ETH and which ones are firing right now, with structure-gate verdicts and cooldown state. Strategy-level only — no prices or sizes.
Free connector vs full API
The connector serves the free public summary tier. The full, auditable response is the API product.
| Feature | Connector | API key |
|---|---|---|
| Risk policy level, max size, direction bias | ✓ | ✓ |
| Composite, structural & tactical scores | ✓ | ✓ |
| Market regime, volatility regime, cycle phase | ✓ | ✓ |
| Market structure events, triggers & friction map | ✓ | ✓ |
| Playbook registry & firing status | ✓ | ✓ |
| policy_hash audit trail (non-repudiation) | — | ✓ |
| Composite subscores & factor contributions | — | ✓ |
| Positioning detail (funding percentiles, OI z-scores, squeeze) | — | ✓ |
| Macro detail & per-source data status | — | ✓ |
| Portfolio-level /v2 endpoints (aggregation, stress, ES95/ES99) | — | ✓ |
Frequently asked questions
Which Claude plans support custom connectors?+
Pro, Max, Team and Enterprise. Custom connectors are added from Settings → Connectors on claude.ai or the desktop app. The free plan does not include custom connectors.
Is it really free? What's the catch?+
Yes. The connector serves the same free public summary tier as the RiskState Risk Engine viewer — no key, no signup, no catch. The full response (policy_hash audit trail, composite subscores, positioning and macro detail, portfolio-level /v2 endpoints) is the API product and requires an API key.
What about my privacy? Do you see my conversations?+
No. The connector requires no account and no authentication, so there is nothing to link requests to you. Your AI assistant calls our endpoint server-side and we only ever return public market data — we never receive or store your conversation.
How fresh is the data?+
Summaries are computed from 9+ real-time data sources and refreshed roughly every 2 minutes. Each response carries its own timestamp.
Is this financial advice?+
No. RiskState returns risk governance data — policy levels, exposure limits and market state. What you do with it is your decision. Nothing here is investment advice.
How is this different from the @riskstate/mcp-server npm package?+
The npm package is a local (stdio) MCP server for developers and trading agents: it requires an API key and returns the full v1 response. This remote endpoint is the keyless, zero-install version for chat use — same engine, summary tier.
Claude isn't calling the tool — what do I do?+
Check the connector is enabled for the chat (search & tools menu below the message box), then ask explicitly: "Use RiskState to check the current risk state of BTC." Once it has called a tool successfully, natural questions work fine.
Using ChatGPT instead?
Add RiskState to ChatGPT →RiskState returns risk governance data — policy levels, exposure limits and market state. It is not investment advice.