kraken

# Kraken Exchange

MCP server for the [Kraken](https://www.kraken.com) cryptocurrency exchange — **114 tools** covering spot, futures, REST, and WebSocket APIs. Source: [github.com/askbeka/tentactl](https://github.com/askbeka/tentactl) (MIT license).

## How It Works

`tentactl` is a Rust binary that speaks MCP (Model Context Protocol) over stdio. It provides:

- **Spot REST** (57 tools): Market data, account info, trading, funding, earn, subaccounts, exports
- **Futures REST** (21 tools): Instruments, positions, orders, transfers, funding rates
- **Spot WebSocket v2** (19 tools): Live market data streams, real-time order management
- **Futures WebSocket** (17 tools): Live futures feeds, real-time futures trading

## Setup

### 1. Install the binary

```bash
cargo install tentactl
```

Or download from [GitHub Releases](https://github.com/askbeka/tentactl/releases) (Linux, macOS, Windows).

### 2. Configure API keys (optional)

Market data tools work **without any keys**. For account and trading tools:

```bash
echo "KRAKEN_API_KEY=your-key" > ~/.tentactl.env
echo "KRAKEN_API_SECRET=your-secret" >> ~/.tentactl.env
chmod 600 ~/.tentactl.env
```

Or use the 1Password setup script: `scripts/setup-keys.sh`

**Key permissions:** Create keys at https://www.kraken.com/u/security/api
- Read-only: enable **Query Funds** and **Query Open Orders & Trades**
- Trading: also enable **Create & Modify Orders**

## Usage

```bash
# Market data (no auth)
scripts/kraken.sh get_ticker '{"pair":"XBTUSD"}'
scripts/kraken.sh get_orderbook '{"pair":"ETHUSD","count":5}'
scripts/kraken.sh futures_tickers '{}'

# Live WebSocket streams
scripts/kraken.sh ws_subscribe_ticker '{"symbols":["BTC/USD"]}'
scripts/kraken.sh ws_subscribe_book '{"symbols":["ETH/USD"],"depth":10}'
scripts/kraken.sh wf_subscribe_ticker '{"product_ids":["PI_XBTUSD"]}'
scripts/kraken.sh ws_status '{}'

# Account (needs API keys)
scripts/kraken.sh get_balance '{}'
scripts/kraken.sh futures_open_positions '{}'

# Trading (needs API keys) ⚠️ REAL MONEY
scripts/kraken.sh place_order '{"pair":"XBTUSD","direction":"buy","order_type":"limit","volume":"0.001","price":"50000","validate":true}'
scripts/kraken.sh ws_add_order '{"symbol":"BTC/USD","side":"buy","order_type":"limit","limit_price":"50000","order_qty":"0.001","validate":true}'
```

## Tools Reference

See `references/tools.md` for full parameter docs on all 114 tools.

## Safety Rules

- **ALWAYS** use `validate: true` first when placing orders
- **ALWAYS** confirm with the user before placing real orders
- **NEVER** place orders without explicit user approval
- Market orders execute IMMEDIATELY — prefer limit orders
- Display validation result and ask for confirmation before removing `validate`
- Trading tools are marked with ⚠️ REAL MONEY in their descriptions

## Trading Pairs

- **Spot REST:** Kraken format — `XBTUSD`, `ETHUSD`, `SOLUSD`
- **Spot WebSocket:** Standard format — `BTC/USD`, `ETH/USD`, `SOL/USD`
- **Futures:** Product IDs — `PI_XBTUSD`, `PI_ETHUSD`, `PF_SOLUSD`

## Automation Patterns

### DCA (Dollar Cost Average)
```
openclaw cron add --schedule "0 9 * * 1" --task "Buy $50 of BTC on Kraken using the kraken skill. Use validate first, then execute."
```

### Price Alerts
Subscribe to WebSocket ticker, check thresholds in heartbeat/cron, notify via WhatsApp/Telegram.

### Portfolio Monitoring
Cron job that checks balances + positions + current prices, calculates P&L, alerts on significant changes.

### Funding Rate Arbitrage
Subscribe to futures tickers, monitor funding rates, alert when rates diverge significantly.