Prediction Market X Sentiment

io.github.wballztrading1v0.2.0Updated Oct 4, 2026

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

VerifiedStreamable HTTPWeb executableFinance Data & Analytics Web Search & Scraping

Overview

AI-generated overview

Gives an assistant X (Twitter) sentiment scores for Polymarket and Kalshi prediction markets, with free daily scores and paid live scoring.

What it does: The server scores public X discussion about Polymarket and Kalshi markets with Grok, returning values from -100 to +100. Free tools return today's daily scores with the change since yesterday, plus catalog, pricing, sample output and health routes. Paid tools return the most-discussed markets, sentiment shifts, a fresh score with catalyst and volume trend for any market question, and a brief with live Polymarket and Kalshi odds.
When to use it: Use it when an assistant needs quick sentiment context on prediction markets, for example to compare crowd mood against current odds or to track how discussion around a market has shifted. Free daily scores are enough for casual checks; paid live scoring is for on-demand questions.
Requirements: Either add the hosted streamable HTTP endpoint, or run the PyPI package prediction-bot-mcp locally with uv. No account or API key is needed. Paid tools settle in USDC on Base via x402; auto-pay requires the PREDICTION_BOT_EVM_PRIVATE_KEY environment variable, and PREDICTION_BOT_MAX_USD_PER_CALL and PREDICTION_BOT_SESSION_BUDGET_USD set spending caps.

Before you install

Paid tools cost about $0.35 per call and prices can change. Auto-pay requires PREDICTION_BOT_EVM_PRIVATE_KEY, a Base wallet key that signs USDC payments; use a dedicated low-balance wallet and keep the per-call and per-session caps low. The hosted server never pays on your behalf and instead returns an x402 quote. Scores reflect public discussion, not forecasts, and are not financial advice.

Installation

In SourceWeft

Open Prediction Market X Sentiment in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "prediction-bot": {
      "type": "http",
      "url": "https://prediction-bot-iggf.onrender.com/mcp"
    }
  }
}

README

Prediction Market X Sentiment — MCP server

Gives any MCP-capable agent (Claude, Cursor, VS Code and others) sentiment for Polymarket and Kalshi markets from X (Twitter), scored by Grok. Free daily scores out of the box; paid live scoring on any question settles in USDC on Base via x402. No account, no API key.

Tool	Price	What it returns
`get_daily_scores`	free	Today's X-sentiment score for each market we track, with the change since yesterday
`get_catalog`, `get_pricing`, `get_sample`, `get_health`	free	Routes, prices, example output, status
`get_top_markets`	$0.35	The 3 most-discussed markets on X right now, each scored
`get_sentiment_shift(q)`	$0.35	Change in sentiment since the previous score
`get_market_sentiment(q)`	$0.35	Fresh score -100..100, catalyst and volume trend for any market question
`get_market_brief(q)`	$0.35	Score, change, one-line summary and live Polymarket + Kalshi odds

Prices can change; the free get_pricing tool always has the current ones.

Option 1: hosted, nothing to install

Add this URL as a remote MCP server (streamable HTTP):

For example, in a client that takes a JSON config:

json

{  "mcpServers": {    "prediction-bot": { "type": "http", "url": "https://prediction-bot-iggf.onrender.com/mcp" }  }}

{  "mcpServers": {    "prediction-bot": { "type": "http", "url": "https://prediction-bot-iggf.onrender.com/mcp" }  }}

Free tools work straight away. The hosted server never pays for anyone: paid tools return the x402 price quote (price, network, pay-to) so your own x402 client can pay, or use option 2.

Option 2: local, with optional auto-pay

Requires uv:

json

{  "mcpServers": {    "prediction-bot": {      "command": "uvx",      "args": ["prediction-bot-mcp"],      "env": {        "PREDICTION_BOT_EVM_PRIVATE_KEY": "<optional: your own Base wallet key>",        "PREDICTION_BOT_MAX_USD_PER_CALL": "0.50",        "PREDICTION_BOT_SESSION_BUDGET_USD": "1.00"      }    }  }}

{  "mcpServers": {    "prediction-bot": {      "command": "uvx",      "args": ["prediction-bot-mcp"],      "env": {        "PREDICTION_BOT_EVM_PRIVATE_KEY": "<optional: your own Base wallet key>",        "PREDICTION_BOT_MAX_USD_PER_CALL": "0.50",        "PREDICTION_BOT_SESSION_BUDGET_USD": "1.00"      }    }  }}

Without a wallet key, free tools work and paid tools return the x402 payment quote instead of paying.

With a wallet key, paid tools pay automatically. The server never pays more than PREDICTION_BOT_MAX_USD_PER_CALL per call or PREDICTION_BOT_SESSION_BUDGET_USD per session. Use a dedicated low-balance wallet. The key stays on your machine and is only used to sign USDC payments.

Env var	Default	Purpose
`PREDICTION_BOT_API_BASE`	`https://prediction-bot-iggf.onrender.com`	API base URL
`PREDICTION_BOT_EVM_PRIVATE_KEY`	unset	Enables auto-pay
`PREDICTION_BOT_MAX_USD_PER_CALL`	`0.50`	Hard cap per paid call
`PREDICTION_BOT_SESSION_BUDGET_USD`	`1.00`	Cap per server session

About the scores

Scores run from -100 (very bearish on the question) to +100 (very bullish), based on recent X posts about the market. They reflect public discussion, not a forecast, and are not financial advice.

Source: https://github.com/wballztrading1/Prediction-bot

Source: mcp_server/README.md at commit e5b0ab4

Tools

Tool metadata has not been indexed yet.

Version history

v0.2.0LatestOct 4, 2026