An MCP server that provides Claude with access to various blockchain data and market prices through the OKX API, enabling operations for retrieving asset prices, transaction data, account history, and trading instructions.

Installation

From Source Code

git clone https://github.com/memetus/okx-mcp-playground
cd okx-mcp-playground
npm install
npm run build

Smithery Build

npm run build:smithery

Local Run

node dist/index.js

Configuration

Claude Desktop

{
  "mcpServers": {
    "okx-mcp-playground": {
      "command": "node",
      "args": ["your project path/dist/index.js"],
      "env": {
        "OKX_API_KEY": "your-okx-api-key",
        "OKX_API_SECRET": "your-okx-api-secret",
        "OKX_PASSPHRASE": "your-okx-api-passphrase",
        "OKX_PROJECT_ID": "your-okx-project-id"
      }
    }
  }
}

Available Tools

Tool	Description
get_supported_chain	Get information about networks supported by various endpoints (Balance, Gateway, Index, Market, T...
get_specific_token_balance	Get a list of token balances for an address across multiple or specified networks
get_total_token_balances	Get a list of token balances for an address across multiple or specified networks
get_total_value	Get the total balance of all tokens and DeFi assets in an account
broadcast_transactions	Broadcast transactions to the specified blockchain
get_gas_limit	Get Gas Limit consumption estimate through pre-execution of transaction information
get_gas_price	Dynamically retrieve estimated gas prices for various networks
get_transaction_orders	Get a list of orders sent from the transaction broadcast API
simulate_transactions	Simulate a blockchain transaction before execution to view expected results and potential risks
get_historical_index_price	Request historical prices for a specific token
get_token_index_price	Get the currency price calculated from multiple third-party data sources
get_trades	Get recent token transactions
get_batch_token_price	Get the latest price for multiple tokens
get_candlesticks_history	Get historical candlestick charts
get_candlesticks	Get candlestick charts

Features

• Balance operations for token balances across multiple networks
• Gateway operations for transaction broadcasting and simulation
• Index price operations for real-time historical token prices
• Market price operations for trading data and candlestick charts
• Trading operations for DEX swaps and liquidity management
• Transaction operations for address history and transaction details
• Gas price estimation and limit calculations
• Cross-chain transaction support
• Access to real-time and historical market data

Environment Variables

Required

• OKX_API_KEY - OKX API key for authentication
• OKX_API_SECRET - OKX API secret for authentication
• OKX_PASSPHRASE - OKX API passphrase for authentication
• OKX_PROJECT_ID - OKX project ID for API access

Notes

Requires Node.js version 16 or higher and an OKX API key from the OKX Web3 developer portal. The server provides comprehensive access to blockchain data, including balance verification, transaction operations, market data, and DEX trading functionality.