Skip to main content

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):

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 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

Metadata

Release files for prediction-bot-mcp 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for prediction-bot-mcp 0.2.0
File Size Uploaded
prediction_bot_mcp-0.2.0.tar.gz 7.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for prediction-bot-mcp 0.2.0
File Interpreter ABI Platform
prediction_bot_mcp-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 16.5 kB

Release files / prediction_bot_mcp-0.2.0.tar.gz

Download URL prediction_bot_mcp-0.2.0.tar.gz
Size 7.4 kB
Tags Source
SHA-256 checksum
How to use checksums
0b07d1260ec5427fa86ce87d1acc6acf56350b2ed69df50f110a346b0dfd7404
BLAKE2b-256 checksum
How to use checksums
2de684e0899fb0ad98b2e55457bcd5122c4233149cad132e3c0264fb94274a8a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.

Transparency log

Release files / prediction_bot_mcp-0.2.0-py3-none-any.whl

Download URL prediction_bot_mcp-0.2.0-py3-none-any.whl
Size 9.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8f91aae19419e37a18a9ee0ea9a68e0bfb5e69e56154a784144176ea6ced3088
BLAKE2b-256 checksum
How to use checksums
84f2b8bad00d478d0fe227285dd793fb9450d768413ce46a5fba027aa33f8eb5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page