Pexbot

MCP server for pex.bot enabling AI-powered simulated crypto trading with virtual funds.

javascript

0

GitHub Stars

javascript

Language

3 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mikusnuz-pexbot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mikusnuz/pexbot-mcp"
      ],
      "env": {
        "PEXBOT_TOKEN": "your_jwt_token_here",
        "PEXBOT_API_KEY": "pxb_your_api_key_here",
        "PEXBOT_API_URL": "https://pex.bot/api/v1"
      }
    }
  }
}

You can run the MCP server for pex.bot to access an AI-powered simulated crypto exchange with virtual funds. This environment lets you trade cryptocurrencies using natural language, with no real-money risk, while leveraging built-in tools and authentication to manage accounts, markets, and orders.

How to use

Use an MCP client to connect to the pexbot MCP server. You will authenticate with an API key or a JWT token, then use the provided tools to activate your device, view your profile and balance, explore markets, and place or cancel orders. The AI trading assistant and portfolio overview prompts help you make informed trading decisions and monitor your holdings.

How to install

Prerequisites: you need Node.js installed on your system. Ensure you have npm or npx available in your environment.

{
  "mcpServers": {
    "pexbot": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/pexbot-mcp"],
      "env": {
        "PEXBOT_API_KEY": "pxb_your_api_key_here"
      }
    }
  }
}

Alternatively, you can clone the repository, install dependencies, and build the project before running it directly with Node.

git clone https://github.com/mikusnuz/pexbot-mcp.git
cd pexbot-mcp
npm install
npm run build

{
  "mcpServers": {
    "pexbot": {
      "command": "node",
      "args": ["/path/to/pexbot-mcp/dist/index.js"],
      "env": {
        "PEXBOT_API_KEY": "pxb_your_api_key_here"
      }
    }
  }
}

Additional steps

Set the environment variable PEXBOT_API_KEY with your API key from the pex.bot dashboard. You can also provide a JWT via PEXBOT_TOKEN if you prefer the legacy authentication method. Optional: set PEXBOT_API_URL if your MCP server base URL differs from the default.

Notes on authentication

API Key (recommended): Use a key starting with pxb_ and send it in the X-API-Key header. JWT Token (fallback): Send as Authorization: Bearer <token>.

Available tools

activate

Register device and receive 100M KRW virtual balance

get_profile

Retrieve the account profile and activation status

get_balance

Query asset balances across all holdings

get_markets

List all available trading markets

get_ticker

Fetch current ticker data (price and volume) for a market

get_orderbook

Retrieve orderbook levels for a market (bids/asks)

place_order

Place a buy or sell order (limit or market)

cancel_order

Cancel an open order by its ID