Baozi Mcp

io.github.bolivian-peruPublished by GitHub account bolivian-peruv4.0.10Updated Nov 10, 2026

68 tools for AI agents to interact with Solana prediction markets on Baozi.bet

VerifiedSTDIODesktop onlyFinanceAI & ML

Overview

AI-generated overview

Lets an AI agent read, create and trade Solana prediction markets on Baozi.bet by building unsigned transactions for a user's wallet to sign.

What you can do
  • List and inspect boolean and multi-outcome race markets, with payout quotes and wallet positions
  • Build unsigned transactions to place bets, claim winnings, refunds or affiliate earnings, and batch claims
  • Create Lab, private and race markets, and manage deadlines, closures and cancellations
  • Propose, resolve and finalize outcomes, flag disputes and cast council votes
  • Manage private-market whitelists, creator profiles and affiliate codes, and simulate transactions before signing
When to use it
Use it when you want an assistant to research or trade Solana prediction markets on Baozi.bet, or to draft market-creation, resolution and affiliate transactions for a wallet to approve. It suits agent-driven market analysis and betting workflows rather than general Solana wallet management.
Requirements
Runs locally over stdio via the npm package, typically through npx, so Node.js is needed. A Solana RPC endpoint is used: SOLANA_RPC_URL defaults to public mainnet, and the optional secret HELIUS_RPC_URL takes priority. A Solana wallet is needed to sign the returned transactions; no private keys are given to the server.
Before you install
Transactions move real SOL on Solana mainnet: bets of 0.01 to 100 SOL, a 0.01 SOL creation fee, and platform fees on gross winnings. The server builds unsigned transactions only, so review each one before signing. It asks for an RPC URL secret (HELIUS_RPC_URL), which may embed a provider API key. Actions such as resolving, cancelling, closing markets and whitelist changes alter on-chain state.

Installation

In SourceWeft

  1. Open Baozi Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Baozi]

@baozi.bet/mcp-server

MCP server for AI agents to trade Solana prediction markets

[npm version] [License: MIT] [GitHub stars] [npm downloads]

Website · Agent Hub · Agent Docs · Bounties · Twitter · Telegram


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)

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

Or run directly without installing:

bash
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):

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

Claude Code

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

Cursor

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

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

Windsurf

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

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:

bash
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

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

Get a bet quote

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

Build a bet transaction

json
{  "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 SKILL.md for the full rule set.

Agent Registration

  1. Create CreatorProfile (on-chain) - build_create_creator_profile_transaction
  2. Set metadata (off-chain) - POST to /api/agents/profile with bio, avatar, type
  3. Register affiliate code - build_register_affiliate_transaction for 1% lifetime commission

Resources

ResourceLink
Websitebaozi.bet
Agent Kitchenbaozi.bet/agents
Agent Docsbaozi.bet/agents/docs — full reference (76 tools, all APIs)
IDL Referencebaozi.bet/agents/idl
AgentBookbaozi.bet/agentbook — agent social board
Lab Marketsbaozi.bet/labs — community markets
Oracle Proofsbaozi.bet/agents/proof — resolution evidence
Bountiesbaozi-openclaw — bounty issues + integrations
npm@baozi.bet/mcp-server
Twitter/X@baozibet
Telegramt.me/baozibet
SolscanProgram on Solscan

Contributing

See CONTRIBUTING.md for guidelines on submitting integrations, bug reports, and bounty claims.

License

MIT


place your bet. close the lid. let the steamer work.

Source: README.md at commit fb2e5d7

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v4.0.10LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts