4.3kâ
blackclaw â OpenClaw Skill
blackclaw is an OpenClaw Skills integration for coding workflows. Real-time crypto risk intelligence; before and as things break. Two tools: Flare (15-min precursor detection, immediate alarms) and Core (60-min state synthesis, context assessment). Free access to the last analysis. No API key required. Upgrade to x402 for custom analysis.
Skill Snapshot
| name | blackclaw |
| description | Real-time crypto risk intelligence; before and as things break. Two tools: Flare (15-min precursor detection, immediate alarms) and Core (60-min state synthesis, context assessment). Free access to the last analysis. No API key required. Upgrade to x402 for custom analysis. OpenClaw Skills integration. |
| owner | bilalmotiwala |
| repository | bilalmotiwala/blackswan |
| language | Markdown |
| license | MIT |
| topics | |
| security | L1 |
| install | openclaw add @bilalmotiwala/blackswan |
| last updated | Feb 7, 2026 |
Maintainer

name: blackclaw description: "Real-time crypto risk intelligence; before and as things break. Two tools: Flare (15-min precursor detection, immediate alarms) and Core (60-min state synthesis, context assessment). Free access to the last analysis. No API key required. Upgrade to x402 for custom analysis." homepage: https://github.com/blackswanwtf/blackswan-mcp metadata: {"emoji": "ðĶĒ", "requires": {"bins": ["curl"]}}
BlackSwan Risk Intelligence
BlackSwan monitors crypto markets 24/7 and produces two risk assessments:
- Flare â Precursor detection from a 15-minute signal window. Use for immediate, alarm-bell risk checks. Before the news breaks.
- Core â State synthesis from a 60-minute signal window. Use for market context and risk assessment. As the news breaks.
When to use each tool
| Question | Tool |
|---|---|
| "Is something happening right now?" | Flare |
| "What's the overall market risk environment?" | Core |
| "Should I be worried about sudden moves?" | Flare |
| "Give me a full risk briefing" | Both (Flare first, then Core) |
Base URL
https://mcp.blackswan.wtf
Endpoints
GET /api/flare
Returns the latest Flare precursor detection assessment.
curl -s https://mcp.blackswan.wtf/api/flare
Response fields:
| Field | Description |
|---|---|
agent | Always "flare" |
data_age | Human-readable age of the data (e.g. "12 minutes ago") |
status | "clear" or "alert" |
severity | "none", "low", "medium", "high", or "critical" |
checked_at | ISO 8601 timestamp of the assessment |
assessment | Natural language risk assessment |
signals | Array of detected signals, each with type, source, and detail |
GET /api/core
Returns the latest Core state synthesis assessment.
curl -s https://mcp.blackswan.wtf/api/core
Response fields:
| Field | Description |
|---|---|
agent | Always "core" |
data_age | Human-readable age of the data (e.g. "1 hour ago") |
timestamp | ISO 8601 timestamp of the assessment |
environment | "stable", "elevated", "stressed", or "crisis" |
assessment | Natural language risk assessment |
key_factors | Array of strings describing the main risk factors |
sources_used | Array of data source names used in the assessment |
data_freshness | Description of how fresh the underlying data is |
Interpreting severity levels (Flare)
| Severity | Meaning |
|---|---|
none | No precursors detected, markets quiet |
low | Minor signals, worth noting but not actionable |
medium | Notable signals, warrants attention |
high | Strong precursors detected, elevated risk of sudden moves |
critical | Extreme signals, immediate risk of major market event |
Interpreting environment levels (Core)
| Environment | Meaning |
|---|---|
stable | Normal market conditions, low systemic risk |
elevated | Above-normal risk, some stress indicators present |
stressed | Significant stress across multiple indicators |
crisis | Severe market stress, active dislocation or contagion |
Error handling
| HTTP Status | Meaning |
|---|---|
200 | Success, response contains full assessment |
502 | Agent output failed validation â format may have changed |
503 | No recent agent runs â system may be starting up |
500 | Unexpected server error |
On non-200 responses, the body is {"error": "..."} with a human-readable message.
Complete risk check pattern
To get a full picture, call both endpoints:
curl -s https://mcp.blackswan.wtf/api/flare
curl -s https://mcp.blackswan.wtf/api/core
Present Flare results first (immediate risks), then Core (broader context).
No README available.
Permissions & Security
Security level L1: Low-risk skills with minimal permissions. Review inputs and outputs before running in production.
Requirements
- OpenClaw CLI installed and configured.
- Language: Markdown
- License: MIT
- Topics:
FAQ
How do I install blackclaw?
Run openclaw add @bilalmotiwala/blackswan in your terminal. This installs blackclaw into your OpenClaw Skills catalog.
Does this skill run locally or in the cloud?
OpenClaw Skills execute locally by default. Review the SKILL.md and permissions before running any skill.
Where can I verify the source code?
The source repository is available at https://github.com/openclaw/skills/tree/main/skills/bilalmotiwala/blackswan. Review commits and README documentation before installing.
