Bopster MCP
Pins market question metadata to IPFS when preparing a Bopster market, making the metadata available for the Reality.eth question.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bopster MCP show me the most active prediction markets on Bopster"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bopster MCP
MCP server for Bopster prediction markets on Base. AI agents use it to read markets and prepare transactions. It never holds keys or sends anything.
Public server: https://mcp.bopster.fun/mcp
What it does
Bopster is a prediction market on Base. People take YES or NO positions in USDC on a question and the winning side splits the pool. This server exposes it to any Model Context Protocol client (Claude, Cursor and others).
Read tools call the public Bopster API (
https://api.bopster.fun) and the Bopster contracts on Base.The
prepare_*tools return unsigned transactions. The agent's own wallet signs and sends them.No keys, no custody, no stored sessions. It doesn't answer Reality.eth questions or arbitrate either.
To sign from a terminal, use bopster-cli. It checks every transaction against the chain before signing it, so you don't have to trust this server.
Contracts: bopster-market-contract.
Related MCP server: Polymarket MCP Server
Connect
Remote, the public server:
{
"mcpServers": {
"bopster": { "url": "https://mcp.bopster.fun/mcp" }
}
}In Claude, add the same URL as a custom connector.
Local, over stdio (after pnpm build):
{
"mcpServers": {
"bopster": {
"command": "node",
"args": ["/absolute/path/to/bopster-mcp/dist/bin/stdio.js"],
"env": {
"BOPSTER_RPC_URL": "https://mainnet.base.org",
"BOPSTER_FACTORY_ADDRESS": "0x11a2a549286567f7427d990423e5a3560ea16750",
"BOPSTER_REALITY_ARBITRATOR": "0xcB4B48d2A7a44247A00048963F169d2b4Ab045a6"
}
}
}
}Tools
Tool | What it does |
| Search and list markets: status, category, text, sorting, pagination. |
| One market by address: pools, phase, oracle, and a wallet's position if you pass one. |
| Top creators, predictors or oracles for a period. |
| Your own positions, payouts and refunds. Needs a login: |
| Public profile and activity, by wallet or alias. |
| Creator profile: alias, avatar, verified badge, stats. |
| Protocol, creator and resolver fees, read from the factory contract. |
| Checks that the backend is up. |
| What a YES/NO position would pay if its side wins, with the pools as they are now. |
| Approval for exactly the stake, then |
| What a wallet can take out of a market and the transactions to do it, in order: |
| Whether a market can be settled now, the transaction, and the resolver reward for whoever sends it. Covers the emergency refund. |
| Asks the backend to re-read a market after a transaction confirms, so the site shows it straight away. |
| One-time message for the wallet to sign (EIP-191). Step 1 of creating a market, and what |
| Step 2: builds the question from one of the site's five templates, checks every rule, pins the metadata and returns the Reality.eth |
| Step 3: checks the confirmed question is the drafted one and returns |
| Step 4: reads the new market from the receipt, returns its link and tells the backend. |
Amounts from the API are USDC base units (6 decimals). list_markets adds *_formatted and
*_iso fields. The quote_ and prepare_ tools take whole units: "5" is 5 USDC.
Creating a market
Same steps as on the site. Each call returns the arguments for the next one in next.
get_login_message → sign → prepare_market_question → send askQuestion
→ prepare_market_launch → send createMarket → register_marketTemplates only. Agents can't write a free-text question. They pick one of the five templates (
price_threshold,event_outcome,before_date,price_change,compare_assets) and fill in its fields. The question is worded exactly as on bopster.fun.Checked before anything is signed. Template fields, a title of 2 to 120 bytes, a public
source_url, a close on a whole minute between 20 minutes and 10 days away, and one of the site's resolution delays. A Sports match closes at kick-off and the sport sets the delay.Only its own drafts.
prepare_market_questionsigns the draft (HMAC withBOPSTER_DRAFT_SECRET) andprepare_market_launchrefuses anything it didn't sign, or a Reality.eth question with different text. The contracts are permissionless, so anyone calling them directly can still make a free-text market. The backend scores thoselow_trust.No early answers. The question opens for answers at the resolve time.
The backend only marks a market high_trust when:
the params pass the template rules and
metadata.questionis the canonical text;deadlineUtcequals the market'sresolveTime;the Reality.eth question, read from the contract, has the same text, template 0, Bopster's arbitrator and answer window, and opens at
resolveTime.
The backend publishes its template rules at GET /market-templates. This server checks its arbitrator and answer window against them before
preparing a market, test/templateContract.test.ts holds the templates to a saved copy, and
pnpm check:templates compares that copy with a live backend.
Safety
Only Bopster markets. Every market is checked against the factory's registry (
allMarkets) before anything is built, so a look-alike contract can't get an approval.Exact approvals.
prepare_positionalways approves exactly the stake, never more, and the position spends all of it. It doesn't skip the approval based on an allowance read: behind a load-balanced RPC that read can be stale.Gas limits included. Each transaction comes with
gas, about twice what it used in tests. An estimate made right after the previous transaction can hit a node that hasn't seen it yet. Only the gas used is charged.Chain time. Open, closed and ready are decided with the block timestamp, like the contract.
Login limit. Each client gets 3 login messages a minute, keyed by the address nginx sets in
CF-Connecting-IP(thenX-Real-IP). A login can pin metadata to IPFS before any transaction, and wallets are free.Same rules as the contract. Payouts, fees and the settle/claim/refund order follow the
BopsterMarketsource verified on Base mainnet.
Development
Requires Node.js 22+ and pnpm.
pnpm install
pnpm build
pnpm testRun it:
cp .env.example .env # the scripts below read it
pnpm start:stdio # stdio, for local MCP clients
pnpm start # HTTP on port 8788, all interfaces: http://127.0.0.1:8788/mcp
node scripts/smoke.mjs
pnpm inspector # MCP Inspector, then point it at node dist/bin/stdio.jsFork tests
Both suites run on an anvil fork of Base mainnet, start their own server against it and only
send transactions the tools prepared. Market creation uses a local stand-in for the backend that
checks login signatures like the real one. CI runs them in the e2e job (set the BASE_RPC_URL
repository variable for a dedicated RPC). Start the fork right before running them: public RPCs
stop serving a fork's block after a few minutes.
anvil --fork-url <Base mainnet RPC> --port 8545
pnpm build && pnpm test:e2eConfiguration
Variable | Default | |
|
| Bopster API. |
| none | Only for the official server. Sent as |
|
| Timeout for backend requests. |
|
| HTTP port. |
|
|
|
|
| Base RPC. The public one rate-limits bursts, so use a dedicated one in production. It must return transaction receipts (publicnode's free tier doesn't). Checked at startup and shown on |
| none | BopsterFactory. The |
| none | Arbitrator for new questions. Empty turns market creation off. Mainnet: |
|
| Answer window for new questions (12 h, as on the site). |
|
| Bounty sent with new questions. |
|
| Where market links point. |
| random | Signs market drafts between steps 2 and 3. Set it (32+ bytes) so drafts survive a restart. |
Self-hosting
Docker image behind nginx: see DEPLOYMENT.md.
License
Available Tools
17 toolsget_creator_profileGet a Bopster creator profileA
Fetch a public creator profile on Bopster: alias, avatar, verified badge and creator stats. Accepts either a wallet address or an alias.
Inputs: handle (required).
get_feesGet Bopster market feesA
Return the Bopster market fee split (protocol, creator and resolver) as read live from the BopsterFactory contract on Base. Percentages are of the total market pool. No fees are charged when a market refunds (no positions, or nobody on the winning side).
Inputs: no named parameters.
get_leaderboardGet a Bopster leaderboardA
Return a ranked leaderboard of Bopster participants (top market creators, predictors, i.e. position takers, or oracle answerers) over a given time period, with pagination.
Inputs: type (required), page, limit, period.
get_login_messageGet a Bopster login messageA
Step 1 of creating a Bopster market, and what get_portfolio needs. Returns a one-time message for the wallet to sign with personal_sign (EIP-191). The signature opens a short session with the Bopster backend, used only for the one request that needs it: pinning a new market's metadata to IPFS, or reading this wallet's own portfolio. It can't move funds or sign transactions. Each client gets 3 a minute: ask for one only when you're about to sign it.
Inputs: wallet (required).
get_marketGet a Bopster marketA
Fetch the full detail of a single Bopster prediction market by its on-chain address: question, category, source, YES/NO pools, market phase, oracle state and (optionally) a given wallet’s positions. Amounts are USDC base units (6 decimals); times are unix seconds (UTC).
Inputs: address (required), user_address.
get_portfolioGet a wallet portfolioA
Fetch the Bopster portfolio of a wallet you control: its open positions across markets, claimable rewards and refunds. Amounts are USDC base units (6 decimals). The backend shows a portfolio only to its own wallet, so this needs a login: call get_login_message for the wallet, sign the message with personal_sign, then pass wallet, nonce and signature here. Each signature works once. The session can't move funds and isn't kept.
Inputs: nonce (required), wallet (required), signature (required).
get_user_profileGet a Bopster user profileB
Fetch a public Bopster user profile plus aggregate activity (as creator, predictor and oracle participant). Accepts either a wallet address or an alias.
Inputs: handle (required).
list_marketsList Bopster marketsA
Search and list prediction markets on Bopster (a non-custodial prediction market on Base). Supports filtering by status, category and text, plus sorting and pagination. Returns each market with YES/NO pools, total volume and end/resolve times, and a pagination block (page, size, total, pages). Amounts are USDC (6 decimals); *_formatted and *_iso fields are added for readability.
Inputs: page, size, title, status, +5 more.
ping_healthCheck Bopster backend healthA
Verify that the Bopster read API is reachable and responding. Useful before running other tools.
Inputs: no named parameters.
prepare_claimPrepare a Bopster claimA
Work out what a wallet can take out of a Bopster market on Base and build the unsigned transactions to do it, in order: settling the market first when it's ready but nobody has (finalize, or the emergency refund path), then claim() or claimRefund(). Says why when there's nothing to claim. Non-custodial: this server never holds keys or sends anything.
Inputs: market (required), wallet (required).
prepare_finalizePrepare to settle a Bopster marketA
Check whether a Bopster market on Base can be settled now and build the unsigned transaction(s) to do it. Anyone can settle a market once its Reality.eth answer is final; the sender earns the resolver reward when the market has winners. Also covers the emergency refund path for markets whose answer never became final. Non-custodial: this server never holds keys or sends anything.
Inputs: market (required).
prepare_market_launchPrepare a Bopster market launchA
Step 3 of creating a Bopster market. Only launches drafts prepare_market_question built: pass its next.arguments unchanged, plus the question tx hash. Reads the confirmed askQuestion transaction, checks it is exactly the drafted question (same text, asker, arbitrator, answer window and opening time), and returns the unsigned createMarket transaction. Non-custodial: nothing is signed or sent here.
Inputs: wallet (required), end_time (required), question (required), draft_token (required), +3 more.
prepare_market_questionPrepare a Bopster market questionA
Step 2 of creating a Bopster market. The question is built from one of the five Bopster templates (price threshold, event outcome, before a date, price change, compare assets), worded exactly as bopster.fun words it; free-text questions are not accepted. Checks the market against every rule the site, the backend and the factory enforce, pins its metadata to IPFS, and returns the unsigned Reality.eth askQuestion transaction. Non-custodial: nothing is signed or sent here.
Inputs: nonce (required), title (required), wallet (required), category (required), +8 more.
prepare_positionPrepare a Bopster positionA
Build the unsigned transactions to take a YES or NO position on a Bopster market on Base: an exact-amount token approval, then the position. Checks the market is open, is a real Bopster market and that the wallet holds enough. Non-custodial: this server never holds keys or sends anything; the agent's wallet signs and sends the transactions in order.
Inputs: side (required), amount (required), market (required), wallet (required).
quote_positionQuote a Bopster positionA
Estimate what a YES or NO position of a given size would pay on a Bopster market if its side wins, read from the market contract on Base. Read-only: builds no transaction. Payouts are parimutuel, so the estimate moves with every later position.
Inputs: side (required), amount (required), market (required).
register_marketRegister a new Bopster marketA
Step 4 of creating a Bopster market. Reads the confirmed createMarket transaction, returns the new market and its link, and tells the Bopster backend so it shows up on the site right away. The backend re-reads the market from the chain itself, and its indexer would find it anyway; this only saves the wait.
Inputs: tx_hash (required).
sync_marketSync a Bopster marketA
Ask the Bopster backend to re-read a market from the chain after a transaction confirms, so the site and the other tools show it right away instead of after the next indexer pass. Changes nothing on-chain and moves no funds; the chain stays the source of truth either way.
Inputs: market (required), tx_hash (required), wallet.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Most tools have clearly distinct purposes, but a few boundaries require reading descriptions: get_user_profile vs get_creator_profile overlap as public profile lookups, and prepare_claim vs prepare_finalize both touch settlement. sync_market and register_market also overlap in refreshing backend state, though the step-wise creation tools are otherwise well separated.
All tool names use snake_case with a consistent verb_noun pattern, such as get_market, list_markets, prepare_position, and prepare_market_launch. Prefixes like get_, prepare_, and list_ are applied predictably across the set.
Seventeen tools is slightly above the ideal compact range, but each maps to a distinct part of the prediction-market lifecycle or a distinct read operation. There is little obvious redundancy, though the surface is heavier than a minimal server would need.
The set covers discovery, market detail, quoting, position preparation, claim/finalize flows, the multi-step market creation pipeline, profiles, leaderboard, portfolio, fees, and health checks. Minor gaps remain around generic transaction-status inspection and possible market edge-case operations, but core workflows are well covered.
Related MCP Connectors
AI-agent token launchpad on Base: quotes, tokens and unsigned launch/buy/sell/claim/vote txs.
Prediction-market quotes, fill estimates and odds trends, paid per call with x402 USDC on Base.
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI agents to discover and analyze prediction markets, execute trades, and manage positions on Polymarket via the Model Context Protocol.7106 npm20MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Polymarket prediction markets, including retrieving market data, user positions, and trading history.821 npm12Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to trade on Limitless prediction markets on Base via MCP, with tools for wallet management, market discovery, order placement, and portfolio tracking.PolyForm Noncommercial 1.0.0
- AlicenseBqualityDmaintenanceEnables AI agents to trade Solana prediction markets, including market creation, betting, claims, and affiliate management, all without exposing private keys.7696 npm1MIT