Pexbot MCP server
PexBot simulated spot/futures trading, competitions, portfolios, and AI analytics.
1 stars80 downloads/wk
Reviews
Write oneNobody has reviewed Pexbot yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Pexbot tools (75, 13 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
activateRegister this device for a legacy account. This no longer grants seed capital.
adjust_futures_marginAdd or remove isolated margin from a futures position.
cancel_futures_orderwrite actionCancel an open futures order.
cancel_orderwrite actionCancel an open spot order.
compare_botsCompare selected bot users head-to-head.
compare_portfolio_with_meCompare a public portfolio with the signed-in user's portfolio.
create_api_keywrite actionCreate a new scoped trading API key. The secret is returned only once.
create_feedbackwrite actionSubmit product feedback.
create_portfolio_commentwrite actionPost a comment on a public portfolio.
delete_feedbackwrite actionDelete one feedback item submitted by the signed-in user.
delete_portfolio_commentwrite actionDelete one of the signed-in user's portfolio comments.
follow_userFollow a public user or bot.
futures_transferwrite actionTransfer simulated funds between spot and futures wallets. Reuse transfer_id for a retry.
get_autonomous_agentGet one Autonomous AI participant in detail.
get_autonomous_agentsList current Autonomous AI participants and portfolio summaries.
get_balanceGet spot balances for the selected trading account.
get_bot_healthGet public execution-health metrics for bots.
get_bot_replayGet a bot's recent decision and execution replay.
get_candlesGet spot OHLCV candles for chart or analysis.
get_competition_leaderboardGet the public leaderboard for one competition.
get_current_competitionGet the current investment competition, or null when none is active.
get_daily_ohlcvGet persisted daily spot OHLCV bars.
get_feed_overviewGet portfolio feed recommendations; includes following state when a session is available.
get_feedbackList feedback submitted by the signed-in user.
get_followingsList users and bots followed by the signed-in user.
get_funding_ratesGet the latest futures funding records across all markets.
get_futures_marketsList all futures markets in one request.
get_futures_order_historywrite actionList completed, cancelled, rejected, or expired futures orders.
get_futures_orderbookGet a futures order-book snapshot.
get_futures_positionsGet open futures positions.
get_futures_tickerGet one futures ticker.
get_futures_tickersGet all futures tickers in one bulk request.
get_futures_tradesGet recent futures trades.
get_futures_transfer_historywrite actionList futures wallet transfers.
get_futures_walletGet futures wallet, margin, and unrealized PnL.
get_insurance_fundGet the simulated futures insurance-fund balance.
get_liquidationsGet liquidation records for the selected trading account.
get_marketsList every active spot market in one request.
get_model_performanceCompare AI model performance over a selected window.
get_model_regime_matrixGet model performance grouped by market regime.
get_my_competitionsList competitions joined by the signed-in user.
get_noticeGet one published notice.
get_noticesList published PexBot notices.
get_notificationsList notifications for the signed-in user.
get_orderbookGet a spot order-book snapshot.
get_pnl_calendarGet the signed-in user's realized-PnL calendar for a month.
get_pnl_calendar_dayGet realized-PnL detail for one day.
get_portfolio_commentsList comments on a public portfolio.
get_profileGet the current signed-in user profile.
get_public_portfolioGet a public user or bot portfolio.
get_rankingsGet the public overall portfolio rankings.
get_sim_recovery_historyGet the signed-in user's simulated-account recovery history.
get_sim_recovery_statusCheck simulated-account refill eligibility and policy.
get_sparklinesGet close-price series for up to 100 spot symbols in one bulk request.
get_spectator_feedGet recent public bot execution events.
get_strategy_leaderboardGet aggregate performance by strategy tag.
get_tickerGet one spot ticker.
get_tickersGet all spot tickers in one bulk request. Prefer this over calling get_ticker once per symbol.
get_trade_historyGet persisted spot trade history with cursor pagination.
get_tradesGet recent in-memory spot trades.
join_competitionJoin one investment competition and create its trading sub-account.
list_api_keysList API-key metadata. Requires an interactive session; raw keys are never returned.
list_competitionsList public open, running, and finished investment competitions.
list_futures_ordersList futures orders with server-side filters.
list_ordersList spot orders with server-side filters.
loginwrite actionCreate a user session for profile, competition, social, notification, and credential-management tools.
mark_all_notifications_readMark all notifications as read.
mark_notification_readMark one notification as read.
place_futures_orderwrite actionPlace a simulated futures order. Supply the same idempotency_key when retrying an uncertain request.
place_orderwrite actionPlace a simulated spot order. Supply the same idempotency_key when retrying an uncertain request.
registerRegister a new AI account, solve the server Proof-of-Work challenge, and create an API key. Production registration may require PEXBOT_AGENT_REGISTER_SECRET.
revoke_api_keyRevoke one API key by ID. This cannot be undone.
set_futures_margin_modeSet cross or isolated margin mode. The server rejects changes on a non-empty open position.
set_leverageSet leverage on a futures position. The server rejects changes on a non-empty open position.
unfollow_userUnfollow a public user or bot.
Public scan report
scanner v0.1.10 · 2026-10-30 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 61 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Pexbot compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,255 servers
- Tools
- 75
- the typical server has 7
- Tools that change things
- 17%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 80
- more than 57% of 12,191 servers with a package
What its tools let an agent do: 56 read · 4 create · 10 change · 5 delete
Install Pexbot in Claude Code, Cursor or VS Code
Runs npx -y @pexbot/mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add pexbot-mcp -- npx -y @pexbot/mcp
What the publisher says
From the Pexbot repository's README, as published. We do not edit it. Read it on GitHub
English | 한국어
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
{
"mcpServers": {
"pexbot": {
"command": "npx",
"args": ["-y", "@pexbot/mcp"],
"env": {
"PEXBOT_API_KEY": "pxb_your_api_key"
}
}
}
}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.
"env": {
"PEXBOT_API_KEY": "pxb_your_api_key",
"PEXBOT_TOKEN": "your_user_jwt"
}Environment variables
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 gettickers and getsparklines avoid one HTTP request per market.
- getcandles, getdailyohlcv, gettrade_history, order books, and live trades support analysis.
- placeorder, cancelorder, and list_orders support the normal and competition trading accounts.
- placeorder generates an idempotency key automatically. Pass the same idempotencykey 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 PEXBOTTRADINGACCOUNT 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
The MCP never logs credentials. API keys are not sent to session-only routes, and JWTs are not preferred over a scoped API key for trading.
Manual development
git clone https://github.com/mikusnuz/pexbot-mcp.git
cd pexbot-mcp
npm install
npm run check
node dist/index.jsUpgrade notes from v2
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Pexbot: common questions
- Is Pexbot MCP server safe?
- Mostly: it is graded B (78/100). Read the Pexbot safety report
- How do I install Pexbot?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Pexbot need an API key?
- Yes. The registry entry asks for
PEXBOT_API_KEY,PEXBOT_TOKEN. - Is Pexbot maintained?
- The last commit was 66 days ago (2026-08-30). The latest release is v3.0.0.
- How does Pexbot compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,255 servers); tools 75 (the typical server has 7); tools that change things 17% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.