# BLOT Nado MCP Server v2

Trade perpetuals on [Nado DEX](https://nado.xyz) (Ink chain) via [BLOT](https://blot.wtf) Builder 300. Supports multi-wallet management, automated strategies, and pair trading. All trades earn **DRIP** rewards.

## Tools (22 total)

### Wallet Management
| Tool | Description |
|------|-------------|
| `create_wallet` | Generate a new wallet (key + address) |
| `import_wallet` | Import an existing private key |
| `list_wallets` | Show all wallets with active status |
| `switch_wallet` | Change the active trading wallet |
| `remove_wallet` | Remove a wallet from registry |

### Market Data
| Tool | Description |
|------|-------------|
| `list_markets` | All live perp markets with prices |
| `get_price` | Bid/ask/mid for a specific market |
| `market_info` | Quick product ID reference |

### Account
| Tool | Description |
|------|-------------|
| `get_account` | Equity, collateral, margin, leverage |
| `get_positions` | Open positions with PnL |

### Trading
| Tool | Description |
|------|-------------|
| `place_order` | Market or limit order (earns DRIP) |
| `close_position` | Close an existing position |
| `cancel_order` | Cancel a limit order |
| `get_open_orders` | List pending orders |
| `pair_trade` | Long + short two assets |
| `deposit` | Deposit USDT0 into trading account |
| `withdraw` | Withdraw USDT0 to wallet |

### Strategy Automation
| Tool | Description |
|------|-------------|
| `create_pair_strategy` | Auto pair trade on z-score thresholds |
| `create_basis_strategy` | Auto farm funding rate when APR is high |
| `start_strategy` | Start a paused strategy |
| `pause_strategy` | Pause a running strategy |
| `stop_strategy` | Stop a strategy permanently |
| `delete_strategy` | Remove a strategy |
| `list_strategies` | Show all strategies with stats |
| `strategy_logs` | View recent strategy log entries |

### Utilities
| Tool | Description |
|------|-------------|
| `bridge_guide` | Instructions for bridging funds to Ink |

## Setup

### 1. Install & Build

```bash
cd ~/Downloads/blot-nado-mcp
npm install
npm run build
```

### 2. Add to Cursor

Edit `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "blot-nado": {
      "command": "node",
      "args": ["/Users/meow/Downloads/blot-nado-mcp/dist/index.js"],
      "env": {
        "NADO_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}
```

> `NADO_PRIVATE_KEY` is optional if you use `create_wallet` or `import_wallet` to set up wallets through the tool.

### 3. Add to Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "blot-nado": {
      "command": "node",
      "args": ["/Users/meow/Downloads/blot-nado-mcp/dist/index.js"],
      "env": {
        "NADO_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}
```

## How It Works

### Wallet Flow (for bots)

1. **`create_wallet`** generates a fresh private key + Ink address
2. Bridge USDT0 to that address (use `bridge_guide` for instructions)
3. **`deposit`** moves funds into the Nado clearinghouse
4. Trade with **`place_order`**, **`pair_trade`**, etc.
5. All orders include **BLOT Builder 300** (3 bps fee) — every trade earns DRIP

No signup, no API keys, no KYC. It's on-chain.

### Multi-Account

```
"Create wallet bot-alpha"          → generates key, sets as active
"Create wallet bot-beta"           → generates key
"Switch to bot-alpha"              → all trades now use bot-alpha
"Show my account"                  → shows bot-alpha's equity/positions
```

Wallets are stored in `~/.blot-nado/wallets.json`.

### Automated Strategies

**Pair Z-Score Strategy:**
```
"Create a pair strategy: ETH vs BTC, $500 per trade, enter at z-score 2, exit at 0.5"
"Start the strategy"
```
The bot will check the ETH/BTC price ratio every 5 minutes and:
- Open a mean-reversion trade when z-score exceeds ±2
- Close when z-score reverts to ±0.5

**Basis Farming Strategy:**
```
"Create a basis strategy for BTC, $1000, min 5% APR"
"Start it"
```
The bot will:
- Monitor BTC funding rate
- Enter when APR > 5% (short if positive funding, long if negative)
- Exit when APR drops below 2.5%

Strategies survive server restarts (state saved in `~/.blot-nado/strategies.json`).

## Data Storage

| File | Contents |
|------|----------|
| `~/.blot-nado/wallets.json` | Encrypted wallet registry |
| `~/.blot-nado/strategies.json` | Strategy configs, logs, stats |

Override with `BLOT_DATA_DIR` env var.

## Product IDs

| Token | ID | Token | ID |
|-------|-----|-------|-----|
| BTC | 2 | TAO | 32 |
| ETH | 4 | XMR | 34 |
| SOL | 8 | LIT | 36 |
| XRP | 10 | kPEPE | 38 |
| BNB | 14 | PENGU | 40 |
| HYPE | 16 | UNI | 46 |
| ZEC | 18 | ASTER | 48 |
| MON | 20 | XPL | 50 |
| FARTCOIN | 22 | DOGE | 52 |
| SUI | 24 | WLFI | 54 |
| AAVE | 26 | kBONK | 56 |
| XAUT | 28 | ZRO | 58 |
| PUMP | 30 | BCH | 68 |

## Example Prompts

- "Create a wallet called trading-bot"
- "What's the BTC price on Nado?"
- "Buy 0.01 BTC at market"
- "Open a $1000 ETH/SOL pair trade"
- "Create a pair strategy: long ETH short BTC, $500, z-score entry 2.0"
- "Start the strategy"
- "Show my strategy logs"
- "How do I bridge funds to Ink?"