Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MAX Exchange MCP Server what's my BTC balance and the current ETH/USDT price?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Integrate the MAX Exchange API into AI assistants like Claude via the Model Context Protocol (MCP), allowing AI to directly query market data, manage accounts, and place trades.
Python 3.11+
MAX Exchange account and API keys (Apply here)
Related MCP server: hyperliquid-mcp
No manual installation required, run directly from GitHub:
uvx --from git+https://github.com/nicky512500/max-mcp maxmcpgit clone https://github.com/nicky512500/max-mcp
cd max-mcp
pip install -e .
maxmcpMAX API keys are required. Two methods are supported:
Method 1: .env file (Recommended)
Create a .env file in the project root directory:
MAX_API_KEY=your_access_key
MAX_API_SECRET=your_secret_keyMethod 2: System Environment Variables
export MAX_API_KEY=your_access_key
export MAX_API_SECRET=your_secret_keyPublic query functions (market data, K-lines, etc.) do not require API keys.
Edit the Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"max-exchange": {
"command": "uvx",
"args": ["--from", "git+https://github.com/nicky512500/max-mcp", "maxmcp"],
"env": {
"MAX_API_KEY": "your_access_key",
"MAX_API_SECRET": "your_secret_key"
}
}
}
}Restart Claude Desktop to start using it.
claude mcp add max-exchange -- uvx --from git+https://github.com/nicky512500/max-mcp maxmcpTool | Description |
| Get a list of all available trading markets |
| Get a list of all available currencies |
| Get the current MAX server time |
| Get real-time market data for a single market (latest price, bid/ask, 24h volume) |
| Get real-time market data for multiple markets (can query multiple at once) |
| Get market depth (order book), up to 300 entries |
| Get recent public trade history for a market |
| Get K-line (candlestick) data, supports multiple timeframes |
K-line timeframes (minutes): 1 / 5 / 15 / 30 / 60 / 120 / 240 / 360 / 720 / 1440
Tool | Description |
| Get index prices for M-wallet currencies |
| Get borrowing limits for M-wallet |
| Get borrowing interest rates for M-wallet currencies |
Tool | Description |
| Get account information (KYC status, account ID, etc.) |
| Get balances for all currencies (Spot or M-wallet) |
| Get the deposit address for a specific currency |
| Get a list of bound withdrawal addresses |
Tool | Description |
| Submit a buy/sell order |
| Get a list of currently open orders |
| Get closed orders (filled, cancelled, etc.) |
| Get order history paginated by ID sequence |
| Query details of a single order |
| Cancel a single open order |
| Batch cancel orders in a specific market |
Order types (ord_type): limit / market / stop_limit / stop_market / post_only / ioc_limit
Tool | Description |
| Get personal historical trade records |
| Get all trade details for a specific order |
Tool | Description |
| Execute instant currency swap |
| Query details of a single instant swap |
| Get instant swap history |
Tool | Description |
| Submit a cryptocurrency withdrawal request |
| Submit a TWD withdrawal request |
| Query details of a single withdrawal |
| Get withdrawal history |
| Query details of a single deposit |
| Get deposit history |
| Get internal transfer records (transfers between MAX users) |
| Get reward records (rebates, airdrops, interest rewards, etc.) |
Tool | Description |
| Get M-wallet AD ratio (Assets / Debt); liquidation is triggered if below threshold |
| Apply for a loan from M-wallet |
| Get M-wallet loan history |
| Transfer funds between Spot wallet and M-wallet |
| Get M-wallet fund transfer history |
| Repay loans to M-wallet |
| Get M-wallet repayment history |
| Get M-wallet liquidation history |
| Get details of a single M-wallet liquidation |
| Get M-wallet interest charge history |
Ask directly in natural language within Claude:
查詢 BTC/USDT 目前的價格幫我看一下我的現貨帳戶餘額查詢 btcusdt 最近 10 根 1 小時 K 線幫我在 btcusdt 以限價 90000 掛買單 0.001 BTC取消 btcusdt 所有未成交的買單Operations such as withdrawals and placing orders are irreversible; please confirm parameters before execution.
Keep API keys secure; do not commit them to version control.
M-wallet involves leveraged lending; please monitor your AD ratio to avoid liquidation risks.
取消單筆掛單 :param order_id: 訂單 ID（與 client_oid 擇一） :param client_oid: 自訂訂單 ID（與 order_id 擇一）
Inputs: order_id, client_oid. Returns: result
批次取消某市場的掛單 :param market: 市場 ID（必填），例如 'btcusdt' :param wallet_type: 錢包類型，'spot' 或 'm'，預設 'spot' :param side: 只取消特定方向，'buy' 或 'sell'；留空取消雙向
Inputs: market (required), wallet_type, side. Returns: result
取得帳戶各幣種餘額 :param wallet_type: 錢包類型，'spot'（現貨）或 'm'（M 錢包），預設 'spot' :param currency: 只查特定幣種，例如 'btc'；留空查全部
Inputs: wallet_type, currency. Returns: result
取得已關閉的訂單（已成交、已取消等） :param wallet_type: 錢包類型，'spot' 或 'm'，預設 'spot' :param market: 篩選市場；留空查全部 :param limit: 回傳筆數，最多 1000，預設 50 :param state: 狀態篩選，done / cancel / finalizing / failed；留空查全部
Inputs: wallet_type, market, limit, state. Returns: result
查詢單筆閃兌詳情 :param uuid: 兌換單 UUID
Inputs: uuid (required). Returns: result
取得閃兌歷史記錄 :param limit: 每頁筆數，預設 50 :param page: 頁碼，預設 1
Inputs: limit, page. Returns: result
取得 MAX 所有可用貨幣列表
Inputs: no named parameters. Returns: result
查詢單筆存款詳情 :param uuid: 存款 UUID
Inputs: uuid (required). Returns: result
取得指定幣種的充值地址 :param currency_version: 幣種版本，例如 'eth'、'trc20usdt'、'erc20usdt'
Inputs: currency_version (required). Returns: result
取得存款歷史記錄 :param currency: 篩選幣種；留空查全部 :param limit: 每頁筆數，預設 50 :param page: 頁碼，預設 1 :param state: 狀態篩選；留空查全部
Inputs: currency, limit, page, state. Returns: result
取得市場深度（掛單簿），顯示買賣雙方的掛單價格與數量 :param market: 市場 ID，例如 'btcusdt' :param limit: 回傳筆數，最多 300，預設 20
Inputs: market (required), limit. Returns: result
取得平台內部轉帳記錄（MAX 用戶間互轉） :param currency: 篩選幣種；留空查全部 :param limit: 每頁筆數，預設 50 :param page: 頁碼，預設 1 :param side: 'in'（收款）或 'out'（付款）；留空查全部
Inputs: currency, limit, page, side. Returns: result
取得市場 K 線（蠟燭圖）資料 :param market: 市場 ID，例如 'btcusdt' :param period: K 線週期（分鐘），可選 1/5/15/30/60/120/240/360/720/1440，預設 1 :param limit: 回傳筆數，最多 10000，預設 30
Inputs: market (required), period, limit. Returns: result
取得 M 錢包目前 AD 比率（資產 / 借貸），低於門檻會觸發清算
Inputs: no named parameters. Returns: result
取得 MAX 所有可用交易市場列表
Inputs: no named parameters. Returns: result
取得 M 錢包各幣種指數價格
Inputs: no named parameters. Returns: result
取得 M 錢包各幣種目前借貸利率
Inputs: no named parameters. Returns: result
取得 M 錢包利息計費歷史記錄 :param currency: 篩選幣種；留空查全部 :param limit: 每頁筆數，預設 50 :param page: 頁碼，預設 1
Inputs: currency, limit, page. Returns: result
取得 M 錢包目前可用借貸額度上限
Inputs: no named parameters. Returns: result
取得單筆 M 錢包清算詳情 :param sn: 清算序號
Inputs: sn (required). Returns: result
取得 M 錢包清算歷史記錄 :param limit: 每頁筆數，預設 50 :param page: 頁碼，預設 1
Inputs: limit, page. Returns: result
取得 M 錢包借貸歷史記錄 :param currency: 篩選幣種；留空查全部 :param limit: 每頁筆數，預設 50 :param page: 頁碼，預設 1
Inputs: currency, limit, page. Returns: result
取得 M 錢包還款歷史記錄 :param currency: 篩選幣種；留空查全部 :param limit: 每頁筆數，預設 50 :param page: 頁碼，預設 1
Inputs: currency, limit, page. Returns: result
取得 M 錢包資金轉移記錄 :param currency: 篩選幣種；留空查全部 :param limit: 每頁筆數，預設 50 :param page: 頁碼，預設 1
Inputs: currency, limit, page. Returns: result
取得目前未成交的掛單列表 :param wallet_type: 錢包類型，'spot' 或 'm'，預設 'spot' :param market: 篩選市場，例如 'btcusdt'；留空查全部 :param limit: 回傳筆數，最多 1000，預設 50
Inputs: wallet_type, market, limit. Returns: result
查詢單筆訂單詳情 :param order_id: 訂單 ID（與 client_oid 擇一） :param client_oid: 自訂訂單 ID（與 order_id 擇一）
Inputs: order_id, client_oid. Returns: result
依 ID 順序分頁取得訂單歷史（適合完整匯出） :param wallet_type: 錢包類型，'spot' 或 'm'，預設 'spot' :param market: 篩選市場；留空查全部 :param from_id: 從指定訂單 ID 開始（用於翻頁） :param limit: 回傳筆數，預設 50
Inputs: wallet_type, market, from_id, limit. Returns: result
取得特定訂單的所有成交明細 :param order_id: 訂單 ID（與 client_oid 擇一） :param client_oid: 自訂訂單 ID（與 order_id 擇一）
Inputs: order_id, client_oid. Returns: result
取得市場最近公開成交記錄（無需登入） :param market: 市場 ID，例如 'btcusdt' :param limit: 回傳筆數，預設 30
Inputs: market (required), limit. Returns: result
取得獎勵記錄（返傭、空投、利息獎勵等） :param reward_type: 獎勵類型篩選；留空查全部 :param currency: 篩選幣種；留空查全部 :param limit: 每頁筆數，預設 50 :param page: 頁碼，預設 1
Inputs: reward_type, currency, limit, page. Returns: result
取得單一市場即時行情（最新成交價、買賣一口價、24h 成交量等） :param market: 市場 ID，例如 'btcusdt'、'ethusdt'
Inputs: market (required). Returns: result
取得多個市場即時行情，可一次查詢多個 :param markets: 逗號分隔的市場 ID，例如 'btcusdt,ethusdt'；留空回傳全部
Inputs: markets. Returns: result
取得 MAX 伺服器目前時間（Unix 時間戳，秒）
Inputs: no named parameters. Returns: result
取得個人歷史成交記錄 :param wallet_type: 錢包類型，'spot' 或 'm'，預設 'spot' :param market: 篩選市場；留空查全部 :param limit: 回傳筆數，預設 50
Inputs: wallet_type, market, limit. Returns: result
取得目前登入帳戶的用戶資訊（KYC 狀態、帳號 ID 等）
Inputs: no named parameters. Returns: result
取得已綁定的提現地址列表 :param currency: 篩選特定幣種，例如 'btc'；留空查全部
Inputs: currency. Returns: result
查詢單筆提現詳情 :param uuid: 提現 UUID
Inputs: uuid (required). Returns: result
取得提現歷史記錄 :param currency: 篩選幣種；留空查全部 :param limit: 每頁筆數，預設 50 :param page: 頁碼，預設 1 :param state: 狀態篩選；留空查全部
Inputs: currency, limit, page, state. Returns: result
執行幣種閃兌（即時換匯） :param from_currency: 賣出幣種，例如 'usdt' :param to_currency: 買入幣種，例如 'btc' :param from_amount: 賣出金額（與 to_amount 二擇一），例如 '1000' :param to_amount: 買入金額（與 from_amount 二擇一），例如 '0.01'
Inputs: from_currency (required), to_currency (required), from_amount, to_amount. Returns: result
向 M 錢包申請借貸 :param currency: 借貸幣種，例如 'usdt'、'btc' :param amount: 借貸金額（字串），例如 '1000'
Inputs: currency (required), amount (required). Returns: result
向 M 錢包還款 :param currency: 還款幣種，例如 'usdt' :param amount: 還款金額（字串），例如 '1000'
Inputs: currency (required), amount (required). Returns: result
在現貨錢包與 M 錢包之間轉移資金 :param currency: 幣種，例如 'usdt' :param amount: 金額（字串），例如 '500' :param side: 方向，'in' = 轉入 M 錢包，'out' = 從 M 錢包轉出
Inputs: currency (required), amount (required), side (required). Returns: result
提交買賣訂單 :param market: 市場 ID，例如 'btcusdt' :param side: 方向，'buy' 或 'sell' :param volume: 交易數量（字串），例如 '0.001' :param price: 限價（字串），市價單可省略 :param ord_type: 訂單類型，limit / market / stop_limit / stop_market / post_only / ioc_limit，預設 limit :param wallet_type: 錢包類型，'spot' 或 'm'，預設 'spot' :param stop_price: 止損觸發價，stop 系列訂單需填 :param client_oid: 自訂訂單 ID（最長 36 字元）
Inputs: market (required), side (required), volume (required), price, +4 more. Returns: result
提交台幣（TWD）出金申請 :param amount: 出金金額（字串），例如 '10000'
Inputs: amount (required). Returns: result
提交加密貨幣提現申請 :param withdraw_address_uuid: 提現地址 UUID（先用 get_withdraw_addresses 取得） :param amount: 提現金額（字串），例如 '100'
Inputs: withdraw_address_uuid (required), amount (required). Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 45 tools
Tools are generally well-distinguished by resource type and action (e.g., singular vs. plural, spot vs. M-wallet prefixes). Minor potential confusion exists between get_order and get_open_orders/get_closed_orders, but parameter differences (ID lookup vs. state filtering) clarify intent.
Excellent snake_case consistency with clear verb_noun patterns (get_*, submit_*, cancel_*). All margin wallet tools use the m_ prefix predictably. Minor deduction for get_k being cryptic (should be get_klines or get_candles) and get_m_ad_ratio using unexplained abbreviation.
With 45 tools, the surface far exceeds the rubric's 25+ threshold for 'too many.' The count is inflated by numerous singular/plural pairs (get_order/get_orders, get_deposit/get_deposits) that could have been consolidated with optional parameters, creating unnecessary bloat for an agent to navigate.
Extremely comprehensive coverage of exchange operations including spot trading, margin (M-wallet) lifecycle, deposits/withdrawals, and market data. Minor gaps exist (e.g., no submit_internal_transfer to match get_internal_transfers, no cancel_withdrawal), but core workflows are fully supported.
Trade 16 crypto exchanges + MetaTrader 5 from your AI assistant via one MCP connection.
Live crypto + IDX stock market intelligence for AI agents — 19 tools, no API key.
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Financial intelligence for AI: manage balances, transactions, payments, and more
