Repository avatar
AI Tools
v0.2.0
active

prediction-bot

io.github.wballztrading1/prediction-bot

Polymarket & Kalshi sentiment from X (Twitter) via Grok. Free daily scores; live scoring via x402.

Documentation

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

RoutePriceNotes
GET /scoresfreeLatest daily X-sentiment score for each tracked market
GET /, /health, /sample, /catalog, /pricingfreeDiscovery / probe
GET /top$0.35Top 3 markets by X buzz
GET /shift?q=$0.35Change since the previous score
GET /sentiment?q=$0.35Fresh Grok X-sentiment score (-100..100) for any question
GET /brief?q=$0.35Score + shift + summary + live Polymarket/Kalshi odds

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.

PYPI
prediction-bot-mcp
Install Command
pip install prediction-bot-mcp