# predictionmarketspicks/mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/predictionmarketspicks/mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 730  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/predictionmarketspicks-mcp

## Description
Quant tools + an NFL fantasy draft assistant for AI agents — Kalshi & Polymarket EV, edge, ADP. 22 tools: expected value, Kelly sizing, Bayesian updating, odds conversion, base-rate gaps and a same-game combo builder, plus a full fantasy draft board (ADP, best-available, player outlook, sleepers) — all free, no key. Pro adds cross-platform gap scanning, macro pulse, commodity and NFL edge models, and live edge alerts. Remote Streamable HTTP at https://predictionmarketspicks.com/api/mcp/mcp — nothing to install.

## Tools
Capabilities this server exposes over MCP:

- **fed_rate_odds** — Use for "will the Fed cut, hold or hike" and "next FOMC meeting odds". Live Kalshi odds for each remaining 2026 FOMC meeting: the next meeting's full strike breakdown and days-until, the rate path, the current fed funds rate, and a next-meeting cross-venue check against Polymarket and CME futures, with the gap in pp. Free, no key.
- **calculate_ev** — Use for "is this contract mispriced" and "what is my edge". Give a Kalshi or Polymarket price in cents and your own probability; returns the % expected-value edge and a BUY / SELL / SKIP read. Free, no key. Every PMP engine signal is graded in public: predictionmarketspicks.com/track-record.
- **kelly_size** — Compute the optimal Kelly position size for a prediction-market contract. Given your win probability, the market price (which sets the payout), your bankroll, and a Kelly fraction (full / half / quarter / eighth), returns the dollar stake and a risk rating. Use for "how much should I stake", "what is my position size", "Kelly sizing for this trade".
- **bayes_update** — Update a prior probability with one or more pieces of evidence using Bayes theorem. Given a prior and a list of evidence items (each with P(evidence | true) and P(evidence | false)), returns the posterior probability and the per-step chain. Use for "update my estimate with new information", "posterior probability", "how does this news change the odds".
- **convert_probability** — Convert between implied probability, American odds, and decimal odds. Give one value and its format and get all three back (American odds carry no commas, e.g. +441 or -200). Use for "what is +150 as a probability", "convert 62% to American odds", "decimal to implied odds".
- **base_rate_gap** — Use for "how does this price compare to history" and "is the market ignoring the base rate". Compares a market price with the historical base rate for a class of events: the gap in pp, a signal, and sample-size quality. Pass a known baseRateId (the parameter lists them) or your own baseRateValue. Free, no key.
- **combo_edge** — Use for "price a same-game NFL combo" and "is this combo worth it". Pass nflGame ("NYG-LAR", "Giants vs Rams") to list that game's Kalshi legs — moneyline, spreads, totals, player props — then legIds to price your pick with the correlation done for you. Or pass legPrices + trueWinProbability for a fair band; add offeredOdds for EV and a verdict. Free.
- **nfl_power_ratings** — The PredictionMarketsPicks NFL power ratings — PWR for all 32 teams: points per game above an average team on a neutral field, where PWR = Off PR + Def PR + ST PR. Includes each team's rank and tier. Free, no key. Use for "best NFL teams by power rating", "NFL power rankings 2026", "is Baltimore overrated", "how good is Kansas City", "NFL team ratings".
- **nfl_win_probability** — Use for "who wins Chiefs vs 49ers" and "what does a -7 spread mean". Pass homeTeam + awayTeam (or game, or one team) for our QB-gated model line (raw power ratings if unscheduled), or a spread (home favored negative). Returns win, cover and over/under probability, the projected score and our own total; neutral-site games get no home edge. Free, no key.
- **find_arbitrage** — Use for "where is the arbitrage" and "Kalshi vs Polymarket price gaps". Cross-venue gaps on the same sports contract (NBA, NHL, MLB, World Cup) against Polymarket's international book: the gap in pp, the WATCH/ARB signal and the cheaper venue. Free: the top 3 gaps in full; Pro returns the whole board.
- **market_pulse** — The US macro-health composite (0–100) and regime plus the six category scores (growth, labor, inflation, rates, liquidity, sentiment). The composite and the regime call are free without a key, always, along with 2 category scores; one email returns 4 and Pro returns all six. Use for "how is the US economy", "macro regime", "risk-on or risk-off".
- **commodity_edge** — Use for "gold edge today" and "oil or bitcoin trade signal". The Kalshi daily gold, silver or WTI strike, or hourly bitcoin strike, with the largest PMP model edge, as a ticket: side, entry price, resolve criterion, model probability, edge, tier and quarter-Kelly size. Pass tickers[] to check a watchlist. Pro — sign in with PredictionMarketsPicks, or a Pro API key.
- **scan_mispricings** — Scan Polymarket contracts for mispricings against the PMP model (a probability swarm). Returns each market where the model disagrees with the price, the direction to take, the edge in percentage points, and quarter-Kelly sizing, sorted by absolute edge. The scanner is being rebuilt for the 2026 midterms and usually returns no rows today; the response says when it last ran. Pro — sign in with PredictionMarketsPicks, or a Pro API key. Use for "where is the edge today", "mispriced markets", "what should I trade".
- **edge_alerts** — Use for "any edge on Kalshi" and "weather trade signals". Our model alerts on Kalshi — weather, bitcoin/silver/gold/oil, mispricings — with feed, tier, side, price, model probability, edge and link. Real time with Pro; free is delayed 24h without the thesis. One identical, impersonal feed for every subscriber; filters only select. Informational, not investment advice.
- **nfl_edge** — Use for "which NFL games are mispriced on Kalshi" and "NFL win total, MVP or Super Bowl edges". Our NFL model vs live Kalshi prices — this week's game positions, season win totals, MVP and championship odds: model probability, price, edge and side. tickers[] checks a watchlist (futures, mvp, championship). Pro — sign in with PredictionMarketsPicks, or a Pro API key.
- **nfl_prop_edge** — Use for "best NFL props today" and "receiving yards prop value". Our projection vs the Kalshi "X or more" prop line: the contract, the YES/NO call, our odds and Kalshi's price for that side, the projection and the edge, with WATCH rows labelled. Live in season. Pro — sign in with PredictionMarketsPicks, or a Pro API key.
- **nhl_edge** — Use for "NHL predictions tonight" and "Stanley Cup odds". Tonight's NHL games on Kalshi — moneyline, puck line, totals, period markets — as Market · Model · Fair, starting goalies checked first. market=goals: anytime and first-goal contracts; market=futures: Cup, conference and division markets on Kalshi and Polymarket (international book) vs a 10,000-season sim. Free.
- **nfl_prop_board** — Use for "where is the best price on <player> receiving yards" and "is Kalshi cheaper than the books". Every Kalshi NFL prop strike this week beside the book consensus, DraftKings, FanDuel and BetRivers lines and exchange quotes: the gap in cents and the best price per side (Kalshi net of fee). Filter by team, game, player or stat. Free, no key.
- **nfl_ladder** — Use for "where does the model disagree with Kalshi on the Rams spread" and "biggest ladder gaps this week". Every NFL strike ladder — spreads, season win totals, player props — with Kalshi's price at each strike beside our distribution and a SHAPE / LOCATION / PRICED / PARTIAL verdict. Our number is published only between 30% and 70%. Free, no key.
- **ladder_arb** — Use for "is any CFB ladder mispriced" and "where can I make a market on Kalshi". Kalshi college football and NFL spread/total strikes priced out of order: locked arbitrage, crossed-mid inversions and wide books worth making a market in, with both tickers and books, gross edge, volume and tier. Free, no key; Pro adds the resting orders, net-of-fee edge and quarter-Kelly size.
- **fifteen_min_board** — Use for "what is the ETH 15-minute market doing" and "which Kalshi 15-minute markets are open". Every Kalshi 15-minute up-or-down series — crypto, metals, energy, FX — with window status, YES price, close time, target price, what it settles on and the up rate over the last 96 windows. Pass series ("eth", "KXBTC15M") or asset_class. Free, no key.
- **weather_board** — Use for "Kalshi NYC high temperature odds". Every open Kalshi daily-high strike in 13 cities: YES price, settlement station and source, the strict-comparison rule, close time, and the NWS forecast high beside it. Pass city ("nyc", "KXHIGHCHI"). Market data only. Free, no key.
- **perps_board** — Use for "Kalshi perps funding rate" and "how much leverage on Kalshi gold perps". Every Kalshi perpetual future: price, 24h volume, open interest, max leverage long and short, funding cadence, and what funding has cost a long since launch. Pass asset ("btc", "gold") for one. Free, no key.
- **perp_liquidation** — Use for "where does a 5x bitcoin long liquidate on Kalshi". Estimates a Kalshi perp's liquidation price and the % move to it from Kalshi's risk parameters (a 5x BTC long is about 8% away, not the 20% the 100÷leverage rule implies), plus fees and expected funding. An estimate; Kalshi's app shows the exact one. Assets: btc, eth, sol, xrp, doge, hype, link, gold, silver, platinum, palladium. Free.
- **senate_map** — Use for "2026 Senate map" and "which Senate seats are toss-ups". Every 2026 Senate seat: holder and role, structure rating, forecaster bands where tracked, and the live Kalshi price (Democrat win probability where provable), closest race first, with a page URL per seat. Prices are never estimated — an unpriced seat returns null. Free, no key.
- **race_odds** — Use for "who wins the Kansas Senate race" and "Michigan governor odds". Live Kalshi odds for one 2026 Senate, governor or competitive House race, by state, code, slug or district ("TX-34"): every leg's price, volume and link, the seat holder and rating, forecaster bands, and the race page. Prices are never estimated. Free, no key.
- **draft_board** — In season: this week's NFL prop market board — every Kalshi player prop with the best price across venues, filter by position. Free. (The 2026 fantasy draft board returns in the 2027 offseason.)
- **best_available** — In season: where the best available PRICE is on this week's NFL props — strikes where Kalshi and the book consensus are 5¢+ apart. Free.
- **player_outlook** — One NFL player this week — every Kalshi prop line, the best price across venues, and our probability at each strike. Free. Use for "is <player> a good play this week", "<player> props".
- **explain_player** — Why the PredictionMarketsPicks model prices an NFL player's Kalshi prop strikes where it does this week: the projection, The Ladder's verdict (SHAPE, LOCATION, PRICED or market-only), the widest published model-vs-market gap, and what the model does NOT account for. Our number appears only where it is measured calibrated (30–70%). Free, no key. Use for "why do you price <player> there", "explain <player>'s prop", "what's driving the model on <player>", "why is <player>'s over priced at that".
- **compare_players** — Compare 2–4 NFL players this week: every Kalshi prop strike each has, the best price per side across venues, our probability where we publish one, and a ranked verdict on whose price the model disagrees with most, and on which strike. Free, no key. Use for "<A> or <B> this week", "compare <A> and <B> props", "who has the better prop, <A> or <B>", "<A> vs <B> receiving yards".
- **sleepers_and_busts** — Every NFL player whose Kalshi prop price the PredictionMarketsPicks model disagrees with this week, ranked, each marked underpriced (model above the market) or overpriced (model below) with the stat driving it. Free, the complete list, no key. Which strike, at what price and by how much is the Pro nfl_prop_edge tool. Use for "undervalued players this week", "who is the market overpricing", "which players is the market wrong on", "overrated players week N", "where does your model disagree with the market most", "sleepers this week", "busts to avoid this week".
- **who_do_i_draft** — In season: the Kalshi props listed on the players you name (2–4), with the best price per strike. Free. Pass roster: ['Player A', 'Player B'].
- **adp_market_gaps** — In season: Kalshi vs book-consensus gaps on this week's NFL props, widest first, filter by position. Free. (ADP gaps return in the 2027 offseason.)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp": {
    "command": "npx",
    "args": ["-y","@predictionmarketspicks/mcp"]
  }
}
```

## Documentation

## What predictionmarketspicks/mcp does

predictionmarketspicks/mcp exposes hosted Model Context Protocol tools for prediction-market analysis and related sports, macroeconomic, election, weather, commodity, and fantasy-football data. Its primary market sources are Kalshi and Polymarket. The server combines live lookup tools with stateless calculators, allowing an agent to inspect current contracts, compare prices, and apply probability or position-sizing methods.

The free tool set does not require an API key. Selected edge engines and deeper list results require a PredictionMarketsPicks API key. Signals published by the engines are tracked against the market, including wins and losses, through the project’s public track-record page.

## How it works

The hosted endpoint uses Streamable HTTP:

`https://predictionmarketspicks.com/api/mcp/mcp`

An MCP client can connect to that URL directly. Clients that only support stdio can use the npm package, `@predictionmarketspicks/mcp`, as a bridge. The bridge relays the hosted server’s tools, schemas, and results rather than running the live engines locally.

The package also supports narrower modes. `--draft` connects to the fantasy-draft surface, while `--local` runs six offline calculators without network access. The local mode cannot provide live market data, the NFL model, or other network-backed tools.

## Setup and configuration

For a Streamable HTTP client, add the hosted endpoint as an MCP server. For a stdio client, run:

```json
{
  "mcpServers": {
    "predictionmarketspicks": {
      "command": "npx",
      "args": ["-y", "@predictionmarketspicks/mcp"]
    }
  }
}
```

Set `PMP_API_KEY` in the client environment when Pro tools or their additional depth are needed. No key is needed for the free set. Gemini CLI can install the package from the repository, and the README provides direct installation links for Cursor and VS Code.

## Tools and capabilities

The calculator group includes `calculate_ev`, `kelly_size`, `bayes_update`, `convert_probability`, `base_rate_gap`, and `combo_edge`. These cover contract edge, fractional Kelly stakes, evidence-based probability updates, odds formats, historical base rates, and correlation-aware same-game combinations.

Market and research tools include Fed rate odds, cross-venue arbitrage, market-pulse scores, commodity signals, 15-minute market boards, perpetual-futures funding and liquidation estimates, Senate and race odds, and weather boards. NFL tools cover power ratings, win probabilities, prop boards, ladder pricing, player outlooks, and several model-versus-market edge views. The fantasy tools provide draft-board, best-available, player-outlook, and related NFL player analysis; during the season, some draft surfaces answer week-by-week market questions instead.

## Limitations and notes

Live results depend on the hosted service and the availability of the underlying market data. `--local` is intentionally limited to offline calculations. Some tools are seasonal, such as NFL in-season boards and fantasy draft views. The Polymarket mispricing scanner may return no rows while it is being rebuilt for the 2026 midterms. Pro-only tools require a PredictionMarketsPicks account or API key, and edge-alert data may be delayed or lack the full thesis on the free tier. Market and edge outputs are informational and are not investment advice.

predictionmarketspicks/mcp fits the Finance & Fintech category when an agent needs quantitative market context, but it does not execute trades or place positions.

_Full upstream README: https://allmcps.com/mcp/predictionmarketspicks-mcp/readme_