MCP Tools Reference

List all practice sessions, ordered by date (most recent first). Returns session ID, name, date, source, and shot count.

Get all shot data for a specific session. Returns every metric for each shot, grouped by club.

Get average stats per club across all sessions (or a specific session). Supports universal filters and analytics modes.

Run handicap component analysis on a session or all sessions. Scores 8 metrics (carry, club speed, smash, consistency, path, face control, direction, distance variance) against handicap benchmarks. Returns composite handicap estimate and per-metric breakdown.

Compare two sessions side by side. Shows how metrics changed between sessions. Useful for tracking progress.

Search for shots matching specific criteria. Find your best/worst shots, filter by metric ranges, etc. Supports universal filters and analytics modes.

Mark a shot as mishit, experiment, void, or warmup with an optional note. Flagged shots are excluded from analytics by default.

Remove a flag from a shot, returning it to normal status in analytics.

List flagged shots for a session, optionally filtered by flag type.

Run statistical analysis on a session to suggest suspected mishits and void shots for review. Does NOT auto-apply flags. Returns suggestions only.

Get full detail for a single shot by shot_id. Returns every metric, session context, annotations, flag info, and on-course context (hole/lie/score) if it was a gps_round shot.

Get metadata for a single session by session_id. Lightweight: name, date, source, tags, notes, warmup count, shot count, clubs used.

Get full detail for a single on-course round by session_id. Returns the session row plus hole-by-hole scorecard and round totals.

Get on-course shots for a gps_round session, ordered by hole then shot number. Includes hole_number, lie, result_location, made_putt, and GPS coords.

Track any metric for any club over time across sessions. The most important analytics tool, powers progress tracking.

Lightweight per-club aggregates for a single session. Includes averages, std devs, best/worst values.

All-time ceiling metrics per club. Answers "what's my best ever?" for any stat.

Auto-detect mishits and best strikes using z-score analysis. Analyzes smash factor and carry distance per club.

Standard deviation trends over time for a club. Tracks consistency: not just are averages improving, but is the spread tightening?

Percentage of shots above the "good contact" smash factor threshold per session over time. Tracks how often you find the center of the face.

Find the peak session for any club + metric combo. Good for "what was I doing that day?" analysis.

Add a qualitative note to a shot with optional tags. Tags like "thin", "fat", "locked-in", "new-cue" enable pattern analysis over time.

Get all annotations for shots in a session.

Find all shots with a specific annotation tag. Powerful for pattern analysis: "show me all locked-in 7-iron shots and their data."

List on-course rounds with scoring totals computed from hole_scores.

Score, GIR, putts, and to-par trends across on-course rounds, ordered by date.

Track consecutive sessions where a metric stays above/below a threshold. Tells you if a swing change is truly sticking.

Set a metric target goal with optional deadline. Auto-detected as achieved when the target is hit.

List all active goals with current values and gap to target.

Check all goals against latest data and auto-mark any that have been achieved. Run after every session upload.

Log swing thoughts/cues that were active during a session.

Get swing cues for a session.

Compare metrics when a specific swing cue was active vs not. Answers "does this cue actually help?"

Side-by-side metric comparison across multiple clubs. Gapping analysis plus identifying which club needs the most work.

Shot-by-shot metric evolution within a session. Reveals warm-up curves and fatigue with a 3-shot rolling average.

Rules-based engine that analyzes recent sessions and recommends what to work on. Prioritized by impact.

Full bag gapping analysis. Are your clubs properly spaced? Identifies overlaps and gaps.

Handicap index estimate over time based on simulator data trends.

Rich handicap profile with per-metric breakdown, biggest gaps, and improvement scenarios.

Separate quality shots from mishits and profile each group independently. Shows the gap between your ceiling and your mishit pattern.

Spin analysis: backspin, sidespin, launch angle, and trajectory efficiency assessment.

Are you getting the carry your club speed deserves? Compares actual carry to theoretical max for your speed.

Ball speed = club speed × smash factor. Shows how much upside you have from improving smash.

Path vs face-to-path correlation analysis. Shows whether face control is independent of path or coupled.

How fast are you improving? Regression line on each metric over time, expressed as rate of change per session.

Compare your metrics to handicap-stratified benchmarks from published data.

Compare first half vs second half of sessions. Quantify whether you degrade under volume.

Offline vs carry distribution data with dispersion ellipse. Shows where your shots are actually landing.

Query the benchmarks reference table: handicap-stratified target values per club category and metric. Grounds "you should be carrying X yards with your 7-iron at a Y handicap" claims in real published data.

Fusion analyzer: compares a club's range performance to its handicap-tier benchmark, and overlays on-course GPS-derived carry distances when available. The flagship cross-data tool.

Search and filter sessions by date range, club, tags, or notes content. Returns matching sessions with shot counts and club lists.

Edit session metadata: name, tags, notes, warmup shot count.

Everything Claude needs for a full session debrief in one call. Combines summary, outliers, active goals, swing cues, and comparison to previous session. The primary tool for "take a look at my session."