Prediction Market X Sentiment README

Prediction Market X Sentiment (x402)

Agent-native Polymarket/Kalshi sentiment from live X chatter. Settles in USDC on Base via HTTP 402.

Live: https://prediction-bot-iggf.onrender.com · About · llms.txt · API docs

Price ladder

Current prices are always at /pricing.

Quick probe

curl -s https://prediction-bot-iggf.onrender.com/health
curl -s https://prediction-bot-iggf.onrender.com/catalog
curl -s https://prediction-bot-iggf.onrender.com/pricing
python demo/pay_once.py   # shows free routes + unpaid 402

For agents: MCP server

Add prediction-market sentiment to any MCP client (Claude, Cursor, VS Code and others). Free tools, including today's scores, work without a wallet; paid tools settle in USDC on Base via x402.

Hosted, nothing to install: add https://prediction-bot-iggf.onrender.com/mcp as a remote (streamable HTTP) MCP server.

Local, with optional auto-pay from your own wallet (per-call and per-session spend caps):

{
  "mcpServers": {
    "prediction-bot": {
      "command": "uvx",
      "args": ["prediction-bot-mcp"]
    }
  }
}

Details, wallet setup and caps: mcp_server/README.md.

Env (Render)

• XAI_API_KEY — required
• PAY_TO_ADDRESS — USDC receive address on Base
• PRICE_LITE — default $0.01 (applied to /top, /shift)
• PRICE_BRIEF / PRICE — default $0.05 (applied to /sentiment, /brief)
• PUBLIC_BASE_URL — public service URL for catalog links
• Optional caps: GROK_COST_USD, CALLER_CAP_USD, CALLER_GROK_PER_HOUR, GLOBAL_GROK_PER_HOUR

Tests

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
TEST_MODE=1 pytest -q

Nothing ships without a green test run.