Skip to content

blackswanwtf/blackswan-mcp

Repository files navigation

BlackSwan MCP Server

Real-time crypto risk intelligence via the Model Context Protocol. Two AI agents monitor what's happening 24/7 — before news breaks, as it breaks, and why it happened. Enables agents to have real-time risk intelligence and awareness, not yesterday's news.

Tools

Tool What it answers
Flare "Is something happening right now?" — Precursor detection from a 15-minute signal window
Core "What's the overall risk environment?" — State synthesis from a 60-minute signal window

Connect

MCP

Point any MCP client at:

https://mcp.blackswan.wtf/mcp

No API key required.

REST API

curl -s https://mcp.blackswan.wtf/api/flare
curl -s https://mcp.blackswan.wtf/api/core

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "blackswan": {
      "type": "http",
      "url": "https://mcp.blackswan.wtf/mcp"
    }
  }
}

Then ask Claude: "What does Flare say about current crypto risk?"

Response Format

Flare

Field Description
agent Always "flare"
data_age Human-readable age (e.g. "12 minutes ago")
status "clear" or "alert"
severity "none", "low", "medium", "high", or "critical"
checked_at ISO 8601 timestamp
assessment Natural language risk assessment
signals Array of detected signals with type, source, and detail

Core

Field Description
agent Always "core"
data_age Human-readable age (e.g. "1 hour ago")
timestamp ISO 8601 timestamp
environment "stable", "elevated", "stressed", or "crisis"
assessment Natural language risk assessment
key_factors Array of main risk factors
sources_used Data sources used in the assessment
data_freshness How fresh the underlying data is

Interpreting Results

Flare Severity

Level Meaning
none No precursors detected, markets quiet
low Minor signals, worth noting but not actionable
medium Notable signals, warrants attention
high Strong precursors, elevated risk of sudden moves
critical Extreme signals, immediate risk of major event

Core Environment

Level Meaning
stable Normal conditions, low systemic risk
elevated Above-normal risk, some stress indicators
stressed Significant stress across multiple indicators
crisis Severe market stress, active dislocation or contagion

Error Responses

HTTP Status Meaning
200 Success
502 Agent output failed validation
503 No recent agent runs — system may be starting up
500 Unexpected server error

Non-200 responses return {"error": "..."} with a human-readable message.

License

MIT

About

BlackSwan Risk Intelligence MCP Server

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •