For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

MCP

Access BlackSwan via the Model Context Protocol. Works with Claude Desktop, OpenClaw, and other MCP clients.

Endpoint

https://mcp.blackswan.wtf/mcp

No API key required.

What's Included

Tool
Timeframe

flare

15 minute window

core

1 hour window

Both return the latest cached analysis.

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?"

  • "Give me a Core risk assessment"

REST API

If you don't need MCP, use the REST endpoints directly:

Limitations

  • Returns cached analysis (updated periodically)

  • No custom parameters

  • Rate limited

For real-time custom analysis, use x402.

Error Handling

HTTP Status
Meaning

200

Success

502

Agent output failed validation

503

No recent agent runs

500

Server error

Last updated