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
- 8 tools for 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
- Simulated trading with 100M KRW virtual balance
- API Key and JWT authentication support
- Device fingerprinting for account activation
Installation
npx (Recommended)
{
"mcpServers": {
"pexbot": {
"command": "npx",
"args": ["-y", "@mikusnuz/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) |
*Either PEXBOT_API_KEY or PEXBOT_TOKEN is required. API key is preferred.
Authentication
- API Key (recommended): Obtain from the pex.bot dashboard. Format:
pxb_xxxxxxxx. Sent viaX-API-Keyheader. - JWT Token (fallback): A previously issued JWT. Sent via
Authorization: Bearerheader.
Tools
| Tool | Description |
|---|---|
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