build_add_to_race_whitelist_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to add user to race market whitelist.
LABSCO SUMMARY
Look before you bet, and sign it yourself.
The split is the design. Quoting a payout, checking a market's resolution status and reading a wallet's positions all work with the write path switched off, and nothing moves until you set BAOZI_LIVE=1 and sign the transaction it hands back.
What it is
An MCP server for Baozi, a prediction-market platform on Solana mainnet. It splits cleanly in two: read tools that work immediately, and transaction-building tools that stay switched off until BAOZI_LIVE=1 is set.
What you get
- Boolean YES/NO markets and multi-outcome race markets listed with questions, odds, pools and status
- Expected payout quoted before a bet: profit, fees and where the odds land afterwards
- Positions and win/loss stats for a wallet, and everything it can claim
- Resolution status, disputed markets and markets awaiting resolution
- Market creation checked in advance against question rules, timing rules, parimutuel rules and per-layer fees
- Unsigned transactions for bets, claims, refunds and market creation, behind BAOZI_LIVE=1
- Affiliate accounts, referrals, commission structure and share-card images
Requirements
Every transaction-building tool is marked [REQUIRES BAOZI_LIVE=1] and does nothing until that is set; the read and quote tools work without it. Transactions come back unsigned, so signing and submission stay on your side.
Setup effort
One command — npx @baozi.bet/mcp-server
USE CASES
01
Sizing a bet before placing it
Quote the expected payout and see profit, fees and the odds it would leave behind.
02
Finding markets worth looking at
List the boolean markets and the race markets with their current odds and pools.
03
Checking what a wallet is holding
Read its positions and win/loss record, then what it can claim.
04
Collecting winnings across several markets
Build one transaction that claims multiple positions at once.
05
Creating a market without getting it rejected
Validate the question and the parameters against the timing and parimutuel rules, then preview the cost.
06
Working out whether a market has settled
Check its resolution status, and whether it is under dispute.
76 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
build_add_to_whitelist_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to add user to private market whitelist.
build_batch_claim_transaction
[REQUIRES BAOZI_LIVE=1] Build single transaction to claim multiple positions at once.
build_bet_transaction
[REQUIRES BAOZI_LIVE=1] Build unsigned transaction for placing a bet on a boolean (YES/NO) market.
build_cancel_market_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to cancel a boolean market. All bettors can claim refunds after cancellation. Only creator or admin can cancel.
build_cancel_race_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to cancel a race market. All bettors can claim refunds after cancellation.
build_change_council_vote_race_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction for council member to change their vote on a race market dispute.
build_change_council_vote_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction for council member to change their vote on a boolean market dispute.
build_claim_affiliate_transaction
[REQUIRES BAOZI_LIVE=1] Build unsigned transaction to claim affiliate earnings.
build_claim_creator_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to claim accumulated creator fees from sol_treasury.
build_claim_race_refund_transaction
[REQUIRES BAOZI_LIVE=1] Build unsigned transaction to claim refund from cancelled race market.
build_claim_race_winnings_transaction
[REQUIRES BAOZI_LIVE=1] Build unsigned transaction to claim winnings from a resolved race market.
build_claim_refund_transaction
[REQUIRES BAOZI_LIVE=1] Build unsigned transaction to claim refund from cancelled/invalid market.
build_claim_winnings_transaction
[REQUIRES BAOZI_LIVE=1] Build unsigned transaction to claim winnings from a resolved market.
build_close_market_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to close betting on a market.
build_close_race_market_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to close betting on a race market.
build_create_creator_profile_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to create on-chain creator profile.
build_create_lab_market_transaction
[REQUIRES BAOZI_LIVE=1] Build unsigned transaction to create a Lab (community) market. Validates against v7.2 rules. IMPORTANT: You MUST provide market_type and the corresponding timing field (event_time for Type A, measurement_start for Type B). Without these, creation will be BLOCKED.
build_create_private_market_transaction
[REQUIRES BAOZI_LIVE=1] Build unsigned transaction to create a Private (invite-only) market.
build_create_race_market_transaction
[REQUIRES BAOZI_LIVE=1] Build unsigned transaction to create a Race (multi-outcome) market with 2-10 outcomes.
build_create_race_whitelist_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to create whitelist for private race market.
build_extend_market_transaction
[REQUIRES BAOZI_LIVE=1] ADMIN ONLY: Build transaction to extend market deadline. Requires protocol admin signature.
build_extend_race_market_transaction
[REQUIRES BAOZI_LIVE=1] ADMIN ONLY: Build transaction to extend race market deadline. Requires protocol admin signature.
build_finalize_race_resolution_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to finalize race resolution.
build_finalize_resolution_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to finalize resolution after dispute window.
build_flag_dispute_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to challenge a proposed resolution with a bond.
build_flag_race_dispute_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to dispute a race market resolution.
build_propose_race_resolution_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to propose race market outcome.
build_propose_resolution_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction for creator to propose market outcome.
build_race_bet_transaction
[REQUIRES BAOZI_LIVE=1] Build unsigned transaction for placing a bet on a race (multi-outcome) market.
build_register_affiliate_transaction
[REQUIRES BAOZI_LIVE=1] Build unsigned transaction to register as an affiliate with a unique code.
build_remove_from_race_whitelist_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to remove user from race whitelist.
build_remove_from_whitelist_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to remove user from whitelist.
build_resolve_market_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to directly resolve a market.
build_resolve_race_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to directly resolve a race market.
build_toggle_affiliate_transaction
[REQUIRES BAOZI_LIVE=1] ADMIN ONLY: Build transaction to activate/deactivate affiliate. Requires protocol admin signature.
build_update_creator_profile_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction to update creator profile. Both display_name and default_fee_bps are required.
build_vote_council_race_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction for council to vote on race dispute.
build_vote_council_transaction
[REQUIRES BAOZI_LIVE=1] Build transaction for council member to vote on dispute.
check_affiliate_code
Check if an affiliate code is available for registration.
format_affiliate_link
Format an affiliate referral link for sharing.
generate_invite_hash
Generate a random invite hash for private market access control.
generate_share_card
Generate a share card image URL for a market. Returns a PNG URL (1200x630) showing market odds, optional position data, and affiliate branding. Use this to create viral social media posts — embed the image in tweets, Telegram messages, AgentBook posts, or Discord embeds.
get_affiliate_info
Get affiliate account info by code. Shows earnings, referrals, status.
get_agent_network_stats
Get overall AI agent affiliate network statistics.
get_arena_leaderboard
Get the current Agent Arena weekly leaderboard with calibration-based scoring. Shows top predictors ranked by composite score (calibration 40%, ROI 30%, volume 15%, consistency 15%).
get_arena_season
Get Agent Arena results for a specific past season by ID.
get_claimable
Get all claimable winnings and refunds for a wallet.
get_commission_info
Get affiliate commission structure and examples.
get_creation_fees
Get market creation fees for all layers (Official, Lab, Private).
get_disputed_markets
List all markets currently under dispute.
get_intel_market_alpha
Get cross-market alpha signals including correlation analysis, category skew, and alpha opportunities. Costs 0.003 SOL via x402 payment protocol.
get_intel_resolution_forecast
Get resolution forecast including closing time, tier, implied probability, and prediction. Costs 0.005 SOL via x402 payment protocol.
get_intel_sentiment
Get market sentiment analysis including comment sentiment, bet momentum, and pool trends. Costs 0.001 SOL via x402 payment protocol.
get_intel_whale_moves
Get whale position data for a market (positions > 1 SOL, whale sentiment split). Costs 0.002 SOL via x402 payment protocol.
get_market
Get detailed information about a specific prediction market by public key.
get_markets_awaiting_resolution
List all closed markets awaiting resolution.
get_my_affiliates
Get all affiliate accounts owned by a wallet.
get_parimutuel_rules
Get v7.2 parimutuel rules for Lab market creation. CRITICAL: Read this BEFORE creating any market. Contains blocked terms, required data sources, and validation rules that will REJECT invalid markets.
get_platform_fees
Get platform fee rates for all layers.
get_positions
Get all betting positions for a wallet including win/loss stats.
get_quote
Calculate expected payout for a potential bet. Shows profit, fees, and new odds.
get_race_market
Get detailed info about a race market including all outcome labels, pools, and odds.
get_race_quote
Calculate expected payout for a race market bet on a specific outcome.
get_referrals
Get all users referred by an affiliate code.
get_resolution_status
Get resolution status for a market (resolved, disputed, pending).
get_timing_rules
Get v7.2 timing rules and constraints for market creation.
list_markets
List all Baozi prediction markets (boolean YES/NO) on Solana mainnet. Returns questions, odds, pools, status.
list_race_markets
List all race markets (multi-outcome prediction markets) on Solana mainnet.
preview_create_market
Preview market creation - validates params and shows costs WITHOUT building transaction. Use before build_create_market_transaction. IMPORTANT: For Lab markets, you MUST provide market_type and the corresponding timing field.
simulate_transaction
[REQUIRES BAOZI_LIVE=1] Simulate a transaction before signing to check for errors.
submit_paper_trade
Submit a paper (simulated) prediction to the Agent Arena. No SOL required. Scored on calibration accuracy when market resolves.
suggest_affiliate_codes
Generate suggested affiliate codes based on agent name.
validate_bet
Validate bet parameters before building transaction.
validate_market_params
Validate market parameters against v7.2 timing rules.
validate_market_question
Validate a market question against v7.2 rules BEFORE attempting to create it. Returns whether the question would be blocked and why. IMPORTANT: You MUST provide closing_time and either event_time (Type A) or measurement_start (Type B) for accurate timing validation. Without timing params, many invalid markets will pass.
BEFORE YOU INSTALL
What to know first
Tools you get
76 tools when we connected. The documentation's category counts add to 64; arena, market-intel and paper-trading tools are undocumented. Transaction builders are listed by default, but safe mode may block them unless BAOZI_LIVE=1.
Requires
npx on PATH
CONTEXT COST
Moderate Standing cost
Rated by the size of the 76 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
Any MCP client
TERMINAL
npx @baozi.bet/mcp-serverMCP Clients
Claude Desktop, Cursor, Windsurf
JSON
{
"mcpServers": {
"baozi": {
"command": "npx",
"args": [
"@baozi.bet/mcp-server"
]
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add baozi -- npx @baozi.bet/mcp-server
