upbit

The Upbit MCP Server provides a Python-based MCP interface to interact with Upbit's OpenAPI. It exposes tools for market data retrieval (ticker, orderbook, trades, and candle data), account information (balances and orders), trade actions (create and cancel orders), and deposits/withdrawals tracking, as well as basic technical analysis utilities. The server is designed to run inside a Python environment and reads Upbit API credentials from environment variables to authenticate requests. To use it, ensure the server is running in a Python environment with your Upbit keys loaded, then issue MCP commands through your preferred client to query market data, manage orders, or fetch account details through the provided endpoints.

Typical workflows include:

• Fetching current market data (get_ticker, get_orderbook, get_trades, get_market_summary) for a symbol or market pair.
• Managing your account: check balances via get_accounts, view and retrieve your orders with get_orders/get_order, and monitor deposits/withdrawals with get_deposits_withdrawals.
• Trading operations: place limit or market orders using create_order and cancel existing orders with cancel_order.
• Accessing chart data or technical indicators for analysis purposes via the included tools. The server is intended for integration into Claude, custom MCP clients, or development workflows via uv (Python) or other MCP adapters.

Prerequisites

• Python 3.8+ installed on your system
• Upbit API keys with appropriate permissions (read, trade, withdraw as needed)
• Environment to run the MCP server (virtual environment recommended)

Installation steps

1. Clone the repository (or download the project files):

git clone https://github.com/solangii/upbit-mcp-server.git
cd upbit-mcp-server

2. Set up a Python virtual environment and install dependencies (if a requirements.txt exists):

python -m venv .venv
source .venv/bin/activate  # on macOS/Linux
# Windows: .venv\Scripts\activate
pip install -r requirements.txt  # if a requirements file is provided

3. Configure environment variables for Upbit API keys:

# Create a .env file with the following content
UPBIT_ACCESS_KEY=your_access_key_here
UPBIT_SECRET_KEY=your_secret_key_here

4. Run the MCP server directly (Python):

uv run main.py

5. Optional: integrate with Claude Desktop or other MCP clients by using the recommended config format (see README examples for your environment).

Tips and common issues:

• Never commit your Upbit API keys to public repos. Use a dedicated .env file or environment management tool.
• The server can execute real trades; test thoroughly in a sandbox or with muted permissions before using with live funds.
• If you encounter import or dependency issues, ensure your virtual environment is activated and that the correct Python interpreter is used in your startup command.
• If running via Claude Desktop, ensure the paths in the config reflect your actual project layout (e.g., the path to main.py and the Python interpreter in your virtual environment).
• For troubleshooting, check that UPBIT_ACCESS_KEY and UPBIT_SECRET_KEY are valid and have the required permissions (read, trade, withdraw as needed).