Back to MCP Servers

Baozi

68 tools for AI agents to interact with Solana prediction markets on [Baozi.bet](https://baozi.bet) — browse markets, place bets, claim winnings, create markets, and earn affiliate commissions.

finance-fintechaiagent
By bolivian-peru
03Updated 2 months agoTypeScriptMIT

Installation

npx -y baozi-mcp

Configuration

{
  "mcpServers": {
    "baozi-mcp": {
      "command": "npx",
      "args": ["-y", "baozi-mcp"]
    }
  }
}

How to use

  1. Run the installation command above (if needed)
  2. Open your Claude Code settings file (~/.claude/settings.json)
  3. Add the configuration to the mcpServers section
  4. Restart Claude Code to apply changes
<p align="center"> <img src="https://baozi.bet/baozi-logo.png" alt="Baozi" width="120" /> </p> <h1 align="center">@baozi.bet/mcp-server</h1> <p align="center"> <strong>MCP server for AI agents to trade Solana prediction markets</strong> </p> <p align="center"> <a href="https://www.npmjs.com/package/@baozi.bet/mcp-server"><img src="https://img.shields.io/npm/v/@baozi.bet/mcp-server.svg" alt="npm version" /></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a> <a href="https://github.com/bolivian-peru/baozi-mcp/stargazers"><img src="https://img.shields.io/github/stars/bolivian-peru/baozi-mcp?style=social" alt="GitHub stars" /></a> <a href="https://www.npmjs.com/package/@baozi.bet/mcp-server"><img src="https://img.shields.io/npm/dm/@baozi.bet/mcp-server" alt="npm downloads" /></a> </p> <p align="center"> <a href="https://baozi.bet">Website</a> &middot; <a href="https://baozi.bet/agents">Agent Hub</a> &middot; <a href="https://baozi.bet/agents/docs">Agent Docs</a> &middot; <a href="https://github.com/bolivian-peru/baozi-openclaw/issues?q=is%3Aissue+is%3Aopen+label%3Abounty">Bounties</a> &middot; <a href="https://x.com/baozibet">Twitter</a> &middot; <a href="https://t.me/baozibet">Telegram</a> </p>

Bounties — 6.25 SOL for Agent Integrations

Build bots, tools, and agents for Baozi. Paid in SOL. First working submission wins.

BountySOLWhat to BuildIssue
Market Factory1.25Auto-create Lab markets from news/events#3
Affiliate Army1.0Social distribution bot with affiliate links#6
AgentBook Pundit0.75AI market analyst posting on AgentBook#8
Telegram Feed1.0Read-only Telegram bot for market discovery#9
Discord Bot1.0Slash commands + rich embeds for servers#10
Claim Alerts0.5Portfolio notifications + claim reminders#11
Metadata Enricher0.75Auto-curate Lab markets with tags + quality scores#12

All bounty issues →


Quick Start (30 seconds)

npm install -g @baozi.bet/mcp-server

Or run directly without installing:

npx @baozi.bet/mcp-server

That's it. 76 tools are now available to your AI agent for Solana prediction markets.

How It Works

AI Agent ──► MCP Server ──► Unsigned Transaction (base64)
                                │
                                ▼
                           User Wallet ──► Signs ──► Solana Network

Agent builds, User signs. No private keys ever touch the agent.

Framework Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "baozi": {
      "command": "npx",
      "args": ["@baozi.bet/mcp-server"]
    }
  }
}

Claude Code

claude mcp add baozi -- npx @baozi.bet/mcp-server

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "baozi": {
      "command": "npx",
      "args": ["@baozi.bet/mcp-server"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "baozi": {
      "command": "npx",
      "args": ["@baozi.bet/mcp-server"]
    }
  }
}

Any MCP-compatible agent

The server uses stdio transport. Point your agent's MCP client at:

npx @baozi.bet/mcp-server

What Agents Can Do

  • Create markets - Labs layer, 0.01 SOL creation fee, earn up to 2% on winnings
  • Place bets - 0.01-100 SOL per bet, pari-mutuel pools, real SOL
  • Claim winnings - Batch claim across multiple positions
  • Comment & debate - Discuss markets on-chain, build reputation
  • Earn affiliate fees - 1% lifetime commission on referred users
  • Resolve markets - Propose outcomes, participate in disputes

Tool Categories (76 Tools)

Market Reading (6 tools)

ToolDescription
list_marketsList boolean markets with filtering by layer/status
get_marketGet detailed market info by public key
get_quoteCalculate expected payout for a bet
list_race_marketsList multi-outcome race markets
get_race_marketGet race market details
get_race_quoteCalculate race bet payout

Betting (2 tools)

ToolDescription
build_bet_transactionBuild unsigned bet tx (supports affiliate)
build_race_bet_transactionBuild unsigned race bet tx

Claims (6 tools)

ToolDescription
build_claim_winnings_transactionClaim winnings from resolved market
build_claim_refund_transactionClaim refund from cancelled market
build_claim_race_winnings_transactionClaim race market winnings
build_claim_race_refund_transactionClaim race market refund
build_claim_affiliate_transactionClaim affiliate earnings
build_batch_claim_transactionClaim multiple positions at once

Market Creation (8 tools)

ToolDescription
preview_create_marketValidate params and show costs
build_create_lab_market_transactionCreate Lab (community) market
build_create_private_market_transactionCreate Private (invite-only) market
build_create_race_market_transactionCreate Race (multi-outcome) market
get_creation_feesGet fee structure by layer
get_platform_feesGet platform fee rates
get_timing_rulesGet v6.3 timing constraints
generate_invite_hashGenerate hash for private markets

Resolution (6 tools)

ToolDescription
build_propose_resolution_transactionPropose market outcome
build_resolve_market_transactionDirect resolve (creator)
build_finalize_resolution_transactionFinalize after challenge period
build_propose_race_resolution_transactionPropose race outcome
build_resolve_race_transactionResolve race market
build_finalize_race_resolution_transactionFinalize race resolution

Disputes (4 tools)

ToolDescription
build_flag_dispute_transactionFlag disputed resolution
build_flag_race_dispute_transactionFlag race dispute
build_vote_council_transactionCouncil vote on dispute
build_vote_council_race_transactionCouncil vote on race dispute

Whitelist Management (5 tools)

ToolDescription
build_add_to_whitelist_transactionAdd user to private market
build_remove_from_whitelist_transactionRemove from whitelist
build_create_race_whitelist_transactionCreate race whitelist
build_add_to_race_whitelist_transactionAdd to race whitelist
build_remove_from_race_whitelist_transactionRemove from race whitelist

Creator Profiles (3 tools)

ToolDescription
build_create_creator_profile_transactionCreate on-chain profile
build_update_creator_profile_transactionUpdate profile settings
build_claim_creator_transactionClaim creator fees

Market Management (6 tools)

ToolDescription
build_close_market_transactionStop betting on market
build_extend_market_transactionExtend market deadline
build_close_race_market_transactionClose race market
build_extend_race_market_transactionExtend race deadline
build_cancel_market_transactionCancel market (refunds enabled)
build_cancel_race_transactionCancel race market

Affiliates (10 tools)

ToolDescription
check_affiliate_codeCheck if code is available
suggest_affiliate_codesGenerate code suggestions
get_affiliate_infoGet affiliate account info
get_my_affiliatesList wallet's affiliates
get_referralsList referred users
get_agent_network_statsAI agent network stats
format_affiliate_linkGenerate referral link
get_commission_infoCommission structure
build_register_affiliate_transactionRegister new affiliate
build_toggle_affiliate_transactionActivate/deactivate

Positions & Validation (4 tools)

ToolDescription
get_positionsGet wallet positions
get_claimableGet claimable winnings/refunds
validate_market_paramsValidate against v6.3 rules
validate_betValidate bet parameters

Resolution Status (4 tools)

ToolDescription
simulate_transactionPre-sign simulation check
get_resolution_statusMarket resolution state
get_disputed_marketsList disputed markets
get_markets_awaiting_resolutionPending resolution markets

Example Usage

List active Lab markets

{
  "name": "list_markets",
  "arguments": {
    "layer": "Lab",
    "status": "Active"
  }
}

Get a bet quote

{
  "name": "get_quote",
  "arguments": {
    "market": "E71aYMXbzoC7nBeQFjMpZCiLKKNb7bqjYrXR3TnFjmQ",
    "side": "Yes",
    "amount": 1.0
  }
}

Build a bet transaction

{
  "name": "build_bet_transaction",
  "arguments": {
    "market": "E71aYMXbzoC7nBeQFjMpZCiLKKNb7bqjYrXR3TnFjmQ",
    "outcome": "yes",
    "amount_sol": 1.0,
    "user_wallet": "9rbVMeTHKpdWwTnjXZRp62RKuTKCsKBKNMtoLZ67PPVr",
    "affiliate_code": "CLAUDE"
  }
}

More examples →

Oracle & Resolution Transparency

All markets are resolved by Grandma Mei, Baozi's AI oracle, with verifiable proof for every resolution.

LayerResolution AuthorityWho Can Resolve
OfficialAdmin or Grandma Mei oracleAdmin / Oracle only
LabGrandma Mei oracle ONLYOracle or Admin only (creators cannot resolve)
PrivateCreator or Grandma Mei oracleCreator / Oracle

Resolution Proofs: Every resolution includes verifiable evidence (data sources, screenshots, reasoning). Browse all proofs at baozi.bet/agents/proof.

Dispute Window: 6-hour challenge period before resolution is finalized. Any bettor can flag a dispute.

Technical Details

ParameterValue
NetworkSolana Mainnet
Program IDFWyTPzm5cfJwRKzfkscxozatSxF6Qu78JQovQUwKPruJ
IDL Versionbaozi_markets_v4_7_6
Betting ModelPari-mutuel
Min Bet0.01 SOL
Max Bet100 SOL

Fee Structure

LayerPlatform FeeCreation FeeCreator Max
Official2.5%0.01 SOL-
Lab3.0%0.01 SOL2.0%
Private2.0%0.01 SOL1.0%

Fees apply to gross winnings (stake + profit). Fee split: 1% affiliate, up to 2% creator, remainder to protocol ($BAOZI stakers).

Market Creation Rules

Golden Rule: Bettors must have NO information advantage while betting is open.

  • Event-based (game, award): Close betting 24 hours before the event
  • Measurement period (weekly chart, monthly stats): Close betting before the period starts
  • All markets require an objective outcome, specified data source, and UTC timestamp

See

View source on GitHub