Hunch, native in your agent.

What you can do

Just ask. The tools do the rest.

Talk to your agent in plain language — it picks the right Hunch tools, fills the arguments, and shows its work.

Install

Connect in one step.

Hunch is a remote streamable-HTTP MCP server at https://www.playhunch.xyz/api/mcp. Same 14 tools in every client.

claude mcp add --transport http hunch https://www.playhunch.xyz/api/mcp

https://www.playhunch.xyz/api/mcp

{
  "mcpServers": {
    "hunch": { "url": "https://www.playhunch.xyz/api/mcp" }
  }
}

[mcp_servers.hunch]
command = "npx"
args = ["-y", "mcp-remote", "https://www.playhunch.xyz/api/mcp"]

The toolbox

14 tools, one money path.

Every tool is a thin adapter over the audited REST route shown beside it — so the MCP surface and the HTTP API can never disagree. Only one tool moves money, and it defaults to a $0 simulation.

• list_markets

  List open Hunch prediction markets with live odds; filter by status, type, or token.

  GET /api/agent/v1/markets

• discover_markets

  Search markets by free text, or rank the best matches for a raw social post.

  GET /api/agent/v1/discover

• get_market

  Fetch one market's full reference: question, odds, outcomes, deadline, fee, links.

  GET /api/agent/v1/markets/{id}

• research_market

  Pull decision-grade research for one market: resolution rules, odds history, observations, price impact, related markets.

  GET /api/agent/v1/markets/{id}/research

• token_sentiment

  Read the Hunch crowd-conviction signal for a token: a pool-weighted sentiment score (0-100) over every live market about it, the single bet it points to, and how concentrated the conviction is.

  GET /api/agent/v1/sentiment

• quote_bet

  Price a bet before placing it: tier, price, estimated shares, fee breakdown, and a 60-second quoteId.

  GET /api/agent/v1/quote

• place_betMoney · simulate default

  MONEY-MOVING TOOL. Places a real USDC bet on Base via x402 — defaults to simulate mode (a $0 dry-run of the full validation pipeline) unless explicitly told otherwise. $1 floor, no maximum.

  POST /api/agent/v1/trade

• list_positions

  List a wallet's open and resolved positions with live PnL.

  GET /api/agent/v1/positions

• get_result

  Read a market's resolution status, winning outcome, and payout-per-share.

  GET /api/agent/v1/result

• get_proof

  Fetch the durable on-chain settlement proof for a trade (Base tx hash + explorer link).

  GET /api/agent/v1/proof/{tradeId}

• check_wallet

  Check a wallet's readiness to bet: Base USDC balance, minimum-bet coverage, funding guidance.

  GET /api/agent/v1/wallet/{address}/readiness

• register_webhook

  Register a wallet-signed webhook URL for resolution and payout events (HMAC-signed deliveries).

  POST /api/agent/v1/webhooks

• watch_wallet_events

  Stream a wallet's events over SSE (bounded windows; reconnect with Last-Event-ID).

  GET /api/agent/v1/events

• poll_events

  Poll resolved and payout events for a wallet since a timestamp or sequence number — no webhook needed.

  GET /api/agent/v1/resolved

End to end

“Bet $5 that $BNKR hits $60M.”

One sentence to your agent unfolds into this sequence of tool calls — the same discover → research → simulate → settle → watch loop the SDK and the REST API run.

1. 1

   discover_markets({ q: "$BNKR $60M" })

   → bnkr-60m-mcap-2026-06-30 · “Will $BNKR reach a $60M market cap?”

2. 2

   research_market({ id })

   → YES 42¢ / NO 58¢ · target $60M · mcap $50.1M (+19.8% to go) · DexScreener-resolved

3. 3

   place_bet({ id, side: "yes", sizeUsd: 5, simulate: true })

   → 11.9 shares @ 42¢ · simulated, $0 moved, request shape proven

4. 4

   place_bet({ id, side: "yes", sizeUsd: 5 })

   → x402 challenge → wallet signs EIP-3009 → ✅ settled on Base · txHash + proofUrl

5. 5

   watch_wallet_events({ wallet })

   → on resolution: market.resolved → payout.paid → USDC pushed to the wallet

Safety

• place_bet defaults to simulate. A $0 dry-run runs the full validation pipeline; your agent has to explicitly pass simulate:false to move real USDC.
• Reads are keyless. Discovery, research, quotes, positions, and proofs need no wallet and no signup — the only credential is the x402 payment for your own bet.
• Funding is USDC on Base only. Transfers are relayed, so the wallet never needs ETH for gas. Winners are paid automatically on resolution; there is no claim step.
• Prediction markets carry risk. Only stake what your agent can afford to lose; not available where prohibited.