New:Introducing Socket Scanning for VS Code Marketplace Extensions.Learn more →
Get Started

prediction-bot-mcp

Package Overview
Dependencies
Maintainers
1
Versions
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

prediction-bot-mcp

MCP server for Polymarket/Kalshi X-sentiment scores, paid per call in USDC on Base via x402

pipPyPI
Version
0.2.0
Weekly downloads
211
Maintainers
1
Created

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.

ToolPriceWhat it returns
get_daily_scoresfreeToday's X-sentiment score for each market we track, with the change since yesterday
get_catalog, get_pricing, get_sample, get_healthfreeRoutes, prices, example output, status
get_top_markets$0.35The 3 most-discussed markets on X right now, each scored
get_sentiment_shift(q)$0.35Change in sentiment since the previous score
get_market_sentiment(q)$0.35Fresh score -100..100, catalyst and volume trend for any market question
get_market_brief(q)$0.35Score, 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):

https://prediction-bot-iggf.onrender.com/mcp

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

{
  "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:

{
  "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 varDefaultPurpose
PREDICTION_BOT_API_BASEhttps://prediction-bot-iggf.onrender.comAPI base URL
PREDICTION_BOT_EVM_PRIVATE_KEYunsetEnables auto-pay
PREDICTION_BOT_MAX_USD_PER_CALL0.50Hard cap per paid call
PREDICTION_BOT_SESSION_BUDGET_USD1.00Cap 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

Keywords

agent

FAQs

Related posts