# RadhikaChain x402 MCP Server

MCP (Model Context Protocol) server exposing the **live RadhikaChain x402 paid-API catalog**: 52 machine-readable resources paid per-call in USDC via the [x402 HTTP payment protocol](https://x402.mintbase.io/).

## What you can buy (per call, no subscription)

| Resource | Price | What it is |
|---|---|---|
| `/alice/decisiones` | $0.99 | Autonomous operator decisions from a RadhikaChain-tuned model |
| `/amenazas/vivas` | $0.825 | Live attacker intelligence from an in-kernel XDP/eBPF sensor |
| `/attacks/confirmed` | $0.66 | Multi-witness confirmed attack campaigns |
| `/zk/prove` | $0.99 | On-demand Halo2 / Nova / Plonky3 proof generation |
| `/arb/live` | $1.65 | Live triangular arb signals with net/gross and execute flag |
| `/chain/health` | $0.033 | RadhikaChain L1 health snapshot |
| ...47 more | $0.03–$33 | Full catalog via the `listar_recursos` tool |

Every resource has a **free sample endpoint** (`/muestra/<recurso>`) so agents can inspect data shape before paying.

## Tools

- `listar_recursos` — full catalog with prices, descriptions and sample URLs
- `obtener_muestra` — fetch a free sample of any resource
- `comprar_recurso` — execute an x402 purchase (requires configured key) and return the payload
- `saldo_agente` — check PRANA agent balance
- `alta_agente` — register as a RadhikaChain agent

## Setup

```bash
pip install -e .
export RADHIKA_GATEWAY_URL="https://x402.radhikachain.xyz"
# Optional: for automatic payments
export RADHIKA_PRIVATE_KEY="0x..."
```

```bash
python -m radhika_mcp.mcp_server
```

## Why

Agents need data they can trust and pay for on demand: kernel-level threat telemetry measured by our own fleet (not scraped dashboards), ZK proofs generated live, and arb signals from a running executor. x402 makes each call self-settling — no API keys, no accounts, just pay-per-request over HTTP 402.

## Links

- Catalog: https://x402.radhikachain.xyz/.well-known/x402
- Checkout UI: https://x402.radhikachain.xyz/checkout
- Chain explorer: https://radhikachain.xyz