Upbit MCP Server

Upbit MCP Server (TypeScript)

Fast MCP server for interacting with Upbit. Provides public market data tools and optional private trading tools.

Requirements

• Node.js 18+
• pnpm 8+

Install

Environment

Copy and edit .env:

.env.example:

Private tools require UPBIT_ACCESS_KEY, UPBIT_SECRET_KEY, and UPBIT_ENABLE_TRADING=true.

Security & permissions

• Keep your UPBIT_SECRET_KEY private and IP-allowlist your server in Upbit.
• Set UPBIT_ENABLE_TRADING=true only when you intend to place/cancel orders or create withdrawals/deposit addresses.
• Upbit permission mapping (high-level):
  • Orders: create/cancel → 주문하기, query/list → 주문조회
  • Accounts/balances → 자산조회
  • Withdrawals: create/cancel → 출금하기, query/list/address list → 출금조회
  • Deposits: create deposit address → 입금하기, query/list/chance/address read → 입금조회
  • Auth follows Upbit JWT with query_hash (sorted URL-encoded params). POSTs send JSON bodies and are signed based on that body.
  • See docs: 인증, 주문 생성, 출금/입금 레퍼런스
    • Auth: docs.upbit.com/kr/reference/auth
    • Orders: docs.upbit.com/kr/reference/new-order
    • Withdrawals: list-withdrawal-addresses, withdraw
    • Deposits: available-deposit-information, create-deposit-address

Where to get Upbit API keys

Before you begin, you need to get your Upbit API keys:

1. Create an account on Upbit if you don't already have one
2. Go to the Upbit Developer Center
3. Create a new API key
4. Make sure to set appropriate permissions (read, trade, withdraw as needed)
5. Store your API keys(UPBIT_ACCESS_KEY, UPBIT_SECRET_KEY) in the .env file (see Installation section) set UPBIT_ENABLE_TRADING=true to enable private tools.

Build & Run

For easier testing use this (in project root):

If installed globally or via npx, you can also run the bin:

Runs over stdio for MCP clients.

Tools

Public:

• GET_TICKER — latest ticker for a market. Params: { "market": "KRW-BTC" }
• GET_ORDERBOOK — orderbook snapshot. Params: { "market": "KRW-BTC" }
• GET_TRADES — recent trades. Params: { "market": "KRW-BTC" }

Private (requires env and enable flag):

• GET_ACCOUNTS
• GET_ORDERS — { market?, state?, page?, limit? }
• GET_ORDER — { uuid? , identifier? }
• CREATE_ORDER — { market, side, ord_type, volume?, price? }
• CANCEL_ORDER — { uuid }
• LIST_WITHDRAWAL_ADDRESSES
• CREATE_WITHDRAWAL — { currency, amount, address, net_type, secondary_address? , transaction_type? }
• GET_WITHDRAWAL — { uuid }
• LIST_WITHDRAWALS — { currency?, state?, page?, limit? }
• CANCEL_WITHDRAWAL — { uuid }
• GET_DEPOSIT_CHANCE — { currency, net_type? }
• CREATE_DEPOSIT_ADDRESS — { currency, net_type }
• GET_DEPOSIT_ADDRESS — { currency, net_type }
• LIST_DEPOSIT_ADDRESSES
• GET_DEPOSIT — { uuid }
• LIST_DEPOSITS — { currency?, state?, page?, limit? }

All tool outputs are JSON strings for easy display.

Examples

License

MIT