io.github.aahl/mcp-okx

MCP Server for okx.com

2 0 tools GitHub

No known CVEs

No license

Stale

Last commit 190d ago

Works with most clients

Transport: stdio, http

0 tools

Grade F

Edit this pageView history

Finance

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "io-github-aahl-mcp-okx": {
      "command": "<see-readme>",
      "args": []
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-aahl-mcp-okx)](https://mcppedia.org/s/io-github-aahl-mcp-okx)

Read me

What io.github.aahl/mcp-okx does

"OKX_API_KEY": "your-okx-api-key", "OKX_API_SECRET": "api-secret-key", "OKX_PASSPHRASE": "api-passphrase", "OKX_TRADE_FLAG": "1", # 0: Production trading, 1: Demo trading "OKX_BASE_URL": "https://www.okx.com", # Optional "MCP_AUTH_TOKEN": "your-custom-token" # Default same as OKX_API_KEY

Test This Server

No automated test available for this server. Check the GitHub README for setup instructions.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

25/100across 5 weighted dimensions

How we score →

0255075100

−75

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.aahl/mcp-okx safe to use?: io.github.aahl/mcp-okx has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.aahl/mcp-okx?: io.github.aahl/mcp-okx can be installed by cloning its GitHub repository and following the setup instructions in the README.
What AI clients work with io.github.aahl/mcp-okx?: io.github.aahl/mcp-okx is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is io.github.aahl/mcp-okx actively maintained?: io.github.aahl/mcp-okx is less actively maintained — last commit was 190 days ago. It has 2 GitHub stars.

Similar servers

Others in finance

View all →

Alpha Vantage Mcp93

Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators

150 3

io.github.rezmeplxrf/insightsentry_mcp91

MCP server for InsightSentry financial data API - market data, options, screeners, and more

Actual Mcp90

Model Context Protocol for Actual Budget API

141 22

Xero Mcp90

A Model Context Protocol server allows Clients to interact with Xero

20 2

MCP Security Weekly

Get CVE alerts and security updates for io.github.aahl/mcp-okx and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

📲 Install

Method 1: uvx

{ "mcpServers": { "mcp-okx": { "command": "uvx", "args": ["mcp-okx"], "env": { "OKX_API_KEY": "your-okx-api-key", "OKX_API_SECRET": "api-secret-key", "OKX_PASSPHRASE": "api-passphrase", "OKX_TRADE_FLAG": "1", # 0: Production trading, 1: Demo trading "OKX_BASE_URL": "https://www.okx.com", # Optional "MCP_AUTH_TOKEN": "your-custom-token" # Default same as OKX_API_KEY } } } }

Method 2: Docker

mkdir /opt/mcp-okx cd /opt/mcp-okx wget https://raw.githubusercontent.com/aahl/mcp-okx/refs/heads/main/docker-compose.yml docker-compose up -d

{ "mcpServers": { "mcp-okx": { "url": "http://0.0.0.0:8811/mcp", # Streamable HTTP "headers": { "Authorization": "Bearer your-okx-api-key-or-custom-token" } } } }

⚙️ Environment variables

OKX_API_KEY: API key of your OKX account. Please refer to my api page regarding API Key creation.

OKX_API_SECRET: API secret key of your OKX account.

OKX_PASSPHRASE: API passphrase of your OKX account.

OKX_TRADE_FLAG: 0: Production trading, 1: Demo trading

OKX_BASE_URL: Base URL of OKX. Default: https://www.okx.com

MCP_AUTH_TOKEN: Custom token for authentication. Default same as OKX_API_KEY

🛠️ Available Tools

Account Tools

account_config - Get account configuration
account_balance - Get account balance
account_positions - Get account positions
account_position_risk - Get account position risk

Trading Tools

place_order - Place a new order
cancel_order - Cancel an incomplete order
get_trade_order - Get order details
get_order_list - Get incomplete order list
get_orders_history - Get Order History
close_positions - Liquidate all positions

Market Data

market_tickers - Get cryptocurrency rankings

Frequently Asked Questions

Is io.github.aahl/mcp-okx safe to use?

io.github.aahl/mcp-okx has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.aahl/mcp-okx?

io.github.aahl/mcp-okx can be installed by cloning its GitHub repository and following the setup instructions in the README.

What AI clients work with io.github.aahl/mcp-okx?

io.github.aahl/mcp-okx is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is io.github.aahl/mcp-okx actively maintained?

io.github.aahl/mcp-okx is less actively maintained — last commit was 190 days ago. It has 2 GitHub stars.

🆗 OKX MCP Server