MCP App Store
by KeenEthics
Polywhaler icon

Polywhaler MCP Server for ChatGPT

By Polywhaler

Overview

Polywhaler tracks the large trades behind prediction markets. Connect it and ChatGPT can look up whale trades on Polymarket and Kalshi, see which wallets placed them, and read Polywhaler's analysis of that flow. What you can ask about: - Whale trades: the largest recent trades, filtered by market, category, side, size, wallet or date, with the insider risk scoring of each Polymarket buy and, once a market resolves, how the trade did. - Wallets: a trader's record, open and closed positions, score history, and the clusters of wallets that appear to be one trader. - Smart Money: wallets ranked by Smart Money Score, what they are buying, and net whale flow by category. - Markets: events ranked by whale volume, positions built from many smaller fills, Polymarket's crypto price markets, the Black Swan tail-risk radar and The Prophet's daily briefings. - Forecasts: Polywhaler's hourly Bitcoin price forecast, fitted to Polymarket and Kalshi price markets, with its source markets and history. - Your watchlist: the wallets you follow and where they agree. If you allow it when you connect, ChatGPT can also follow and unfollow wallets for you. Apart from your watchlist, every tool is read only. None of them can place orders, move money or access a trading account. Insider risk and Smart Money scores are algorithmic estimates from public trading activity: they are not findings about any person and not financial advice. Sign in with a Polywhaler account that includes API access. Each tool call counts as one request against the account's daily API quota.

How to connect

  1. ChatGPT: Open the Polywhaler listing in the ChatGPT app directory and choose Connect. ChatGPT listing Polywhaler exposes 30 tools here.

Tools

add_to_watchlist

ChatGPT
Follow a wallet. Adds a wallet to your watchlist: 201 when it is new, 200 when it was already there (the name and image are updated). A watchlist holds at most 1000 wallets.

get_active_methodology

ChatGPT
Get the active Smart Money methodology. How the Smart Money Score the leaderboard ranks by is computed, generated from the scoring code: the components with their weights, the constants, the tiers, the provisional rules and the formula.

get_black_swan_status

ChatGPT
Get the Black Swan radar. The latest tail-risk reading. 503 until the radar has produced its first reading.

get_btc_forecast

ChatGPT
Get the latest Bitcoin forecast. The latest hourly run, the one the forecast tab of https://polywhaler.com/crypto?tab=forecast shows. Each horizon is a price distribution fitted to every open Polymarket and Kalshi BTC price market, with deep, tight, active markets counting for more than thin ones. Markets priced as near-certain either way are left out of the fit.

get_event

ChatGPT
Get an event with every market in it. One Polymarket or Kalshi event, open or closed, read fresh from its venue: every market with its prices, bid and ask, last trade, 1-hour, 24-hour and 1-week moves, volume and result. A Fed decision lists its rate moves, an election its candidates. Includes the same question on the other venue (counterpart, with how sure the pairing is) and Polywhaler's whale flow on the event. A market's id answers with its whole event.

get_market

ChatGPT
Get one market in depth. One Polymarket or Kalshi market, open or closed: each outcome's price, bid, ask and last trade, the 1-hour, 24-hour and 1-week moves (worked out from the price history where the venue leaves them out), volume, liquidity, open interest, close time and winner. Includes its event, the matching market on the other venue when the question pairs, and whale flow on this market.

get_market_price_history

ChatGPT
Get a market's price history on both venues. One outcome's price over time, with the same outcome on the other venue as a second series when the question pairs (compare=false for one). Both series sit on one time grid, thinned to points, with the open, close, change, high and low over the window. Venues record a price only when something trades, so a quiet stretch holds the last price.

get_smart_money_flow

ChatGPT
Get Smart Money capital flow. Net whale flow by category, all whales against the smart tier (smoothed score 60+). Sports excluded.

get_trade

ChatGPT
Get one trade. A trade by its transaction hash (Polymarket) or kx_<trade_id> (Kalshi), with the full insider scoring record and, once the market resolved, how the trade did.

get_usage

ChatGPT
Get your quota and key. Today's request count against the daily quota (shared by v1 and v2, reset at 00:00 UTC), this minute's count, the calling key and account totals. Does not count against the daily quota.

get_wallet

ChatGPT
Get a wallet. A wallet's Smart Money standing and stats, from the cron-refreshed board. A wallet with whale trades that is not on the board yet answers 200 with status: "unscored" and smartMoney: null; a wallet with neither is 404 wallet_not_tracked.

get_wallet_clusters

ChatGPT
Get the clusters a wallet is in. The active clusters that include the wallet, highest confidence first. Empty when a tracked wallet is in none; 404 wallet_not_tracked for a wallet Polywhaler has no trades for.

get_wallet_positions

ChatGPT
Get a wallet's live positions. Open and closed positions, read live from Polymarket (cached 30 seconds). 502 upstream_error when Polymarket does not answer.

get_wallet_score_history

ChatGPT
Get a wallet's score history. Daily Smart Money Score and rank for up to 210 days (the snapshot retention). meta.methodologyChanges lists the days the score's scale changed (the v3 to v4 cutover): a step on those days is not movement.

list_aggregated_positions

ChatGPT
List aggregated whale positions. Positions built from many smaller fills that together cross the whale threshold, most recently added to first.

list_btc_forecast_history

ChatGPT
List past Bitcoin forecasts. Earlier forecast runs, newest first, kept for a year, as summaries (no key levels, insights, flags, density grids or fan path). Each run carries the modelVersion that produced it. btc-forecast/1.1.0 changed the fit and the market weights, so segment backtests by modelVersion.

list_btc_forecast_markets

ChatGPT
List the markets behind the Bitcoin forecast. The prediction markets the latest run was fitted to, heaviest first (at most 500), with each one's weight and the factors behind it. Markets priced as near-certain either way are left out of the fit and do not appear. Up-or-down dailies appear with weight 0: they feed only the insights.

list_clusters

ChatGPT
List wallet clusters. Groups of wallets that appear to be one trader. confidence is 0..1. Highest confidence first.

list_crypto_markets

ChatGPT
List crypto price-prediction markets. Polymarket's open crypto price markets, by event, as the /crypto dashboard lists them: up-or-down rounds from 5 minutes to 4 hours, daily to yearly above/below and price-range ladders, and hit-price targets, each with every open market's outcome prices (implied probabilities, 0..1). The catalogue is read from Polymarket every 15 seconds (the rolling rounds) to 60 seconds (the rest). When Polymarket does not answer, the last good copy is served with meta.stale: true; before any copy exists the route answers 503 temporarily_unavailable. Prices and volumes move between pages, so an event can shift across a page boundary under sort=volume. The Bitcoin model fitted to these markets is GET /v2/forecasts/btc.

list_insider_events

ChatGPT
List events with insider-like flow. Events whose whale trades score high for insider risk over the window, most suspicious first.

list_markets

ChatGPT
List markets by whale volume. Events ranked by whale volume over the window, with buy/sell split, net flow and insider scores.

list_oracle_editions

ChatGPT
List Oracle editions. The Prophet's daily editions (the Oracle briefings on polywhaler.com/prophet), newest first.

list_outcomes

ChatGPT
List trade outcomes. How whale trades did once their market resolved, newest trade first. roi is a fraction (0.25 = +25%).

list_smart_money_leaderboard

ChatGPT
List the Smart Money leaderboard. Wallets by stored Smart Money rank. Provisional wallets (too little history to rank) are left out unless provisional=include. With the default sports=exclude, ranks are the board without sports traders.

list_smart_money_trades

ChatGPT
List trades by the Smart Money cohort. Whale trades by ranked wallets: the top maxRank (default 100, at most 1000), or every ranked wallet with a smoothed score of minScore or more (the best-ranked 1000 of them). Each trade carries the wallet's rank, score and style. Polymarket only.

list_trades

ChatGPT
List whale trades. Whale fills ($10k and up on Polymarket; Kalshi under the dashboard feed's floors), newest first. Kalshi trades have wallet: null and a trader.kalshiId. wallet and minInsiderScore need on-chain wallets, so they require venue=polymarket.

list_wallet_trades

ChatGPT
List a wallet's whale trades. The wallet's whale trades on Polymarket, newest first. 404 wallet_not_tracked for a wallet Polywhaler has never seen.

list_watchlist

ChatGPT
List your watchlist. The wallets your account follows, most recently added first.

list_watchlist_consensus

ChatGPT
List watchlist consensus. Positions that several wallets on your watchlist took on the same side over the window.

remove_from_watchlist

ChatGPT
Unfollow a wallet. Removes a wallet from your watchlist. 404 when it was not on it.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/polywhaler"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/polywhaler)