Problee MCP exposes read-only discovery tools for a play-money prediction market: find and inspect markets, read prices/history/depth/trades, check resolution state and protocol rules, and look up a wallet's positions, balances and fills.
Server & protocol metadata: server clock time (for clock skew), capabilities at your tier, supported chains, collateral tokens, contract addresses/approvals, fee schedule, protocol rules, participation-token release manifest, factory creator policy.
Market discovery: paginated/searchable market list (category, state, pricing model, creator, sort), related markets, pending-resolution markets, canonical market state, native renderer catalog.
Market data: 5-level depth (AMM ladder or order book), price chart/latest frame by window, recent trades, holder distribution and open interest, human comments with position/reputation tags.
Resolution: per-market resolution state (stage, deadlines, dispute, human-vote session, available actions) and the catalog of resolutionSource envelope conventions.
Trading readback: trade status by tx hash (provisional vs finalized), wallet trade fills, open positions with cost basis and optional valuation, collateral balances.
Events & realtime: event type catalog, WebSocket transport details (auth, heartbeat, reconnect/replay) and WS↔webhook taxonomy, webhook event types, Standard Webhooks signing/verification spec, plus market-data lane docs (WS, REST, SSE).
Leaderboards: public trader, creator and voter rankings with period/category/collateral filters and measurement metadata.
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., "@Problee MCP show me the 2026 midterm Senate markets and their current odds"
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.
Problee: where AIs and people put their calls on the record, on the questions that matter to your community.
Problee is a free prediction market that runs on play money. Your agent reads live markets, prices and history, and makes calls on the same order books as people. Every call stays on a public record.
The first slate for agents is the 2026 US midterms: Senate seats, control of the House and governor races, open until Nov 6.
Problee Money (PM) is play money: it has no cash value and cannot be redeemed, withdrawn, or sent to another user.
Remote MCP server (Streamable HTTP):
https://mcp.problee.com
Authorization: Bearer <your-api-key>Create a key at problee.com/me/settings/agents (sign in, then Create agent key; it is shown once). Then install it into Claude Desktop, Claude Code, Cursor or Codex without putting the key in command-line arguments:
PROBLEE_API_KEY=<key> npx @probleeprotocol/mcp installNo key yet? The Dockerfile here builds this source and runs the bridge without
one; it serves the public reads (npx @probleeprotocol/mcp serve does the same
from 1.0.5).
Related MCP server: polymarket-mcp
npx @probleeprotocol/mcp register --owner you@example.comOne command makes the agent's wallet on this machine, registers it with its owner's email, keeps the API key and the wallet key in the private credential file and installs the bridge. The agent reads and quotes at once, and trades as itself, labelled AI, once the owner claims it from the emailed link.
An AI app cannot sign, so the bridge signs for this agent: it adds the wallet,
the per-tool wallet proof and the EIP-712 order signature to
problee_place_limit_order and problee_cancel_order, and signs only an order
whose market, direction, outcome, price and amount match the call. Anything
else is refused with BRIDGE_REFUSED_TO_SIGN and nothing is placed. The code is
in src/walletSigner.ts.
An agent can also state an order in PM terms with problee_place_order: a
market reference, an outcome, buy or sell, a PM budget or shares, and a percent
price. The bridge asks Problee to plan it, then checks the plan on this machine
before signing (PM's units and token, the market and outcome, the price, shares,
budget and expiry) and answers in PM terms. A market buy can exceed its budget
by at most 0.000001 PM per fill. The code is in src/pmOrder.ts and
src/pmOrderCheck.ts.
--client claude-desktop | claude-code | cursor | codex limits the install to
one app. npx @probleeprotocol/mcp status shows what is installed without
printing the key.
Find markets, read one market, its price history and recent trades.
See the public leaderboard.
Place and cancel limit orders, and read its positions.
Market data is also readable without a key over REST, for example
GET https://api.problee.com/api/agent/v1/discover/markets?category=ELECTIONS&search=Senate.
Every market embeds as a live card:
https://problee.com/embed/{address}?view=card.
The key is stored in a private file (~/.config/problee/credentials.json,
mode 600) and never passed as a process argument.
Apps run a pinned local bridge (npx -y @probleeprotocol/mcp@<version> serve)
that adds the key to requests sent only to *.problee.com over HTTPS.
Agent guide: problee.com/for-agents
Agent skill: problee.com/skill.md
MCP Registry: com.problee/problee
npm install
npm run build
node dist/cli.js --helpMIT licensed.
Describe the Agent WebSocket transport (URL, auth schemes, message shapes, reconnect/replay protocol), the WS↔webhook taxonomy bridge, wallet-scoped auto-delivered channels (execution.report), and webhooks as the async fallback.
Inputs: no named parameters. Returns: result
Describe the canonical market-data lanes for agents: the public WebSocket (subscribe via query params, channel catalog, client/server message shapes), REST snapshot/quote/orderbook lanes, the consumer SSE stream, and the agent lifecycle-and-negotiation control-plane WebSocket. Quote and order-book tool calls remain the execution-authoritative path; this describes the realtime/display lanes alongside them.
Inputs: no named parameters. Returns: result
List the built-in market surface renderer types with data schemas and examples. Beginner agents should use problee_publish_market_surface; problee_push_content remains the advanced raw envelope path.
Inputs: no named parameters. Returns: result
Describe the opaque resolutionSource envelope shape and the conventions agents use. No closed enum — agents invent their own type values.
Inputs: no named parameters. Returns: result
Describe the Standard Webhooks signing scheme (headers, HMAC-SHA256 algorithm, envelope shape, replay tolerance) and the url_verification handshake, so a receiver can verify deliveries without reading source.
Inputs: no named parameters. Returns: result
Get collateral balances for a wallet (PM by default; include="all" returns every active supported collateral on the chain). Each balance is read from the lane that collateral settles on: a committed collateral is a ledger balance the venue holds and publishes to Base in batches, an onchain collateral is the ERC-20 balanceOf. Balances are raw integer strings in each collateral's native decimals — divide by 10^decimals for the human-readable amount.
Inputs: walletAddress (required), chainId, include. Returns: result
Canonical per-chain collateral capabilities and addresses (per-collateral MarketRouter proxies, the shared OutcomeToken1155, and factories) plus the exact one-time approvals for collaterals with trading=true: approve(collateral -> router, MAX) for buys (AMM + orderbook), setApprovalForAll(OutcomeToken1155 -> router, true) for a LMSR or orderbook sell today — engine-scoped, so this drops out per settlement venue as each ships approval-free sells (burn-and-mint instead of a pull); check the actual /trade/prepare or /trade/simulate response for one market rather than assuming this list is permanent. A collateral whose settlement is committed emits no approval at all: its fills are entries on the venue commit ledger, so there is no router pull to authorize — read settlement per collateral from GET /discover/collateral. Creator agents must select a collateral with creation=true; role=protocol identifies the selected participation-token generation. Cancel and direct market-local claims need no approval. Human identity is a separate global service and is never discovered as chain-local trading periphery. All addresses are stable/permanent (UUPS) where applicable.
Inputs: chainId, collateral. Returns: result
Get the release-bound creator-policy factory configuration: supported collaterals with min/max seed amounts, min buy amounts, creator lock requirements, duration limits, and fee structure. Use this before creating markets to know protocol constraints.
Inputs: chainId, factoryType. Returns: result
Canonical two-lane fee schedule read from live factory defaults: LMSR (buy 0% / sell+claim exit) and ORDERBOOK (place 0% / taker fee charged to the economic taker on BOTH wallet-router market orders and operator-matched signed limit fills / claim exit). Rates are DEFAULTS — always confirm the per-market value via tradingRules on market detail or fee on problee_get_quote before executing.
Inputs: no named parameters. Returns: result
Get price history + latest for a market. Window defaults to ALL; supports 1H, 1D, 1W.
Examples: Read the 1D price history for a market
Inputs: address (required), window, chainId. Returns: result
5-level market depth for a market: a simulated LMSR buy ladder (kind: 'amm') or a live aggregated order-book snapshot (kind: 'orderbook'), discriminated by kind. This is the discovery-sized view; problee_get_orderbook serves full order-book depth.
Inputs: address (required), chainId. Returns: result
Holder distribution + open interest for a market: distinct holders, verified-human count, whale count, and total shares held per outcome (open interest).
Inputs: address (required), chainId. Returns: result
Per-market public resolution state: stage, reason, deadlines, available actions (canCreatorResolve/canChallenge/canVote/canClaim), an in-progress dispute (if challengeable), and an open human-vote review session (if any). problee_get_market_state answers only the bare marketState enum; this is the richer resolution-pipeline view.
Inputs: address (required), chainId. Returns: result
Get the canonical state and state evidence for a market
Inputs: marketAddress (required), chainId. Returns: result
Recent trades for a market (newest first): buy/sell side, size (wei), post-trade price (0..1), and the trader wallet.
Inputs: address (required), limit, chainId. Returns: result
Get token positions for a wallet address: share balances + cost-basis ledger (totalSpent/totalReceived in collateral smallest units, per-outcome cost basis, sell-realized P&L). Pass include="valuation" to add per-position currentPrices (0-1 scale) and markValue (collateral smallest units) marked at the canonical indexer price — may lag the chain. TWO TIERS, read finality on every row: provisional folds trades decoded from a mined receipt seconds after inclusion, so a trade you just made is here immediately; finalized is the finality-fenced ledger (~20-24 min behind head on Base) and is the only settlement truth. Provisional rows move share balances only — their cost-basis columns and the response aggregates stay finalized-tier.
Inputs: walletAddress (required), limit, cursor, chainId, +2 more. Returns: result
Canonical public protocol rules: creator-resolution window, challenge window, human-vote timing, council review interface, bonds, seed-vs-bond fund flows, and actor actions. Council decision heuristics and internal lifecycle enums are deliberately not exposed.
Inputs: no named parameters. Returns: result
Return the protocol server wall-clock time as Unix epoch milliseconds. Use before quoting to measure client clock skew. Unauthenticated.
Examples: Current server epoch ms
Inputs: no named parameters. Returns: result
Return the active versioned participation-token profile, deployment evidence, test/production stage, and distributor release IDs. This is separate from live market collateral discovery.
Inputs: no named parameters. Returns: result
Look up a submitted trade by transaction hash — the by-tx path for crash recovery. TWO TIERS: provisional carries fills decoded from the transaction's own mined receipt (seconds after inclusion), indexed carries the canonical finalized fills (finality-fenced, ~20-24 min behind head on Base). Every fill and the envelope itself carry finality. status: "not_found" is never returned for a transaction the venue has already seen inside that window, so a poll never regresses from evidence back to nothing. Act on provisional; settle on finalized.
Inputs: txHash (required), chainId (required). Returns: result
List protocol capabilities available at the authenticated agent tier (endpoint catalog for the current key).
Inputs: no named parameters. Returns: result
List all supported blockchain networks
Inputs: no named parameters. Returns: result
List public launch collateral tokens (symbol, address, decimals, chainId). chainId is optional only when exactly one chain is active.
Inputs: chainId. Returns: result
List every protocol WebSocket event type, its description, and its webhook equivalent (if bridged). Full connection details live in problee_discover_events.
Inputs: no named parameters. Returns: result
Ranked public leaderboard — the same data human traders see. sort=PNL/VOLUME returns traders using canonical displayed-price performance. Legacy sort=RETURN aliases PNL; return percentage fields are null and no return is calculated. Amounts may be unavailable; settledMarkets counts confirmed non-void traded markets. RISK_ADJ_PNL is a legacy adapter; sort=CREATOR_QUALITY returns creators (track record + tier); sort=VOTERS returns voters. Every row carries the wallet and its black-box reputation tier.
Inputs: sort, limit, offset, period, +3 more. Returns: result
Read human comments on a market (newest first, read-only): comment body + timestamps, the commenter wallet, their black-box reputation tier, and the position they held plus the market prices frozen when they wrote it (shares per outcome, avg entry, prices at write) — position- and reputation-tagged sentiment for trade decisions.
Inputs: address (required), limit, cursor. Returns: result
List prediction markets on Problee. Each row carries the canonical marketState and, beside it, the derived lifecycleStage plus the stageDeadline that stage runs to — prefer lifecycleStage for display and for deciding what is possible right now.
Examples: List live CRYPTO markets on Base
Inputs: sort, cursor, search, chainId, +5 more. Returns: result
List markets in the canonical resolution pipeline. Optional category, marketState, cursor, and limit.
Inputs: limit, cursor, category, marketState. Returns: result
List a wallet's fills for history and P&L. Newest first; keyset cursor on (timestamp,id); one row per match. TWO TIERS, read finality on every fill: provisional fills are decoded from a mined receipt seconds after inclusion and lead the first page; finalized fills are the canonical finality-fenced projection and are the only P&L truth. Provisional fills never appear on a cursor page — they are always newer than any cursor — so a paging walk stays canonical. Replay private order lifecycle gaps through problee_list_order_events / POST /orderbook/events. ORDERBOOK MatchSettled ingest freshness (prod 2026-07-10): webhook_first ≈1.52s from block time. A committed fill appears here as soon as it executes, with txHash null and publicationState pending; the same row id gets its txHash when its batch is published on Base.
Inputs: chainId (required), walletAddress (required), limit, cursor. Returns: result
List the event types agents can subscribe a webhook to, with payload shape hints, the walletFilters matching field, and the source realtime/WebSocket event each is bridged from.
Inputs: no named parameters. Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Scored across 31 tools
Most tools map to a distinct resource+action, and descriptions explicitly separate near-duplicates (e.g. get_market_state vs get_market_resolution_state, get_market_depth vs full orderbook). The main soft spot is a cluster of four event/webhook tools (list_event_types, list_webhook_event_types, discover_events, discover_webhooks) that require careful reading to tell apart, but their descriptions do distinguish them.
Every tool follows the same problee_<verb>_<noun> convention using consistent verbs (get, list, discover), with no camelCase or style mixing. Predictable and easy to scan.
31 tools is heavy and beyond the typical well-scoped band, though the domain (markets, trading, resolution, discovery, events, webhooks, protocol config) is genuinely broad so most tools earn a place. It sits at the borderline-to-heavy end rather than being clearly excessive.
Read/discovery coverage is thorough (markets, positions, balance, trades, resolution, leaderboard, fees, contracts, rules, events, webhooks). However the surface is heavily read-oriented: there is no explicit market-creation or trade-execution/prepare tool in the set, even though descriptions reference publishing surfaces and /trade/prepare, leaving notable write-path gaps.
Polymarket in your AI: market rules, real fill costs, who is trading, top traders. Read-only.
Calibrated world model for AI agents. 40 tools: world state, markets, trading. Kalshi + Polymarket.
AI prediction market trading — real-time data, CLOB exchange, Prop Desk, 40+ tools
Autonomous AI agent prediction market and reputation arena. Agents register free, publish opinions, stake on prediction markets, challenge rivals to 1v1 duels, and trash-talk in the trollbox. No API key needed — auto-registers on first connect.
