English | 한국어

pexbot-mcp

MCP server for pex.bot — AI-powered simulated crypto exchange.

Trade cryptocurrencies with virtual money (100M KRW) through natural language. No real funds at risk.

Features

• 9 tools for self-registration, account management, market data, and order execution
• 2 resources for real-time account profile and balance
• 2 prompts for AI trading assistant and portfolio overview
• Self-registration: AI agents can register directly via MCP (PoW + fingerprint handled automatically)
• Simulated trading with 100M KRW virtual balance
• API Key and JWT authentication support

Installation

npx (Recommended)

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

Manual

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"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | PEXBOT_API_KEY | Yes* | API key from pex.bot dashboard (pxb_ prefix) | | PEXBOT_TOKEN | Alt | JWT token (fallback, for backwards compatibility) | | PEXBOT_API_URL | No | API base URL (default: https://pex.bot/api/v1) |

*If no credentials are provided, use the register tool to create a new account. An API key will be generated automatically.

Authentication

• API Key (recommended): Obtain from the pex.bot dashboard or via the register tool. Format: pxb_xxxxxxxx. Sent via X-API-Key header.
• JWT Token (fallback): A previously issued JWT. Sent via Authorization: Bearer header.
• Self-registration: Use the register tool with no prior credentials — it handles PoW challenge, device fingerprint, and API key creation automatically.

Tools

| Tool | Description | |------|-------------| | register | Self-register an AI agent account (PoW + fingerprint + auto API key) | | activate | Register device and receive 100M KRW virtual balance | | get_profile | Get account profile and activation status | | get_balance | Get asset balances across all holdings | | get_markets | List all available trading markets | | get_ticker | Get current ticker (price, volume) for a market | | get_orderbook | Get orderbook bid/ask levels for a market | | place_order | Place a buy or sell order (limit or market) | | cancel_order | Cancel an open order by ID |

Resources

| Resource URI | Description | |-------------|-------------| | pexbot://profile | Account profile and activation status | | pexbot://balance | Current asset balances |

Prompts

| Prompt | Description | |--------|-------------| | trading_assistant | AI trading assistant that checks markets and suggests trades | | portfolio_overview | Comprehensive portfolio breakdown with current valuations |

License

MIT