mcp-orbit-kraken

Kraken exchange plugin for mcp-orbit. Provides 32 MCP tools for trading, account management, and grid trading automation.

Usage

As a plugin (in an existing mcp-orbit server)

import { registerPlugin, startServer } from "mcp-orbit";
import { krakenPlugin } from "mcp-orbit-kraken";

await registerPlugin(krakenPlugin);
startServer({ mode: "stdio", plugins: [krakenPlugin] });

Manual CLI (lokaler Test)

# stdio mode (manual run)
npx mcp-orbit-kraken --stdio

# HTTP mode
npx mcp-orbit-kraken --http --port 3333

Dieser Schritt ist nur für lokale Tests nötig. Claude Desktop (oder andere MCP-Clients) starten den Server selbstständig über ihre Command/Args-Konfiguration.

Claude Desktop configuration

{
  "mcpServers": {
    "kraken": {
      "command": "node",
      "args": ["/path/to/mcp-orbit-kraken/dist/index.js", "--stdio"],
      "env": {
        "KRAKEN_API_KEY": "your-api-key",
        "KRAKEN_PRIVATE_KEY": "your-private-key"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | KRAKEN_API_KEY | Yes (for private endpoints) | Kraken API key | | KRAKEN_PRIVATE_KEY | Yes (for private endpoints) | Kraken API private key | | KRAKEN_DB_PATH | No | SQLite database path for grid trading (default: data/grids.db) | | GRID_CHECK_WEBHOOK_URL | No | Webhook URL for grid monitoring (default: http://localhost:3001) | | GRID_WEBHOOK_SECRET | No | Secret for grid check webhook authentication |

Tools

Public Market Data (no API key required)

| Tool | Description | |------|-------------| | kraken_get_server_time | Get Kraken server time | | kraken_get_system_status | Get system status | | kraken_get_asset_info | Get asset information | | kraken_get_tradable_asset_pairs | Get tradable asset pairs | | kraken_get_ticker_info | Get ticker information | | kraken_get_ohlc_data | Get OHLC candlestick data | | kraken_get_order_book | Get order book depth | | kraken_get_recent_trades | Get recent trades | | kraken_get_recent_spreads | Get recent bid/ask spreads |

Account Balance

| Tool | Description | |------|-------------| | kraken_get_account_balance | Get account balances | | kraken_get_extended_balance | Get extended balance info |

Trading

| Tool | Description | |------|-------------| | kraken_add_order | Place a new order | | kraken_edit_order | Edit an existing order | | kraken_cancel_order | Cancel a specific order | | kraken_cancel_all_orders | Cancel all open orders | | kraken_cancel_all_orders_after | Dead man's switch — cancel all orders after timeout | | kraken_query_orders | Query order status |

Deposits

| Tool | Description | |------|-------------| | kraken_get_deposit_methods | Get available deposit methods | | kraken_get_deposit_addresses | Get deposit addresses | | kraken_get_deposit_status | Get deposit status |

Withdrawals

| Tool | Description | |------|-------------| | kraken_get_withdrawal_methods | Get withdrawal methods | | kraken_get_withdrawal_addresses | Get withdrawal addresses | | kraken_get_withdrawal_info | Get withdrawal fee and limit info | | kraken_withdraw_funds | Execute a withdrawal | | kraken_get_withdrawal_status | Get withdrawal status | | kraken_cancel_withdrawal | Cancel a pending withdrawal |

Misc

| Tool | Description | |------|-------------| | kraken_get_trades_history | Get trade history | | kraken_get_websockets_token | Get WebSocket authentication token | | kraken_wallet_transfer | Transfer between Kraken wallets |

Grid Trading

| Tool | Description | |------|-------------| | grid_plan | Calculate a grid trading plan | | grid_state | CRUD store for grid configurations (save/get/list/delete) | | grid_log | Log and query grid trading events |

Development

npm install
npm run build
npm run start:stdio

License

MIT