Integrate with Upbit Crypto Exchange
An MCP server for Upbit that lets Claude check market data, balances, and place real crypto orders.
Why it matters
Connect to the Upbit cryptocurrency exchange to programmatically access market data, manage accounts, and execute trades.
Outcomes
What it gets done
Retrieve real-time cryptocurrency prices and order book data.
Manage account balances and view transaction history.
Create, monitor, and cancel buy/sell orders.
Access historical market data for analysis.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-upbit-mcp-server | bash Capabilities
Tools your agent gets
Get current cryptocurrency prices
Get order book information
Get recent trade history
Check major cryptocurrency market summary information
Check list of assets and account balances
Get order history
Get detailed information for a specific order
Get deposit and withdrawal history
Overview
Upbit MCP Server
An MCP server for Upbit that lets Claude check market data and account status, and place or cancel real trades. Use it when Claude needs live Upbit market data or account access, or to place and cancel real orders.
What it does
An MCP server for Upbit's cryptocurrency exchange OpenAPI, giving Claude tools to retrieve market data (ticker, orderbook, trades, candle data), account information (balances, order history), place and cancel buy/sell orders, and check deposit/withdrawal history.
When to use - and when NOT to
Use this when Claude needs to check live Upbit prices and orderbooks, review account balances and order history, or place and cancel real limit/market orders on Upbit - for example checking a market summary or executing a trade. This server can process real trades on a live exchange account, so it should be used carefully with correctly scoped API key permissions (read, trade, withdraw as needed), and API keys must never be committed to a public repository.
Capabilities
- Market data:
get_ticker(current price),get_orderbook(order book),get_trades(recent trade history),get_market_summary(summary of major cryptocurrency markets). - Account information:
get_accounts(asset holdings and balances),get_orders(order history),get_order(details of a specific order),get_deposits_withdrawals(deposit/withdrawal history). - Trading:
create_order(place a limit or market buy or sell order),cancel_order(cancel an existing order).
How to install
Requires an Upbit account and API key (from the Upbit Developer Center, with read/trade/withdraw permissions as needed). Clone the repo, install with uv sync (or install uv first via curl -Ls https://astral.sh/uv/install.sh | sh), and set UPBIT_ACCESS_KEY and UPBIT_SECRET_KEY in a .env file. For Claude Desktop, add to claude_desktop_config.json:
{
"mcpServers": {
"upbit-mcp-server": {
"command": "/full/path/to/upbit-mcp-server/.venv/bin/python",
"args": [
"/full/path/to/upbit-mcp-server/main.py"
]
}
}
}
Alternatively, install via fastmcp install main.py --name "Upbit API", run directly with uv run python main.py, or start a development web interface with fastmcp dev main.py. On macOS, the Claude Desktop config lives at ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows it's at %APPDATA%\Claude\claude_desktop_config.json, and Claude Desktop must be restarted after editing it. Using uv for dependency installation is recommended over plain pip because it resolves the project's dependencies faster and more reliably, and it can be installed with a single shell script if it isn't already on the system.
Who it's for
Crypto traders who want Claude to check Upbit market data and account status, or place and cancel real orders, directly from a conversation - while being mindful that this connects to a live trading account and real funds. Before it can be used, an Upbit account is required, along with an API key created through the Upbit Developer Center and scoped with the appropriate read, trade, or withdraw permissions for the intended use case. The project is MIT licensed.
Source README
Upbit MCP Server
A server implementation for Upbit Cryptocurrency Exchange OpenAPI using the Model Context Protocol (MCP). This project provides tools to interact with Upbit exchange services, such as retrieving market data (quotes, orderbooks, trade history, chart data), account information, creating and canceling orders, managing deposits/withdrawals, and performing technical analysis.
Features
- Market data retrieval (ticker, orderbook, trades, candle data)
- Account information (balance, order history)
- Order creation and cancellation
- Deposit and withdrawal functions
- Technical analysis tools
수행가능한 기능 목록
시장 데이터 조회
- 현재 암호화폐 시세 조회 (
get_ticker) - 호가창 정보 조회 (
get_orderbook) - 최근 체결 내역 조회 (
get_trades) - 주요 암호화폐 시장 요약 정보 확인 (
get_market_summary)
계정 정보 조회
- 보유 중인 자산 목록 및 잔고 확인 (
get_accounts) - 주문 내역 조회 (
get_orders) - 특정 주문 상세 정보 조회 (
get_order) - 입출금 내역 조회 (
get_deposits_withdrawals)
거래 기능
- 지정가/시장가 매수 주문 생성 (
create_order) - 지정가/시장가 매도 주문 생성 (
create_order) - 주문 취소 (
cancel_order)
채팅 예시
아래는 실제 채팅 예시 이미지입니다.
Prerequisites
Before you begin, you need to get your Upbit API keys:
- Create an account on Upbit if you don't already have one
- Go to the Upbit Developer Center
- Create a new API key
- Make sure to set appropriate permissions (read, trade, withdraw as needed)
- Store your API keys(
UPBIT_ACCESS_KEY,UPBIT_SECRET_KEY) in the.envfile (see Installation section)
Installation
Clone the repository:
git clone https://github.com/solangii/upbit-mcp-server.git cd upbit-mcp-serverInstall dependencies:
cd upbit-mcp-server uv syncIf you don't have
uvinstalled yet, you can install it as follows:Using
uvprovides faster installation and more reliable dependency resolution.# Install uv curl -Ls https://astral.sh/uv/install.sh | sh # Add uv to your PATH echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc # or bashrc, depending on your shellSet up environment variables:
Create a.envfile in the project root and add your Upbit API keys:UPBIT_ACCESS_KEY=your_access_key_here UPBIT_SECRET_KEY=your_secret_key_here
Usage
Install in Claude Desktop
Option 1: Using Claude config file (Direct integration)
You can add the MCP server directly to Claude's configuration file:
Install Claude Desktop
Add the following to your Claude Desktop configuration:
- macOS: ``~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the following configuration (adjust paths as needed):
{ "mcpServers": { "upbit-mcp-server": { "command": "/full/path/to/upbit-mcp-server/.venv/bin/python", "args": [ "/full/path/to/upbit-mcp-server/main.py" ] } } }Restart Claude to load the new configuration.
Option 2: Using fastmcp
fastmcp install main.py --name "Upbit API"
Run Directly with Python
uv run python main.py
Development Mode (Web Interface)
fastmcp dev main.py
Caution
- This server can process real trades, so use it carefully.
- Keep your API keys secure and never commit them to public repositories.
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.