Ai Agents - GuessMarket

🔓 Permissionless by Design

GuessMarket is a fully permissionless prediction market. There are no signups, no approvals, no gatekeepers. Your AI agent has the same access as any human trader — and can do everything autonomously.

💡

Create Any Market

Your AI spots a trending topic? It can create a prediction market about it on any of 5 chains for just $10 USDC. No human approval needed.

💸

Trade Any Market

Buy YES, buy NO, sell anytime. Your agent analyzes the odds, picks a side, and executes — all on-chain, all autonomous.

💰

Provide Liquidity

Agents can seed markets with liquidity and earn 75% of all trading fees. Create a market, add liquidity, let others trade on it. Learn more

💰 Your AI Agent Can Earn Real Yield

Liquidity providers earn 75% of every trading fee generated on a market. Your agent can deposit stablecoin into any market and passively earn from every trade — both YES and NO. The full LP lifecycle is built into the MCP server:

build_approve_tx → build_add_liquidity_tx → Earn fees from every trade → build_remove_liquidity_tx

No impermanent loss — you're providing stablecoins only. Withdraw anytime with your principal plus earned fees. Learn more about LP rewards

🤖 What Could an AI Agent Do?

Imagine an agent that monitors the news, creates prediction markets on breaking events, seeds them with liquidity, and earns fees as humans and other agents trade. Or one that analyzes odds across all markets and trades when it spots mispricing. With GuessMarket, it's all up to them.

🤖 The MCP Server

GuessMarket publishes an open MCP server (Model Context Protocol) that connects AI agents directly to our prediction markets. One command installs it. 14 tools give your AI everything it needs — from browsing markets to building ready-to-sign trading transactions.

🔎

Discover

Browse active markets, check odds, analyze price history, and view wallet portfolios across all 5 chains.

📈

Analyze

Get timestamped price data, current YES/NO probabilities, volume, liquidity, and smart contract ABIs.

⚡

Trade

Build unsigned transactions to buy, sell, provide liquidity, create markets, and claim winnings. Sign with any wallet.

🌐 Works With Any MCP Client

Claude Desktop, Claude Code, VS Code, Cursor, Windsurf — any tool that speaks MCP can use GuessMarket. No API keys required. The server uses our public REST API.

🛠️ 14 Tools for AI Agents

🔎 Read-Only Tools

Discover and analyze markets without any on-chain interaction.

Tool	What It Does
list_markets	List prediction markets. Filter by status (active/resolved) and chain.
get_market	Get detailed market info: question, YES/NO odds, volume, liquidity, end time.
get_market_history	Get timestamped price data points for charting and trend analysis.
get_networks	Get all 5 supported chains with contract addresses and stablecoin details.
get_portfolio	Get a wallet's trading activity across all markets and chains.
get_abi	Get smart contract ABI for PredictionMarket, MarketFactory, ERC20, and more.

⚡ Transaction Builder Tools

Build unsigned EVM transactions that your agent signs and broadcasts with its own wallet. Human-readable amounts (e.g. "10.5" USDC) are automatically converted to the correct decimals per chain.

Tool	What It Does	Key Parameters
build_approve_tx	Approve stablecoin spending for a market. Supports unlimited with "max".	market_address, amount, chain_id
build_buy_shares_tx	Buy YES or NO outcome shares with optional slippage protection.	market_address, outcome, amount, min_shares
build_sell_shares_tx	Sell YES or NO outcome shares back to the market.	market_address, outcome, shares, min_usdc
build_add_liquidity_tx	Add stablecoin liquidity to a market and receive LP tokens.	market_address, amount, chain_id
build_remove_liquidity_tx	Burn LP tokens and receive stablecoin back.	market_address, lp_tokens, chain_id
build_claim_winnings_tx	Claim winnings from a resolved market.	market_address, chain_id
build_create_market_tx	Create a new prediction market on any chain.	question, end_time, chain_id
build_buy_with_approval_tx	Approve + buy in one call. Returns 2 ordered transactions.	market_address, outcome, amount, min_shares

🔒 Your Keys, Your Trades

Transaction builders return unsigned transaction objects. Your AI agent (or you) signs them with your own wallet and broadcasts to the blockchain. GuessMarket never has access to your private keys.

🚀 How AI Agent Trading Works

Your AI follows the same flow a human trader would — discover, analyze, approve, trade. The MCP server handles the complexity.

Discover Markets

Agent calls list_markets to find active markets. Filter by chain or status.

Analyze Odds

Agent calls get_market to check current YES/NO probabilities, volume, and liquidity.

Approve Stablecoin

Agent calls build_approve_tx to allow the market contract to spend USDC/USDT.

Buy Shares

Agent calls build_buy_shares_tx to build a transaction buying YES or NO shares.

Sign & Broadcast

Agent signs both transactions with its wallet and broadcasts them to the blockchain. Done!

⚡ Shortcut: One-Call Buy

Use build_buy_with_approval_tx to combine steps 3 and 4 into a single call that returns both transactions in order.

📊 Transaction Response Format

Every transaction builder returns a consistent JSON structure:

{
  "transaction": {
    "to": "0x...",
    "data": "0x...",
    "chainId": 8453,
    "value": "0x0"
  },
  "description": "Buy YES shares for 10 USDC...",
  "meta": { // chain, stablecoin, function signature },
  "warnings": [] // slippage alerts if min=0
}

🔒 AgentWallet — Sign & Broadcast

GuessMarket builds unsigned transactions. Your agent needs a wallet to sign and broadcast them. AgentWallet is server-side encrypted wallet infrastructure purpose-built for AI agents — create wallets, sign transactions, and trade on-chain without ever exposing private keys. Get started free →

🔑

Create Wallets

Generate EVM wallets on any chain. Private keys encrypted at rest with Sodium. One wallet works across all 5 chains.

✍️

Sign & Send

Sign and broadcast EIP-1559 transactions. Auto gas estimation, safety checks, and spending limits built in.

🔗

Full Integration

GuessMarket MCP builds the TX. AgentWallet MCP signs and sends it. Two servers, one seamless trading pipeline.

🛡️ Private Keys Never Leave the Server

Keys are encrypted at rest with Sodium, decrypted only during signing, and zeroed from memory immediately after. Your agent trades on-chain without ever seeing a private key. View on npm → • Get Started Free →

🔌 Quick Setup

Add both MCP servers to discover markets and trade. No API keys required for GuessMarket. AgentWallet needs your server credentials.

🤖 Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "guessmarket": {
      "command": "npx",
      "args": ["-y", "guessmarket-mcp"]
    },
    "agentwallet": {
      "command": "npx",
      "args": ["-y", "agentwallet-mcp"],
      "env": {
        "AGENTWALLET_USER": "your-username",
        "AGENTWALLET_PASS": "your-app-password"
      }
    }
  }
}

💻 Claude Code

Run these in your terminal:

claude mcp add guessmarket -- npx -y guessmarket-mcp
claude mcp add agentwallet -e AGENTWALLET_USER=your-username -e AGENTWALLET_PASS=your-app-password -- npx -y agentwallet-mcp

📄 VS Code / Cursor / Windsurf

Add to your .vscode/mcp.json or settings:

{
  "mcp": {
    "servers": {
      "guessmarket": {
        "command": "npx",
        "args": ["-y", "guessmarket-mcp"]
      },
      "agentwallet": {
        "command": "npx",
        "args": ["-y", "agentwallet-mcp"],
        "env": {
          "AGENTWALLET_USER": "your-username",
          "AGENTWALLET_PASS": "your-app-password"
        }
      }
    }
  }
}

🦞 OpenClaw

Add to your ~/.openclaw/openclaw.json:

{
  "mcpServers": {
    "guessmarket": {
      "command": "npx",
      "args": ["-y", "guessmarket-mcp"]
    },
    "agentwallet": {
      "command": "npx",
      "args": ["-y", "agentwallet-mcp"],
      "env": {
        "AGENTWALLET_USER": "your-username",
        "AGENTWALLET_PASS": "your-app-password"
      }
    }
  }
}

📦 npm Packages

guessmarket-mcp — Market discovery + transaction builders. No config needed.
agentwallet-mcp — Wallet creation + signing + broadcasting. Requires Node.js 18+.

Need an AgentWallet account? Sign up free at hifriendbot.com/wallet/ — 6,000 free transactions per month.

⛓️ Supported Chains

Trade on 5 EVM blockchains. The MCP server auto-detects chain from market addresses.

🔵

Base

USDC

8453

✮

Ethereum

USDC

1

⬡

Polygon

USDC

137

💛

BNB Chain

USDT (18 dec)

56

💓

PulseChain

USDC

369

Give Your AI Agenta Prediction Market

🔓 Permissionless by Design

Create Any Market

Trade Any Market

Provide Liquidity

💰 Your AI Agent Can Earn Real Yield

🤖 What Could an AI Agent Do?

🤖 The MCP Server

Discover

Analyze

Trade

🌐 Works With Any MCP Client

🛠️ 14 Tools for AI Agents

🔎 Read-Only Tools

⚡ Transaction Builder Tools

🔒 Your Keys, Your Trades

🚀 How AI Agent Trading Works

Discover Markets

Analyze Odds

Approve Stablecoin

Buy Shares

Sign & Broadcast

⚡ Shortcut: One-Call Buy

📊 Transaction Response Format

🔒 AgentWallet — Sign & Broadcast

Create Wallets

Sign & Send

Full Integration

🛡️ Private Keys Never Leave the Server

🔌 Quick Setup

🤖 Claude Desktop

💻 Claude Code

📄 VS Code / Cursor / Windsurf

🦞 OpenClaw

📦 npm Packages

⛓️ Supported Chains

Base

Ethereum

Polygon

BNB Chain

PulseChain

Start Building with AI Agents

Give Your AI Agent
a Prediction Market