home / mcp / upbit mcp server

Upbit MCP Server

Provides real-time Upbit data and private trading tools for MCP-enabled LLMs.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "iqaicom-mcp-upbit": {
      "command": "npx",
      "args": [
        "-y",
        "@iqai/mcp-upbit"
      ],
      "env": {
        "UPBIT_ACCESS_KEY": "<UPBIT_ACCESS_KEY>",
        "UPBIT_SECRET_KEY": "<UPBIT_SECRET_KEY>",
        "UPBIT_SERVER_URL": "https://api.upbit.com",
        "UPBIT_ENABLE_TRADING": "false"
      }
    }
  }
}

You can access Upbit market data and perform private trading operations through a fast MCP server that integrates with Upbit. This server exposes public data such as tickers, order books, and trades, and, when you provide appropriate API keys, it enables account access, order management, deposits, and withdrawals within your MCP client workflows.

How to use

You interact with the Upbit MCP Server by configuring your MCP client to launch the server as a subprocess. Use the public data mode for real-time market information, or enable trading features by supplying your Upbit API keys. The server responds to your MCP client’s requests for market data, order information, and account activities.

How to install

# Minimal setup using npx (public data only)
npx @iqai/mcp-upbit
```
```bash
# Build from source and run locally
git clone https://github.com/IQAIcom/mcp-upbit.git
cd mcp-upbit
pnpm install
pnpm run build
```
```bash
# Start using the MCP client configuration (see below for JSON config)

Additional sections

Configuration and security details are provided to ensure you can run the Upbit MCP Server safely. You can enable private trading tools by supplying API keys and toggling the trading mode. The server exposes a set of tools to manage orders, deposits, withdrawals, and account information.

Configuration notes

The server can be run in public data mode or with trading enabled. When trading is enabled, you must provide Upbit API credentials and set appropriate permissions. This configuration is done via environment variables passed to the MCP client when launching the server.

Security considerations

Keep your Upbit secret key private and IP-allowlist your MCP server. Only enable trading when you intend to place or cancel orders or manage withdrawals. Review permissions to align with your needs and minimize risk.

Available tools

CANCEL_ORDER

Cancel an existing Upbit order using its UUID via private API

CANCEL_WITHDRAWAL

Cancel a digital asset withdrawal by UUID via private API

CREATE_DEPOSIT_ADDRESS

Request creation of a deposit address for a currency via private API

CREATE_ORDER

Create an Upbit order (market, limit, or price types) via private API

CREATE_WITHDRAWAL

Request a digital asset withdrawal via private API

GET_ACCOUNTS

Retrieve Upbit account balances (private API)

GET_DEPOSIT

Get details of a specific deposit by UUID (private API)

GET_DEPOSIT_ADDRESS

Get a deposit address for a currency and net_type (private)

GET_DEPOSIT_CHANCE

Get deposit eligibility information for a currency (private)

GET_ORDER

Get a single Upbit order (private API)

GET_ORDERBOOK

Get orderbook snapshot for a market (public)

GET_ORDERS

List Upbit orders (private API)

GET_TICKER

Get latest ticker data for a market (public)

GET_TRADES

Get recent trades for a market (public)

GET_WITHDRAWAL

Get a single withdrawal by UUID (private API)

LIST_DEPOSIT_ADDRESSES

List deposit addresses for all currencies (private API)

LIST_DEPOSITS

List deposits (private API)

LIST_WITHDRAWAL_ADDRESSES

List registered withdrawal addresses (private API)

LIST_WITHDRAWALS

List withdrawals (private API)