Gokub

dvgamerr-app2stars

🚀 Model Context Protocol (MCP) server for Bitkub Cryptocurrency Exchange API - Connect Claude Desktop with Bitkub trading platform using Go

Finance

Install Run on PlugMCP

GitHub Website

Run on PlugMCP

1# Gokub

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-28

Stars: 2
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Gokub?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Gokub need an API key?

No required environment variable is listed on this record.

What transport does Gokub use?

Gokub runs locally over stdio.

When was Gokub last checked?

Last checked 2026-10-28. 🚀 Model Context Protocol (MCP) server for Bitkub Cryptocurrency Exchange API - Connect Claude Desktop with Bitkub trading platform using Go

From the publisher

Documentation

🚀 Bitkub MCP Server

Model Context Protocol server for Bitkub Cryptocurrency Exchange API

เชื่อมต่อ Claude Desktop กับ Bitkub Exchange ผ่าน MCP Protocol

Features • Installation • API Tools • Configuration • Community

✨ Features

🎯 Core Features

✅ MCP 2026-07-28 - Built with the official Go SDK
🌐 Streamable HTTP - Stateless /mcp endpoint
🔐 Secure - HMAC SHA256 signature
💰 Wallet - View balances & transactions

🚀 Developer Experience

💎 Go-Bitkub SDK - Full API v3 support
🧠 Integration - with Claude Desktop
📊 Market Data - Real-time ticker & depth
📖 Order - Track open orders

🔧 Installation

Fastest path: install the server → register it as an MCP server in Claude Code / Codex → install the bitkub-trade playbook plugin. Steps 3–5 are the important part.

1️⃣ Install the MCP server

Requires Go 1.25.5 or newer.

go install github.com/dvgamerr-app/gokub-mcp@latest

This installs gokub-mcp to $(go env GOPATH)/bin by default.

Windows default path:

# PowerShell
Write-Output "$env:USERPROFILE\go\bin\gokub-mcp.exe"

:: cmd.exe
echo %USERPROFILE%\go\bin\gokub-mcp.exe

# NuShell
$env.USERPROFILE | path join go bin gokub-mcp.exe

# macOS/Linux default
$(go env GOPATH)/bin/gokub-mcp

For local development from a clone:

git clone https://github.com/dvgamerr-app/gokub-mcp.git
cd gokub-mcp
go install .

Prefer containers? Use 🐳 Docker (Streamable HTTP mode).

2️⃣ Credentials

The server reads BTK_APIKEY / BTK_SECRET from its environment — pass them when you register the server (steps 3–4), so no .env file is required. For a plain local go run ., a .env in the repo root still works:

BTK_APIKEY=your_api_key
BTK_SECRET=your_secret_key

3️⃣ Register the MCP server in Claude Code

The current way is the claude mcp add CLI (replaces hand-editing JSON). Pass the env inline with -e:

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

Windows:

# PowerShell
claude mcp add bitkub `
  -e BTK_APIKEY=your_api_key `
  -e BTK_SECRET=your_secret_key `
  -- "$env:USERPROFILE\go\bin\gokub-mcp.exe"

:: cmd.exe
claude mcp add bitkub -e BTK_APIKEY=your_api_key -e BTK_SECRET=your_secret_key -- "%USERPROFILE%\go\bin\gokub-mcp.exe"

# NuShell
let gokub = ($env.USERPROFILE | path join go bin gokub-mcp.exe)
claude mcp add bitkub -e BTK_APIKEY=your_api_key -e BTK_SECRET=your_secret_key -- $gokub

Add -s user to make it global across all projects (default scope is project-local .mcp.json).
It runs over stdio by default — no extra flags. Verify with /mcp in a session.

4️⃣ Register the MCP server in Codex

codex mcp add gokub \
  --env BTK_APIKEY=your_api_key \
  --env BTK_SECRET=your_secret_key \
  -- "$(go env GOPATH)/bin/gokub-mcp"

Windows:

# PowerShell
codex mcp add gokub `
  --env BTK_APIKEY=your_api_key `
  --env BTK_SECRET=your_secret_key `
  -- "$env:USERPROFILE\go\bin\gokub-mcp.exe"

:: cmd.exe
codex mcp add gokub ^
  --env BTK_APIKEY=your_api_key ^
  --env BTK_SECRET=your_secret_key ^
  -- "%USERPROFILE%\go\bin\gokub-mcp.exe"

# NuShell
let gokub = ($env.USERPROFILE | path join go bin gokub-mcp.exe)
codex mcp add gokub --env BTK_APIKEY=your_api_key --env BTK_SECRET=your_secret_key -- $gokub

…or edit ~/.codex/config.toml directly:

[mcp_servers.gokub]
command = "/absolute/path/to/gokub-mcp"
args = []

[mcp_servers.gokub.env]
BTK_APIKEY = "your_api_key"
BTK_SECRET = "your_secret_key"

Verify with /mcp inside Codex.

5️⃣ Install the trading playbook plugin (skill)

The tools are the hands; the bitkub-trade plugin is the brain — the strategy playbook + guardrails. The repo doubles as a plugin marketplace for both clients:

# Claude Code
/plugin marketplace add dvgamerr-app/gokub-mcp
/plugin install bitkub-trade@gokub-mcp

# Codex
codex plugin marketplace add dvgamerr-app/gokub-mcp
codex plugin add bitkub-trade@gokub-mcp

See plugins/bitkub-trade for details.

🐳 Docker

Runs the server in stateless Streamable HTTP mode (good for a shared/remote server; for a local client that spawns the binary over stdio, use the native build above):

docker build -t gokub-mcp .
docker run --rm -p 8080:8080 \
  -e BTK_APIKEY=your_api_key \
  -e BTK_SECRET=your_secret_key \
  gokub-mcp

Then point a Streamable HTTP client at http://localhost:8080/mcp. Override the port with -e PORT=9000 -p 9000:9000.

The build fetches Go deps from the module proxy (needs internet). For an offline / hermetic build, run go mod vendor first and build with -mod=vendor.

🎮 Usage

Standard input/output mode

This is the default transport for locally registered Claude Code and Codex clients:

go run .

Streamable HTTP Server Mode

# Default port 3000
go run . -serv

# Custom port
PORT=9000 go run . -serv

Default port is 3000 (override with PORT). Docker image defaults to 8080.

Endpoint	Purpose	Method
`http://localhost:3000/mcp`	Stateless MCP requests	POST

🛠️ Available Tools

39 tools covering the full long-only swing-trading workflow (screen → analyze → size → place → manage → log).

get_wallet_balance · get_ticker · get_market_depth · get_my_open_orders · get_symbols · get_symbol_rules · get_fee_schedule

calculate_spread · calculate_liquidity_depth · get_market_screener · get_historical_candles · extract_close_prices

calculate_ema · calculate_roc · calculate_atr · calculate_rsi · check_market_regime · calculate_capm

detect_breakout_signal · detect_pullback_signal · calculate_relative_strength_rank

calculate_position_size · validate_trade_setup · round_to_exchange_rules

place_limit_order · place_stop_limit_order · cancel_order · get_order_status

check_trade_pnl · calculate_trailing_stop · check_exit_signals · client_side_stop_worker (Bitkub has no native stop/OCO — client-side trigger)

log_trade_entry · log_trade_exit · calculate_expectancy · get_trade_history (flat-file journal trades.json, override with TRADES_FILE)

get_market_overview · simulate_trade · pnl_with_fees

🧠 Trading Playbook (Plugin / Skill)

The tools are the hands; the bitkub-trade plugin is the brain — a playbook skill that encodes the strategy (screen → regime → relative-strength → ATR → signal → size → validate gate → round → place → manage → log) and the hard guardrails (≤2% risk/trade, long-only, no entry unless can_trade=true, client-side stop, TP ≥2R).

→ Install it in step 5 of Installation. Details: plugins/bitkub-trade.

⚙️ Configuration

🔐 Environment variables

Variable	Required	Purpose
`BTK_APIKEY`	for trading/wallet	Bitkub API key
`BTK_SECRET`	for trading/wallet	Bitkub API secret
`PORT`	no (default `3000`)	Streamable HTTP port (`-serv` mode)
`TRADES_FILE`	no (default `trades.json`)	trade-journal file path
`LOG_FORMAT`	no (default JSON)	Set to `text` for console-friendly logs
`LOG_LEVEL`	no (default `info`)	`trace`, `debug`, `info`, `warn`, `error`, `fatal`, or `panic`

Pass keys when you register the MCP server (see Installation steps 3–4) — that's preferred over a committed .env. Public market-data tools work without keys; wallet/order tools need them.

⚠️ Keep secrets in env vars / your client config, never commit .env (it's gitignored).

If your MCP client accepts a remote server URL, point it at the Streamable HTTP endpoint:

{
  "mcpServers": {
    "gokub": { "type": "http", "url": "http://localhost:3000/mcp" }
  }
}

For Claude Code / Codex, prefer claude mcp add / codex mcp add (stdio) above.

🧪 Development and verification

go mod verify
go test ./...
go vet ./...
go build ./...

The default test suite is deterministic and excludes tools/get_historical_candles_live_test.go. The opt-in live build tag calls public Bitkub market-data endpoints and should only be used intentionally. Do not run authenticated wallet or order flows as automated tests against real credentials.

📁 Project Structure

gokub-mcp/
├── 📄 main.go                      # MCP Server entry point (Streamable HTTP) + tool registration
├── 🐳 Dockerfile                   # Streamable HTTP server image
├── 📂 tools/                       # 39 MCP tools (+ unit tests)
├── 📂 prompts/                     # trading_strategy, market_analysis prompts
├── 📂 resources/                   # bitkub://symbols, bitkub://ticker/{symbol}
├── 📂 utils/                       # Utility functions
├── 📂 docs/                        # Project images and supporting documentation
├── 📂 plugins/bitkub-trade/        # bitkub-trade plugin (playbook skill)
│   ├── .claude-plugin/plugin.json  # Claude manifest
│   ├── .codex-plugin/plugin.json   # Codex manifest
│   └── skills/playbook/SKILL.md    # shared trading playbook
├── 📂 .claude-plugin/              # Claude plugin marketplace
└── 📂 .agents/plugins/             # Codex plugin marketplace

📊 API Rate Limits

Category	Rate Limit	Note
📈 Market Data	100 req/sec	Public endpoints
💱 Trading Operations	150-200 req/sec	Authenticated endpoints

📚 Bitkub API Docs สำหรับข้อมูลเพิ่มเติม

🚀 Roadmap

✅ Completed

Bitkub API golang library + MCP Server (Streamable HTTP + stdio)
39 trading tools — foundation, indicators, entry signals, risk, orders, management, logging
Risk-based position sizing + pre-trade validate_trade_setup gate
Client-side stop worker (Bitkub has no native stop/OCO)
Trade journal + expectancy (flat-file trades.json)
bitkub-trade playbook plugin — installable in Claude Code & Codex

🚧 In Progress / Next

git push the plugin so the marketplaces resolve from GitHub
Optional MCP prompts/resources for non-Claude/Codex clients
Backtesting over OHLCV history

🎯 Planned Features

Rebalancing / Grid strategy presets
Docker image + WebSocket real-time data

📚 References

🔧 Official MCP Go SDK

💎 Go-Bitkub SDK

📖 Bitkub Official API Docs

🤖 MCP 2026-07-28 Specification

👥 Community

Join our community to discuss, get help, and share your trading strategies!

Made with ❤️ by dvgamerr-app

⭐ Star this repo if you find it helpful!

Report Bug • Request Feature • Contribute

Gokub

dvgamerr-app2stars

🚀 Model Context Protocol (MCP) server for Bitkub Cryptocurrency Exchange API - Connect Claude Desktop with Bitkub trading platform using Go

Finance

Install Run on PlugMCP

GitHub Website

Run on PlugMCP

1# Gokub

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-28

Stars: 2
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Gokub?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Gokub need an API key?

No required environment variable is listed on this record.

What transport does Gokub use?

Gokub runs locally over stdio.

When was Gokub last checked?

Last checked 2026-10-28. 🚀 Model Context Protocol (MCP) server for Bitkub Cryptocurrency Exchange API - Connect Claude Desktop with Bitkub trading platform using Go

From the publisher

Documentation

🚀 Bitkub MCP Server

Model Context Protocol server for Bitkub Cryptocurrency Exchange API

เชื่อมต่อ Claude Desktop กับ Bitkub Exchange ผ่าน MCP Protocol

Features • Installation • API Tools • Configuration • Community

✨ Features

🎯 Core Features

✅ MCP 2026-07-28 - Built with the official Go SDK
🌐 Streamable HTTP - Stateless /mcp endpoint
🔐 Secure - HMAC SHA256 signature
💰 Wallet - View balances & transactions

🚀 Developer Experience

💎 Go-Bitkub SDK - Full API v3 support
🧠 Integration - with Claude Desktop
📊 Market Data - Real-time ticker & depth
📖 Order - Track open orders

🔧 Installation

Fastest path: install the server → register it as an MCP server in Claude Code / Codex → install the bitkub-trade playbook plugin. Steps 3–5 are the important part.

1️⃣ Install the MCP server

Requires Go 1.25.5 or newer.

go install github.com/dvgamerr-app/gokub-mcp@latest

This installs gokub-mcp to $(go env GOPATH)/bin by default.

Windows default path:

# PowerShell
Write-Output "$env:USERPROFILE\go\bin\gokub-mcp.exe"

:: cmd.exe
echo %USERPROFILE%\go\bin\gokub-mcp.exe

# NuShell
$env.USERPROFILE | path join go bin gokub-mcp.exe

# macOS/Linux default
$(go env GOPATH)/bin/gokub-mcp

For local development from a clone:

git clone https://github.com/dvgamerr-app/gokub-mcp.git
cd gokub-mcp
go install .

Prefer containers? Use 🐳 Docker (Streamable HTTP mode).

2️⃣ Credentials

BTK_APIKEY=your_api_key
BTK_SECRET=your_secret_key

3️⃣ Register the MCP server in Claude Code

The current way is the claude mcp add CLI (replaces hand-editing JSON). Pass the env inline with -e:

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

Windows:

# PowerShell
claude mcp add bitkub `
  -e BTK_APIKEY=your_api_key `
  -e BTK_SECRET=your_secret_key `
  -- "$env:USERPROFILE\go\bin\gokub-mcp.exe"

:: cmd.exe
claude mcp add bitkub -e BTK_APIKEY=your_api_key -e BTK_SECRET=your_secret_key -- "%USERPROFILE%\go\bin\gokub-mcp.exe"

# NuShell
let gokub = ($env.USERPROFILE | path join go bin gokub-mcp.exe)
claude mcp add bitkub -e BTK_APIKEY=your_api_key -e BTK_SECRET=your_secret_key -- $gokub

Add -s user to make it global across all projects (default scope is project-local .mcp.json).
It runs over stdio by default — no extra flags. Verify with /mcp in a session.

4️⃣ Register the MCP server in Codex

codex mcp add gokub \
  --env BTK_APIKEY=your_api_key \
  --env BTK_SECRET=your_secret_key \
  -- "$(go env GOPATH)/bin/gokub-mcp"

Windows:

# PowerShell
codex mcp add gokub `
  --env BTK_APIKEY=your_api_key `
  --env BTK_SECRET=your_secret_key `
  -- "$env:USERPROFILE\go\bin\gokub-mcp.exe"

:: cmd.exe
codex mcp add gokub ^
  --env BTK_APIKEY=your_api_key ^
  --env BTK_SECRET=your_secret_key ^
  -- "%USERPROFILE%\go\bin\gokub-mcp.exe"

# NuShell
let gokub = ($env.USERPROFILE | path join go bin gokub-mcp.exe)
codex mcp add gokub --env BTK_APIKEY=your_api_key --env BTK_SECRET=your_secret_key -- $gokub

…or edit ~/.codex/config.toml directly:

[mcp_servers.gokub]
command = "/absolute/path/to/gokub-mcp"
args = []

[mcp_servers.gokub.env]
BTK_APIKEY = "your_api_key"
BTK_SECRET = "your_secret_key"

Verify with /mcp inside Codex.

5️⃣ Install the trading playbook plugin (skill)

The tools are the hands; the bitkub-trade plugin is the brain — the strategy playbook + guardrails. The repo doubles as a plugin marketplace for both clients:

# Claude Code
/plugin marketplace add dvgamerr-app/gokub-mcp
/plugin install bitkub-trade@gokub-mcp

# Codex
codex plugin marketplace add dvgamerr-app/gokub-mcp
codex plugin add bitkub-trade@gokub-mcp

See plugins/bitkub-trade for details.

🐳 Docker

Runs the server in stateless Streamable HTTP mode (good for a shared/remote server; for a local client that spawns the binary over stdio, use the native build above):

docker build -t gokub-mcp .
docker run --rm -p 8080:8080 \
  -e BTK_APIKEY=your_api_key \
  -e BTK_SECRET=your_secret_key \
  gokub-mcp

Then point a Streamable HTTP client at http://localhost:8080/mcp. Override the port with -e PORT=9000 -p 9000:9000.

The build fetches Go deps from the module proxy (needs internet). For an offline / hermetic build, run go mod vendor first and build with -mod=vendor.

🎮 Usage

Standard input/output mode

This is the default transport for locally registered Claude Code and Codex clients:

go run .

Streamable HTTP Server Mode

# Default port 3000
go run . -serv

# Custom port
PORT=9000 go run . -serv

Default port is 3000 (override with PORT). Docker image defaults to 8080.

Endpoint	Purpose	Method
`http://localhost:3000/mcp`	Stateless MCP requests	POST