PocketCaddie MCP Server

Use this when someone asks what PocketCaddie is, how it works, what it measures, which phones and watches it supports, what it costs, or whether an iPhone or Apple Watch can track a golf swing without video. Returns PocketCaddie's own description of itself.

Use this when a linked golfer asks what their coach assigned: the active PocketCaddie Coach plans, their drills and targets, and progress on each.

Use this when a golfer describes what the ball does or how they hit it, without naming the swing fault: e.g. 'my ball starts left and curves right', 'everything goes right', 'I keep hitting behind the ball', 'I top it', 'I shanked three in a row', 'my shots are weak and short'. Map their words to start direction, curve and contact (leave out what they didn't say). Returns the likely faults from a fixed ball-flight table and the PocketCaddie drills for each, as cards.

Use this when the golfer wants the full instructions for one drill: steps, the cue to remember, reps, equipment and why it works. Takes a drill id from search_drills, diagnose_ball_flight or practice_plan.

Use this when a golfer asks how to fix a swing fault, asks for golf drills, or wants something to work on at the driving range or at home. Covers: slice, hook, shanks, hitting it fat or thin, topping, over the top, casting, early release, flipping, chicken wing, early extension, standing up, sway, reverse pivot, hanging back, all arms, rushed tempo, decelerating, tension, blocks, weak strike. Examples: 'how do I fix my slice', 'I come over the top', 'why do I hit it fat', 'drills for my driver', 'what should I practice at the range'. Pass the golfer's own words as query. Returns drill cards from the PocketCaddie library (48 drills with steps, a cue and reps). If the golfer describes a ball flight or contact problem without naming a fault ('my ball curves right', 'I keep hitting the ground first'), use diagnose_ball_flight instead. Don't use it for tee times, course info, equipment prices, distances or rules. Skills: Tempo, Smoothness, Power, Consistency, Transition, Follow-through, Backswing Turn, Follow-Through Turn, Wrist Action, Swing Path, Body Turn, Head Stability, Kinetic Sequence, Hand Speed, Shoulder Turn, X-Factor, Posture.

Use this when a linked golfer asks about their goals, what they're working on, their focus, or how a block of practice went: the active focus goal (the reading, its zone, who set it, the block so far and the before), the long-term goal, goals waiting in the app, and recent goals with the app's outcome (Improved, Held, Not yet, Mastered). Counts are focus swings in the zone out of focus swings with a read. Only call a change real when the outcome says so.

Use this when a golfer asks for a practice plan, a range routine or a session to do at home, e.g. 'build me a 30-minute range plan', 'what should I do with a bucket of balls', 'home practice for tempo'. Builds a timed plan from PocketCaddie drills for 1–3 skills (map their goal to the closest skills). If the golfer has linked their account, call progress first and pass their lowest-scoring skills.

Show how the golfer's swing has changed across sessions: Swing Score and skill scores per session (where synced), On target and the stats to work on for newer sessions, the focus score of each focus session, and the first-vs-latest medians of each measurement. Use it to find their weakest skills before practice_plan; use goals for how a focus goal is going.

List the golfer's most recent PocketCaddie range sessions: date, swings, minutes, sensors used and Swing Score (0–100, needs 15+ swings). Newer sessions report On target instead (the share of swings in range, compared only with the golfer's own normal) with the stats to work on.

Use this when a linked golfer asks about their golf rounds or handicap: recent Live Rounds (course, holes, strokes, to par, putts) and the handicap the PocketCaddie app tracks.

Break down one range session: Swing Score, its areas and skill scores when the app synced them, plus the median of each swing measurement (tempo, backswing/downswing time, hip turn, posture; shoulder turn, X-Factor and hand speed with Apple Watch; head stability with AirPods). For a focus session, how many focus swings landed in the zone vs before; What your swing shows (patterns) when the app synced them. Newer sessions report On target and every stat as "k of n in range" (Work on, Good, Watch) instead of a Swing Score; On target is relative to the golfer's own normal, never a comparison with anyone else. Defaults to the latest session. Only interpret what is returned; PocketCaddie does not measure ball flight, carry or club head speed.