# Tools by topic

Which MCP tools answer questions about sports history, fantasy leagues and analysts' picks, and the order to call them in.

The [tools table](/mcp#tools-in-the-definition) lists every tool by name. This page groups the ones most questions start from by topic, says which to call first, and gives a question each one answers. Every figure a tool returns comes from Kelly's engine, with its source and as-of time, so an AI app should quote it rather than work it out again.

## Sports history
Seasons, games, careers, records and how kinds of bets did, for every season Kelly holds. The history tools take Kelly IDs only, so start from a name.

1. `resolve_entity` turns a player's, team's or game's name into IDs. When two people share a name it returns the question to ask instead of picking one.
2. `describe_metrics` finds a stat's metric ID from words ("dimes", "ATS") and says what it means. The [stat catalogue](/concepts/stats) lists the same stats.
3. `get_coverage` says which seasons a stat exists for, so a stat a league didn't record is stated as missing, never read as zero.

Then ask for the numbers:

| Tool | Use it for | Example question |
| --- | --- | --- |
| `get_player_history` | One player's seasons, career, splits or game log | "What were Derrick Henry's rushing yards each season?" |
| `get_team_history` | One franchise's seasons, coaches, head-to-head or games | "How have the Bears done against the Packers since 2000?" |
| `get_game_history` | One finished game's box score, closing line and conditions | "Who covered in last year's Super Bowl?" |
| `find_stats` | Ranking many players, teams or games with your own filters | "Who has the most 300-yard passing games since 1999?" |
| `get_records` | Single-game, season and career bests for one stat | "What's the single-season record for blocks?" |
| `get_line_history` | How a kind of bet did over past games, with its count and interval | "How do home underdogs of 7 points do against the spread?" |
| `parse_view`, `get_view` | A stats table from plain words, with a link to the same table on the site | "Show 300+ passing yards on the road since 2020" |
| `export_chart` | Any chart a tool returned, as Vega-Lite, CSV, Python (Altair) or R (ggplot2) | "Give me that luck funnel as R code" |

`get_line_history` reports past results with their sample size and a 95% interval. It is never a pick.

## Fantasy
Projections, scoring and the person's own leagues. The league tools need the person signed in and return only their own connected leagues.

| Tool | Use it for | Example question |
| --- | --- | --- |
| `compare_players` | Start/sit, waiver and trade comparisons of named players on Kelly's projections | "Should I start Puka Nacua or Garrett Wilson?" |
| `get_fantasy_points` | NFL fantasy points in every public scoring format, by week or season | "Who led half-PPR tight ends last season?" |
| `get_fantasy_facts` | Kelly's aging, injury-return and streaming figures | "How much does a running back usually drop off at 29?" |
| `get_waivers` | The NFL waiver wire with FAAB bids for a league size | "Who should I pick up in a 12-team league?" |
| `get_league`, `get_league_team` | A connected league's settings, standings, rosters and matchups | "Where does my team stand?" |
| `get_league_waivers` | Free agents ranked for the person's own team, with bids | "What should I bid on the top free agent?" |
| `get_league_odds` | Playoff, bye and title chances for every team | "What are my playoff odds?" |
| `analyze_league` | Bench points, schedule luck, pickups and trades, in hindsight | "Who's been the luckiest team in my league?" |

On the premium paths, `run_simulation` plays out a season or a trade, and the league move tools (`set_my_lineup`, `claim_player`, `propose_trade` and others) act on the platform after the person confirms. `get_my_league_week` plans a basketball, hockey or baseball league's week.

## Analysts' picks
Picks that betting analysts stated in their public podcasts, videos, articles and posts, each graded once its game settles.

| Tool | Use it for | Example question |
| --- | --- | --- |
| `get_analyst_picks` | Recent picks, newest first, with the line then and now and the source link | "What are analysts picking in tonight's games?" |
| `get_analyst_pick` | One pick in full: what was said, where, the consensus then and at the close, and its grade | "What exactly did they say about that pick?" |
| `get_analyst_leaderboard` | Every analyst ranked by graded record over a window, with units, ROI and closing-line value | "Which analysts have the best record this month?" |
| `get_analyst_record` | One analyst's record split by market, sport and series | "How good is this analyst at NFL totals?" |

Each record carries a luck read: how often a bettor with no edge would match it. Analysts with too few graded picks are not ranked.

On the plain and cards paths, `get_slate_signals` lists the sides Kelly's own flags fired on for a date, and `get_signal_record` gives each flag's graded record against the closing line, and `get_kelly_record` gives Kelly's whole graded record, every flag in every sport and market type, in one call.

---

Last updated November 6, 2026

Support: support@askkelly.ai · Security and disclosure: https://docs.askkelly.ai/security

Data is the edge. Odds are information, not advice · 21+ · Get help
