Bitkub MCPgokub-mcp · go
GitHub
Model Context Protocol · Go 1.25

Let your AI copilot trade Bitkub — with guardrails.

An MCP server that wires Claude & Codex straight into the Bitkub exchange. 39 tools for market data, indicators, risk sizing, and live orders — driven by a long-only swing-trading playbook that refuses any trade over your risk limit.

Get started Explore the 39 tools
Long-only · ≤2% risk/trade Claude Code · Codex · Desktop MIT licensed
~/gokub-mcp — claude
# 1 · install the server $ go install github.com/dvgamerr-app/gokub-mcp@latest # 2 · register it with your AI client $ claude mcp add bitkub \ -e BTK_APIKEY=•••• -e BTK_SECRET=•••• -- gokub-mcp ✓ bitkub connected · 39 tools · 2 prompts · 2 resources › "screen BTC and size a 1% swing entry"
39 tools
screen → place → log
9 groups
data · risk · orders
≤2%
risk per trade, enforced
100%
single Go binary
Why gokub-mcp

The tools are the hands. The playbook is the brain.

Everything an AI agent needs to run a disciplined long-only swing strategy on Bitkub — without ever bypassing your risk controls.

Live market data

Tickers, order-book depth, spread, liquidity, screener, and historical candles — all public endpoints work without API keys.

Real indicators

EMA, RSI, ATR, ROC, CAPM, market-regime and relative-strength checks — computed server-side, not hallucinated.

Risk-first sizing

Position size is derived from your stop and account risk. A validate gate blocks any setup that breaks the rules.

Live order management

Place limit & stop-limit orders, cancel, and poll status. Fee-aware math and exchange-rounding built in.

Client-side stops

Bitkub has no native stop/OCO — so a client-side stop worker watches price and triggers your exit for you.

Trade journal

Every entry and exit is logged to a flat-file journal, with expectancy and performance you can review any time.

The playbook flow

One disciplined path from idea to logged trade

The bitkub-trade skill walks the agent through every step — and the validate gate is non-negotiable.

01
Screen
scan the market
02
Regime
trend & strength
03
Signal
breakout / pullback
04
Size
risk-based qty
05
Validate
hard gate ✋
06
Place
round & order
07
Manage
trail & exit
08
Log
journal & review
bitkub-trade plugin

Tools plus a brain that won’t blow up your account

Install the playbook as a plugin in Claude Code or Codex. It turns 39 raw tools into a strategy with hard limits baked in.

The hands — MCP tools

  • Market & data — ticker, depth, screener, candles, spread & liquidity.
  • Indicators — EMA, RSI, ATR, ROC, CAPM, regime, relative strength.
  • Orders & wallet — place, cancel, status, balances, open orders.
  • Journal — log entries/exits, expectancy, trade history.

The brain — guardrails

  • ≤2% risk per trade — position size capped to your account risk.
  • Long-only — no shorting, no leverage, no surprises.
  • No entry unless can_trade=true from the validate gate.
  • Client-side stop · TP ≥ 2R — protected exits and a real reward target.
39 tools · 9 groups

A complete swing-trading toolkit

From screening the market down to logging your expectancy — every step has a dedicated, tested tool.

Foundation

7
get_wallet_balanceget_tickerget_market_depthget_my_open_ordersget_symbolsget_symbol_rulesget_fee_schedule

Market & Liquidity

5
calculate_spreadcalculate_liquidity_depthget_market_screenerget_historical_candlesextract_close_prices

Indicators

6
calculate_emacalculate_roccalculate_atrcalculate_rsicheck_market_regimecalculate_capm

Entry Signals

3
detect_breakout_signaldetect_pullback_signalcalculate_relative_strength_rank

Position & Risk

3
calculate_position_sizevalidate_trade_setupround_to_exchange_rules

Order Management

4
place_limit_orderplace_stop_limit_ordercancel_orderget_order_status

Trade Management

4
check_trade_pnlcalculate_trailing_stopcheck_exit_signalsclient_side_stop_worker

Logging & Performance

4
log_trade_entrylog_trade_exitcalculate_expectancyget_trade_history

Helpers

3
get_market_overviewsimulate_tradepnl_with_fees
Quick start

Connected in three steps

Public market-data tools work with zero config. Add your Bitkub keys when you need wallet & order tools.

1

Install the server

A single Go binary — lands in $(go env GOPATH)/bin.

# requires Go 1.25+
go install github.com/dvgamerr-app/gokub-mcp@latest
2

Register it with your AI client

Runs over stdio — no flags needed. Use claude mcp add or codex mcp add.

claude mcp add bitkub \
  -e BTK_APIKEY=your_api_key \
  -e BTK_SECRET=your_secret_key \
  -- "$(go env GOPATH)/bin/gokub-mcp"
3

Install the trading playbook

The repo doubles as a plugin marketplace — this adds the strategy & guardrails.

# in Claude Code
/plugin marketplace add dvgamerr-app/gokub-mcp
/plugin install bitkub-trade@gokub-mcp
Open source · MIT

Hand the charts to your agent.
Keep the risk rules to yourself.

Star the repo, join the community, and ship your first risk-sized swing trade today.

Star on GitHub Join Discord