# Nyra Crypto MCP

**MCP server for crypto trading signals — pay-per-call via x402 micropayments on Base.**

Agents pay $0.02–$0.05 per call in USDC to get real-time momentum signals, Kronos 24h BTC forecasts, and market regime data. No API keys, no subscriptions — pure micropayments.

## Tools

| Tool | What it does | Price |
|---|---|---|
| `get_signal(pair)` | Momentum score + signal for BTC/ETH/SOL/XRP/ADA | $0.02 |
| `get_all_signals()` | All pairs at once | $0.03 |
| `get_forecast(BTC)` | Kronos 24h calibrated price range | $0.05 |
| `get_market_context()` | Full context: signals + regime + forecast | $0.03 |
| `ping` | Free health check | Free |

## Data Sources

- **Kraken live scanner** — real-time volume + momentum across 6 pairs (updated every 30m)
- **Kronos foundation model** — BTC 24h forecast with conformally-calibrated ranges (updated every 4h)
- **Market regime** — trend/chop classification from aggregated signals

## Usage

### For AI Agents (MCP over SSE)

```json
{
  "mcpServers": {
    "nyra-crypto": {
      "url": "http://178.105.56.183:4020/sse"
    }
  }
}
```

The MCP client handles x402 payment automatically — when a tool requires payment, it gets an HTTP 402, sends USDC via the agent's wallet, and retries.

### For Human Developers (REST API)

```
GET http://178.105.56.183:4020/health
```

## Deploy

```bash
bash deploy.sh
```

## Architecture

```
AI Agent (Claude/Cursor/Codex)
    │  MCP (SSE)
    ▼
Nyra Crypto MCP Server (Node.js/Express)
    │  x402 payment middleware
    ▼
x402 Facilitator (Coinbase/PayAI)
    │  USDC settlement on Base
    ▼
Your Wallet (0x7F915e5272ae...)
```

## Signal Cache

Signals are updated every 30 minutes by a cron job:
```bash
~/.hermes/scripts/signal_cache.py → ~/.hermes/signals/signal_cache.json
```

## Revenue Model

| Tool | Price | Est. calls/mo | Est. revenue |
|---|---|---|---|
| get_signal | $0.02 | 500 | $10 |
| get_all_signals | $0.03 | 200 | $6 |
| get_forecast | $0.05 | 200 | $10 |
| get_market_context | $0.03 | 300 | $9 |
| **Total** | | | **~$35/mo** |

Revenue scales with agent adoption. The real value is positioning in the bot-to-bot economy.