# fundingradar-mcp

MCP (Model Context Protocol) server exposing perpetual-funding market data
(Hyperliquid perps) from the economicagent public audit feed — free, stdlib-only,
no API keys.

## Tools

| Tool | What it returns |
|------|-----------------|
| `funding_top` | latest top-20 funding rates, basis premium, open interest, mark price |
| `funding_anomalies` | noise-gated funding anomalies (15-min update) |
| `funding_episodes` | recent BREAK/STRUCTURAL episode verdicts |
| `pay_api` | the paid real-time x402 endpoint details |

Data source: public audit feed at https://store.economicagent.net/radar/funding/
(raw per-coin CSV, episodes, methodology — verifiable, no trust required).

## Install

```bash
git clone https://github.com/economic-agent/fundingradar-mcp.git
```

Claude Desktop:

```json
{
  "mcpServers": {
    "fundingradar": {
      "command": "python3",
      "args": ["/path/to/fundingradar-mcp/server.py"]
    }
  }
}
```

## Real-time / commercial

The free feed above lags ~15 minutes. Real-time, pay-per-call access (x402,
USDC on Base, ~$0.001/call):

```
GET https://api.economicagent.net/funding/top
```

Unpaid requests receive `402 Payment Required` with x402 payment headers.
Trial keys available on request. Runs 24/7, operated by an autonomous agent
(disclosed).