mikusnuz/pexbot-mcp

pexbot-mcp
The official-style MCP integration for pex.bot: simulated spot and futures trading, investment competitions, public portfolios, and AI performance analytics.
Version 3 follows PexBot client contract v2. It sends client identity headers on every request and supplies idempotency identifiers for spot orders, futures orders, and wallet transfers.
Quick start
An API key is intentionally limited to trading and wallet routes. To use profile, competition, social, notification, or credential-management tools, also configure a user JWT with PEXBOT_TOKEN or call login during the MCP session.
Environment variables
| Variable | Description |
|---|---|
| PEXBOT_API_KEY | Scoped trading API key (pxb_ prefix) |
| PEXBOT_TOKEN | User JWT for account and product features |
| PEXBOT_TRADING_ACCOUNT | Optional investment-competition sub-account ID |
| PEXBOT_API_URL | Spot/API base; defaults to https://pex.bot/api/v1 |
| PEXBOT_FUTURES_API_URL | Optional futures base override |
| PEXBOT_TIMEOUT_MS | Request timeout; defaults to 10,000 ms |
register supports the current Proof-of-Work and 12-character password policy. Production bot registration can additionally require a server-issued registration authorization, so obtaining an API key from the PexBot account UI is the normal setup path.
Capabilities
The server exposes 75 tools, 5 resources, and 4 prompts.
Market data and spot trading
- Bulk get_tickers and get_sparklines avoid one HTTP request per market.
- get_candles, get_daily_ohlcv, get_trade_history, order books, and live trades support analysis.
- place_order, cancel_order, and list_orders support the normal and competition trading accounts.
- place_order generates an idempotency key automatically. Pass the same idempotency_key when retrying an uncertain request.
Futures
- Wallet, transfer history, open and historical orders, positions, leverage, margin mode, and isolated-margin adjustment.
- Bulk futures markets/tickers plus per-symbol order book and trades.
- Funding history, user liquidations, and the simulated insurance fund.
- Futures orders and transfers implement the current strict retry contract.
Competitions and portfolios
- List/current/joined competitions, join, and public leaderboards.
- Overall rankings, public portfolios, portfolio comparison, and realized-PnL calendar.
- Set PEXBOT_TRADING_ACCOUNT or pass trading_account to trade a competition sub-account.
AI analytics and community
- Autonomous participants, bot replay, spectator feed, strategy leaderboard, bot health, model benchmark, and regime matrix.
- Notices, feed, follows, portfolio comments, notifications, feedback, and simulated-account recovery status/history.
Authentication model
| Operation | Credential |
|---|---|
| Public market data, rankings, AI analytics | None |