IPSC Scoreboard

How to connect

• search_events

  Search for IPSC competitions by name, country, date range, or level. Use this to find a specific match the user has named, or to browse upcoming/recent events. Each result contains `id` and `content_type` fields — pass both to get_match to load full details. When searching by name (query param), past events are included automatically — no date filter needed. When browsing without a query, only events within ~3 months of today are returned by default; pass explicit starts_after/starts_before to w

• get_match

  Fetch full details for a specific IPSC match. Returns the complete competitor list — each entry has a numeric `id`, `name`, `club`, and `division`. Also returns a `squads` list where each squad has a `name` (e.g. 'Squad 3') and a `competitorIds` array of every competitor in that squad. Use this to resolve any user reference to a competitor ID before calling compare_competitors: match by `name` for named individuals, filter by `club` for club members, or use `squads[n].competitorIds` for an entir

• compare_competitors

  Run a deep stage-by-stage comparison for 1–12 competitors in a match. Returns scores, hit factors, penalties, efficiency %, consistency, time-vs-accuracy breakdown, what-if rank simulations, and performance fingerprints. Pass a single competitor ID to analyse one shooter in isolation. Pass multiple IDs to compare them head-to-head across every stage. `competitor_ids` are numeric IDs from get_match's competitor list — always resolve names to IDs via get_match first. IMPORTANT — ranking across com

• get_stage_times

  Export raw stage times for a list of competitors at a match — built for video editors who want to auto-cut a long match recording into per-stage clips. Returns one object per competitor with a stages[] array; each entry has stage_number, stage_name, time_seconds (raw stage time), and scorecard_updated_at (ISO timestamp of when the run was recorded). Stages within each competitor are sorted by stage_number. Competitors are returned in the order of `competitor_ids`. competitor_ids are numeric IDs

• get_popular_matches

  List recently-viewed IPSC matches from the cache. Call this first whenever the user hasn't specified a match — it surfaces currently-active or recently-popular events so you can ask which one they mean, or proceed with the most relevant one. If the user asks a vague question like 'how did I do?' or 'what matches are on?', start here. Returns [] when the cache is cold (no recent visitors); fall back to search_events in that case.

• get_shooter_dashboard

  Fetch a shooter's cross-competition profile and career statistics. Returns: profile (name, club, division), match history (up to 50 recent matches with per-match stats), aggregate stats (overall match %, average hit factor, A-zone %, consistency CV, HF trend slope), and achievement progress (tiered milestones). Use this to answer questions about a shooter's performance across multiple matches, their consistency over time, or how their accuracy has been trending. The `shooter_id` is the globally

• find_shooter

  Search for shooter profiles by name. Returns a list of matching shooters with their shooter_id — pass that ID to get_shooter_dashboard to load their full career history. Only shooters who have appeared in at least one cached match on this server are searchable. Pass an empty query to browse the most recently active shooters. Use this when you know a shooter's name but not their shooter_id, as an alternative to browsing get_match competitor lists.

Related servers