Bitkub MCP Server

MCP (Model Context Protocol) server for Bitkub API — Thailand's leading cryptocurrency exchange. Market data, trading, orders, wallet, and crypto management through 28 tools.

Works with Claude Desktop, Cursor, VS Code, and any MCP client.

WARNING: This package interacts with a real cryptocurrency exchange. All trading and withdrawal operations use real money. Use with caution.

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "bitkub": {
      "command": "npx",
      "args": ["-y", "@node2flow/bitkub-mcp"],
      "env": {
        "BITKUB_API_KEY": "your-api-key",
        "BITKUB_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Cursor / VS Code

Add to MCP settings:

{
  "mcpServers": {
    "bitkub": {
      "command": "npx",
      "args": ["-y", "@node2flow/bitkub-mcp"],
      "env": {
        "BITKUB_API_KEY": "your-api-key",
        "BITKUB_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Market Data Only (No API Key)

Market data tools (10 tools) work without API keys:

{
  "mcpServers": {
    "bitkub": {
      "command": "npx",
      "args": ["-y", "@node2flow/bitkub-mcp"]
    }
  }
}

HTTP Mode (Streamable HTTP)

BITKUB_API_KEY=xxx BITKUB_SECRET_KEY=xxx npx @node2flow/bitkub-mcp --http

Server starts on port 3000 (configurable via PORT env var). MCP endpoint: http://localhost:3000/mcp

Configuration

| Environment Variable | Required | Description | |---|---|---| | BITKUB_API_KEY | For trading | API key from Bitkub | | BITKUB_SECRET_KEY | For trading | Secret key for HMAC signing | | PORT | No | Port for HTTP server (default: 3000, only with --http) |

All Tools (28 tools)

General / Market Data (10 tools) — No API key needed

| Tool | Description | |---|---| | btk_server_time | Get server time (for timestamp sync) | | btk_server_status | Get API server status | | btk_symbols | List all trading symbols with rules | | btk_ticker | Get 24-hour ticker (price, volume, change) | | btk_recent_trades | Get recent trades for a symbol | | btk_bids | Get buy-side order book | | btk_asks | Get sell-side order book | | btk_books | Get complete order book (bids + asks) | | btk_depth | Get market depth | | btk_tradingview_history | Get OHLCV candlestick data |

Account (4 tools)

| Tool | Description | |---|---| | btk_wallet | Get available balances | | btk_balances | Get full balances (available + reserved) | | btk_trading_credits | Get trading credit balance | | btk_user_limits | Get deposit/withdrawal limits |

Orders (8 tools)

| Tool | Description | |---|---| | btk_place_bid | Place a buy order (LIMIT or MARKET) | | btk_place_ask | Place a sell order (LIMIT or MARKET) | | btk_place_bid_test | Test buy order (dry run, no real money) | | btk_place_ask_test | Test sell order (dry run, no real money) | | btk_cancel_order | Cancel a specific order | | btk_my_open_orders | Get all open/pending orders | | btk_my_order_history | Get order history (paginated) | | btk_order_info | Get detailed order info with fill history |

Crypto / Wallet (6 tools)

| Tool | Description | |---|---| | btk_crypto_addresses | List crypto deposit addresses | | btk_crypto_withdraw | Withdraw crypto (IRREVERSIBLE) | | btk_crypto_internal_withdraw | Transfer to Bitkub user (IRREVERSIBLE) | | btk_crypto_deposit_history | Get deposit history | | btk_crypto_withdraw_history | Get withdrawal history | | btk_crypto_generate_address | Generate new deposit address |

Test Endpoints

Bitkub provides test (dry run) endpoints for order placement. Always test before placing real orders:

btk_place_bid_test  — Validate buy order without spending money
btk_place_ask_test  — Validate sell order without spending money

These endpoints check parameters, balance, and trading rules, then return what the order would look like — without executing it.

Requirements

• Node.js 18+
• Bitkub account with API keys (for trading operations)

How to Get API Keys

1. Go to bitkub.com and log in
2. Navigate to API Management in account settings
3. Create a new API key
4. Set permissions: Read, Trade, Withdraw, Deposit
5. Copy both the API Key and Secret Key
6. Set up IP whitelist for security

Security Best Practices

• Never share API keys or secret keys
• Use IP whitelist in API key settings
• Restrict permissions to only what you need
• Read-only keys for market data monitoring
• Store secrets in environment variables, never in code
• Rotate keys regularly

Risk Warning

• All operations execute on the real exchange with real money
• Withdrawals are irreversible — double-check addresses and amounts
• Rate limits — exceeding limits blocks for 30 seconds (HTTP 429)
• Market risk — cryptocurrency prices are highly volatile
• Order history older than 90 days is archived
• Always use test endpoints before placing real orders

For Developers

git clone https://github.com/node2flow-th/bitkub-mcp-community.git
cd bitkub-mcp-community
npm install
npm run build

# Run in stdio mode (market data only)
npm start

# Run with full access
BITKUB_API_KEY=xxx BITKUB_SECRET_KEY=xxx npm start

# Run in HTTP mode
BITKUB_API_KEY=xxx BITKUB_SECRET_KEY=xxx npm start -- --http

License

MIT License - see LICENSE

Copyright (c) 2026 Node2Flow

Links

• npm Package
• Bitkub API Docs
• MCP Protocol
• Node2Flow