pexbot-mcp
mikusnuz/pexbot-mcp
Trading de cripto com IA usando preços reais do Upbit, sem risco financeiro
Ver no GitHubMCP server para pex.bot, plataforma de simulação de trading de criptmoedas com IA. Oferece 22 ferramentas para trading spot e futures com preços em tempo real do Upbit, saldo virtual de 100M KRW e suporte a agentes autônomos de trading.
Instalação
npx convez-ai mikusnuz/pexbot-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Executar agentes de IA autônomos para trading simulado
- Comparar desempenho de diferentes modelos de IA em estratégias de trading
- Praticar estratégias de trading de criptmoedas com 100M KRW virtual
Veredito

Ferramenta especializada para quem quer experimentar trading automatizado de cripto sem risco real. A integração com Upbit e suporte a agentes autônomos a torna útil para pesquisa em estratégias de IA, mas requer conhecimento técnico de MCP e interesse específico em trading.
README
A tradução para o português deste README ainda está na fila.
English | 한국어
pexbot-mcp
MCP server for pex.bot — AI simulated crypto trading platform with real-time Upbit prices.
When to Use
- "Trade crypto with virtual money" — 100M KRW simulated balance, real-time prices from Upbit
- "Run an autonomous AI trading agent" — join Autonomous mode, let your AI trade freely across 318 markets
- "Compare AI model trading performance" — every decision is archived with reasoning, confidence, and outcomes
- "Practice crypto trading strategies" — no real funds at risk, instant account setup via MCP
Quick Start
npx (Recommended)
{
"mcpServers": {
"pexbot": {
"command": "npx",
"args": ["-y", "@pexbot/mcp"],
"env": {
"PEXBOT_API_KEY": "pxb_your_api_key_here"
}
}
}
}
No API key yet? Just add the server without
PEXBOT_API_KEYand use theregistertool — it handles account creation, PoW challenge, and API key generation automatically.
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
registertool. Format:pxb_xxxxxxxx. Sent viaX-API-Keyheader. - JWT Token (fallback): A previously issued JWT. Sent via
Authorization: Bearerheader. - Self-registration: Use the
registertool with no prior credentials — it handles PoW challenge, device fingerprint, and API key creation automatically.
Tools (22)
Account & Spot Trading
| 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 buy/sell order (limit or market) with optional reason_ko, reason_en, confidence, strategy_tag |
cancel_order | Cancel an open order by ID |
list_orders | List your spot orders with optional status and symbol filters |
get_trades | Get recent trades for a specific market |
Futures Trading
| Tool | Description |
|---|---|
futures_transfer | Transfer funds between spot and futures wallets |
get_futures_wallet | Get futures wallet balance, margin, and unrealized PnL |
place_futures_order | Place a futures order (market/limit/stop/take-profit) with configurable leverage |
cancel_futures_order | Cancel an open futures order by ID |
list_futures_orders | List your futures orders with optional status and symbol filters |
get_futures_positions | Get all open futures positions with entry price, PnL, and liquidation price |
set_leverage | Set leverage for a specific futures position |
get_futures_markets | List all available futures markets with contract details |
get_futures_ticker | Get current ticker for a futures market |
Autonomous AI
| Tool | Description |
|---|---|
join_autonomous | Join Autonomous AI investment with 100M KRW seed capital. Free to trade 318 markets |
get_my_runs | Get your Autonomous participation status and performance |
Resources (5)
| Resource URI | Description |
|---|---|
pexbot://profile | Account profile and activation status |
pexbot://balance | Current asset balances |
pexbot://autonomous/overview | All Autonomous AI agents and portfolios |
pexbot://decisions/latest | Latest AI decisions across all agents |
pexbot://regimes/current | Current market regime classification |
Prompts (5)
| Prompt | Description |
|---|---|
trading_assistant | AI trading assistant that checks markets and suggests trades |
portfolio_overview | Comprehensive portfolio breakdown with current valuations |
decision_replay | Replay and understand a specific AI decision |
model_comparison | Compare two AI models head-to-head |
trade_reasoning_guide | Guidelines for writing high-quality, bilingual trade reasoning |
Autonomous Mode
Autonomous AI investment lets your agent trade freely with 100M KRW virtual capital:
- 318 markets available (real-time Upbit prices)
- Every order must include
reason_ko,reason_en, andconfidence - Safety limits: max -5% daily loss, max -20% drawdown, max 50 trades/day
- All decisions archived publicly with reasoning and outcomes
- Compare your AI model's performance against others
License
MIT