> For the complete documentation index, see [llms.txt](https://www.pionex.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.pionex.com/docs/ai-kit-docs/mcp/mcp-quickstart.md).

# MCP Quickstart

The Pionex Trade MCP Server lets AI clients (Cursor, Claude Desktop, VS Code, etc.) directly call Pionex exchange functions for market data, account queries, and order management.

### Installation (Claude Desktop)

Install via the `.mcpb` one-click installer — no Node.js or command-line setup required:

1. Download `pionex-mcp.mcpb` from the [latest GitHub Release](https://github.com/pionex-official/pionex-ai-kit/releases/latest)
2. Double-click the file — Claude Desktop will open an install dialog
3. Enter your Pionex API Key and Secret when prompted (stored securely by Claude Desktop)
4. Done — Pionex tools are now available in Claude Desktop

> **What is `.mcpb`?** It's Claude Desktop's native MCP plugin format. No Node.js installation or command-line setup required.

***

### Installation (Cursor, Windsurf, VS Code, Claude Code, OpenClaw)

**Prerequisites:** Node.js >= 18

#### 1. Install the CLI

```bash
npm install -g @pionex/pionex-ai-kit
```

#### 2. Configure API Credentials

Run the interactive wizard and enter your Pionex API Key and Secret:

```bash
pionex-ai-kit onboard
```

Credentials are saved to `~/.pionex/config.toml` with support for multiple profiles.

> You can create an API Key at <https://www.pionex.com/my-account/api>.
>
> [API Key Guide](https://www.pionex.com/docs/api-docs/references/api-key-guide)

> If you only need market data (no trading or balance queries), you can skip this step.

#### 3. Register the MCP Server with Your AI Client

Pick the client you are using and run the corresponding command:

```bash
# Cursor
pionex-ai-kit setup --mcp=pionex-trade-mcp --client cursor

# Claude Desktop
pionex-ai-kit setup --mcp=pionex-trade-mcp --client claude-desktop

# Claude Code
pionex-ai-kit setup --mcp=pionex-trade-mcp --client claude-code

# VS Code
pionex-ai-kit setup --mcp=pionex-trade-mcp --client vscode

# Windsurf
pionex-ai-kit setup --mcp=pionex-trade-mcp --client windsurf

# OpenClaw
pionex-ai-kit setup --mcp=pionex-trade-mcp --client openclaw
```

#### 4. Restart Your Client

After setup, **restart your AI client** for the MCP Server to take effect.

### Upgrade

```bash
npm update -g @pionex/pionex-ai-kit @pionex/pionex-trade-mcp
```

### Verify the Installation

Type the following prompt in your AI client:

> "Use the Pionex tools to show the order book depth for BTC\_USDT."

If the agent successfully returns the BTC\_USDT order book, MCP is installed correctly.

### Next Steps

* See the [MCP User Guide](/docs/ai-kit-docs/mcp/mcp-guides.md) for full features and detailed configuration