blackclaw

# 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.

```bash
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.

```bash
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...