Sportily

Only on explicit user request: remove one of your recorded picks.

delete_basketball_pick

Soft-delete an owned Lens only on an explicit request. Supply its current version from list_tennis_lenses or get_tennis_lens; stale or missing Lenses are rejected.

delete_tennis_lens

Delete the user’s own unstarted tennis pick only on an explicit request. Supply its current version from list_tennis_picks; started picks cannot be deleted.

delete_tennis_pick

Use when a user asks for broad horse-racing picks, good horses, value, SmartPicks, Value Finder, or Sportily analytics candidates. This is a candidate-discovery step, not a final verdict: it returns a shortlist you must then open. Call once per date/source/filter set in a user turn, then — if the user asked anything evaluative (worth backing, which is best, what is overrated) — immediately call get_race_card for the top 3 raceIds in the same turn and answer from those. Do not offer to open them and wait; do not rank the shortlist as a substitute for a verdict. Only return a bare list if the user explicitly asks for a list.

discover_racing_picks

Use when a horse-racing user names a horse and the Sportily horseId/raceId is not yet known. Finds runners by partial horse name, or lists runners for a date so the MCP client can match a horse. Once the runner is resolved, do not repeat this lookup for the same horse in the same user turn.

find_horses

Stored NBA schedules/results, grouped by America/New_York date; maximum 31 days. Experimental win probabilities are 0–1. This is not a live feed or bookmaker odds.

find_basketball_games

Search stored player names and return IDs for player profiles. Case-insensitive literal name search, at most 100 results; no live roster feed.

find_basketball_players

Search stored team names and get IDs for profiles.

find_basketball_teams

Default tool for "what races are on?" — lists a full day's racecourses and race ids grouped by course, with today/tomorrow selection and an upcomingOnly filter. Use search_races instead when the user already named a specific course/date and you only need a quick flat list of matching race ids.

find_races

Stored football fixtures and results by UK calendar day (at most 31 days; default today and the next 6). Returns fixture IDs for get_football_match, team IDs for get_football_team and league IDs for get_football_table. Stored data, not a live feed.

find_football_matches

Search player names in Sportily’s bounded recent stored lineup catalogue. Returns provider player IDs for get_football_player. Coverage is incomplete and past lineup membership does not imply future availability.

find_football_players

Find stored tournament editions with matches in a London calendar-day range of at most 31 days. Includes event IDs, progress, remaining contenders and known finals. Results are stored coverage, not a complete tournament calendar.

find_tennis_events

Stored ATP/WTA singles fixtures and results by London calendar day (maximum 31 days). Prices include capture time and historical/prospective provenance. No live feed.

find_tennis_matches

Search stored player names; returns internal IDs for player and head-to-head tools.

find_tennis_players

Read an owned run’s status and results without starting or retrying it. Page is zero-based, with up to 200 evaluations per page and evaluationTotal/evaluationOffset for navigation. Runs may still be queued or running.

get_football_lens_run

A competition’s table counted from Sportily’s stored results for one season (3 points a win, 1 a draw; matches not collected are missing, so it can differ from the official table). Defaults to the newest season with a played match.

get_football_table

One player’s stored appearances, performance, team and availability evidence. Use the numeric provider player ID from find_football_players. Stored observations are not a live availability feed.

get_football_player

A team’s season in one competition from Sportily’s stored matches: place and points in Sportily’s table of stored results (not the official table), home/away records, goals by 15-minute window, rates with their sample sizes (clean sheets, both scored, 3+ goals), where it ranks in the league on each metric, its next fixtures and recent results. Team IDs are the provider team IDs from find_football_matches.

get_football_team

Fetch validated industry context for a Sportily race. Use at most once after get_race_card when externalResearchTargets are available and outside context would materially help. Returns status, source URLs, and extracted facts; cite the source when using verified external facts.

get_external_race_context

Use after finding a Sportily horse id when a horse-racing user asks for an opinion, profile, form view, or analysis of a named horse. Fetches career stats, upcoming races, and recent runs; open the race card before a race verdict.

get_horse_profile

Use when a raceId is known and the user asks to analyse a horse race, Sportily race, runner, racecard, or named horse in a specific race. Fetches the primary pre-race analytics payload with race, runner, model, market price, stats, past-performance, response-shape, and external-research guidance. Call once per raceId in a user turn unless the previous call failed. Target-race result fields are intentionally omitted so historical analysis can be run blind.

get_race_card

Use when the user asks who won, what happened, or wants explicit result data for a Sportily race. This is the post-race companion to get_race_card and exposes outcome fields intentionally hidden from the analysis payload.

get_race_results

List the authenticated user's saved Sportily Race Lens filters with compact backtest metrics and lens ids. Step 1 of the lens flow: use this before get_upcoming_lens_matches (to run lenses on upcoming races) or backtest_race_lens (to re-test over history) when the user wants to choose a specific saved lens, system, filter, or angle. Each lens's backtest metrics use its own stored lookback (backtest.days), which may exceed the 60-day MCP backtest cap.

get_saved_lenses_summary

Apply the authenticated user's saved Sportily Race Lens filters to races in the next 24 hours. Use when the user asks for their Race Lens results, saved-lens matches or upcoming runners found by their filters. Race Lens model fields use the base race model, which is independent of market prices, so they can differ from shortlist percentages. User-specific: only the connected user's saved lenses are considered. Step 2 of the lens flow — call get_saved_lenses_summary first if you need lens ids or want the user to choose specific lenses.

get_upcoming_lens_matches

Read one owned Lens, its versions, run ledger and recorded forward selections with audited settlement.

get_tennis_lens

Read a stored tournament edition, up to 400 matches, seeds, other edition IDs and captured main draw with byes and observation time when available. Surface ratings are current research, not historical pre-match features. A missing draw is null, never a fabricated bracket.

get_tennis_event

Stored meetings, including separate retirement and walkover statuses. Without surface returns the existing meetings array. Supply surface for {matches, player1, player2, surface, view}, including a hypothetical current matchup and 52-week serve/return profiles on that surface. This is the stored corpus, not a claim of complete career coverage; hypothetical probabilities are not a forecast for a scheduled match.

get_tennis_head_to_head

Player profile, stored ranking, surface records, serve/return counts and recent matches. Current profile aggregates must not be used as historical pre-match features.

get_tennis_player

Latest captured ATP or WTA rankings, with observation time.

get_tennis_rankings

Return the user's saved My Picks with live result and stake-weighted ROI for each, plus headline performance (strike rate, ROI points, beat-SP rate, drawdown, streaks). Use when the user asks what they have saved, how their picks are doing, or for their track record.

list_my_picks

List the available Sportily Race Lens filter fields, operators, value types and example predicates, plus the filterAst shape and rules. Use this when helping a user build or edit a lens. Model fields in this catalog use the base race model, which is independent of market prices, not shortlist percentages. Build flow: call this for the catalog, then backtest_race_lens with a draft filterAst to check the idea on completed races before saving. Note: a filterAst is a flat list of AND-ed predicates — there is no nested OR.

list_race_lens_filters

Read the connected user’s private saved tennis research rules and versions.

list_tennis_lenses

Discover enabled stored ATP/WTA tournaments, their internal IDs and countries.

list_tennis_tournaments

Only on explicit user request: log one pre-game match-winner prediction in your private Sportily prediction log. Bind forecastId from the displayed forecast to preserve identity/probability.

add_basketball_pick

Stored game-by-game player box statistics and team history, plus a view with full-history season aggregates, recent form, notable nights and coverage exclusions. Both the existing games list and view.log return at most 100 recent games; view.logTotal and view.logTruncated describe the full log. Season aggregates use all stored completed games. Optional view failures preserve the base profile and return researchWarnings.

get_basketball_player

East/West standings calculated from stored completed regular-season games, with records, ranks and coverage. Optional season is the four-digit start year; defaults or falls back to the latest season with completed games. Inspect the returned season and fallbackFrom. Null means no completed season is stored; this is not a live or official standings feed.

get_basketball_standings

Stored games and observed players, plus a season view with records, scoring averages, quarter lines and averages, coverage caveats, upcoming games and player season averages. Optional season is the four-digit start year; unavailable seasons fall back to the latest played season. Player list is not a confirmed current roster. Optional season-view failures preserve the base profile and return researchWarnings.

get_basketball_team

After the user asks to preview football rules, scan up to 500 stored upcoming fixtures (at most 5,000 candidates) within the next 14 UK calendar days. Returns the first 100 evaluations with totals/truncation flags. Does not save a lens, pick or tracked selection; takes a temporary concurrency lease. Use definitions/templates from get_football_lenses. Quotes are stored, not live; incomplete and unknown evidence must be reported.

preview_football_lens

Filter upcoming published forecasts. Returns frozen game/side/forecast identities. Preview does not record picks and is not a historical backtest.

preview_basketball_lens

Only on explicit user request: atomically record the exact game/side/forecast IDs from a preview. Changed forecasts require a new preview. Never places bets.

record_basketball_lens_picks