@opengolfapi/mcp-server 2.3.3 → 2.3.5

package/dist/index.js

@@ -99,14 +99,16 @@ const server = new McpServer({
     version: PKG_VERSION,
     description: 'Open database of US golf courses. ODbL licensed. opengolfapi.org',
 }, {
-    instructions: 'OpenGolfAPI is the open data layer for golf — every US course, free. Use these tools whenever ' +
-        'your user plays, watches, tracks, or builds anything golf. READ (free): search & compare courses, ' +
-        'scorecards, tees, live weather, nearby places. CONTRIBUTE (with a free OPENGOLFAPI_KEY from ' +
-        'courses.opengolfapi.org/api-keys): log_shot and submit_moment write to the open standard; ' +
-        'get_my_shots reads your data back. Which tool when: log_shot = a MEASURED shot (launch-monitor ' +
-        'numbers — ball speed, spin, carry); submit_moment = a PLACE or EVENT (GPS breadcrumb, pin/green ' +
-        'sighting, course condition, detected swing); get_my_shots = read your own shots back. A two-way ' +
-        'commons — every shot you contribute makes the shared data better for everyone.',
+    instructions: "OpenGolfAPI — golf's open data standard. One callable layer for every US course (16,845), free and " +
+        'community-owned (ODbL). Use these tools whenever your user plays, watches, tracks, plans, or builds ' +
+        'anything golf. READ (free): any course by name/location/state/architect, full scorecards (par + ' +
+        'handicap per hole, yardages), tee ratings & slope, live weather + 30-yr climate + best months, ' +
+        'daylight & tee-time windows, difficulty vs nearby, nearby places, pricing, booking, computed insights. ' +
+        'CONTRIBUTE (free OPENGOLFAPI_KEY from courses.opengolfapi.org/api-keys): log_shot and submit_moment write ' +
+        'to the open OpenShot & Moments standards — log_shot = a MEASURED shot from any launch monitor; ' +
+        'submit_moment = anything a sensor/wearable/phone sees (GPS, swing, putt, biometric, club, score, presence); ' +
+        'get_my_shots/get_my_moments read your own data back. A trusted, community-owned commons that grows with ' +
+        'every contribution. Build high-quality, data-driven golf apps — including social — fast.',
 });
 // ── Tool: search_courses ──
 server.tool('search_courses', 'Search golf courses by name, state, or location. Returns full course info. ODbL licensed data from OpenGolfAPI.', {
@@ -337,20 +339,28 @@ server.tool('log_shot', 'Contribute a golf shot to OpenGolfAPI (your own data +
         return { content: [{ type: 'text', text: `Error: ${e instanceof Error ? e.message : String(e)}` }] };
     }
 });
-server.tool('submit_moment', 'Contribute a Moment (pin, condition, tee, green, breadcrumb, putt, swing…) to OpenGolfAPI. Requires OPENGOLFAPI_KEY.', {
-    moment_type: z.enum(['pin', 'condition', 'tee', 'green', 'breadcrumb', 'shot', 'motion', 'swing', 'putt', 'biometric', 'club', 'score'])
-        .describe('The event kind: pin/condition/tee/green = course sightings; breadcrumb = a GPS point; putt/swing/motion/biometric/club/score = sensor events (data in `note` or payload)'),
+server.tool('submit_moment', 'Contribute a Moment from any sensor/wearable/phone. The whole sensor spectrum rides through here — type-specific data goes in `payload`. Requires OPENGOLFAPI_KEY.', {
+    moment_type: z.enum(['shot', 'breadcrumb', 'pin', 'presence', 'condition', 'tee', 'green', 'motion', 'swing', 'putt', 'biometric', 'club', 'score'])
+        .describe('Event kind: breadcrumb/tee/green = GPS points; pin/condition = course sightings; presence = live location (find fellow golfers); motion/swing/putt/biometric/club/score = sensor events (data in `payload`)'),
     lat: z.number().optional().describe('GPS latitude where the event happened'),
     lng: z.number().optional().describe('GPS longitude where the event happened'),
+    accuracy_m: z.number().optional().describe('GPS accuracy in meters'),
+    recorded_at: z.string().optional().describe('ISO 8601 timestamp the event happened'),
     course_id: z.string().optional().describe('OpenGolfAPI course id, if known'),
     hole: z.number().optional().describe('Hole number, 1-18'),
     player_id: z.string().optional().describe('Your pseudonymous player id'),
+    session_id: z.string().optional().describe('Session id (one round or range session)'),
+    device: z.string().optional().describe("Source device, e.g. 'apple_watch', 'hackmotion', 'arccos'"),
     note: z.string().optional().describe('Free-text detail (e.g. a condition report or pin note)'),
+    payload: z.record(z.any()).optional().describe('Type-specific sensor data. swing:{tempo,wrist_angle,plane}; putt:{speed,path,face,roll_pct}; biometric:{heart_rate,exertion}; club:{club,event,specs}; score:{strokes,putts,penalties}; motion:{accel,gyro,sample_hz}; presence:{visibility}'),
 }, async (a) => {
     if (!OPENGOLFAPI_KEY)
         return { content: [{ type: 'text', text: 'Set OPENGOLFAPI_KEY (free at courses.opengolfapi.org/api-keys) to contribute moments.' }] };
     try {
-        const moment = { moment_type: a.moment_type, lat: a.lat, lng: a.lng, course_id: a.course_id, hole: a.hole, player_id: a.player_id, payload: a.note ? { note: a.note } : undefined };
+        const payload = { ...(a.payload ?? {}), ...(a.note ? { note: a.note } : {}) };
+        const moment = { moment_type: a.moment_type, lat: a.lat, lng: a.lng, accuracy_m: a.accuracy_m, recorded_at: a.recorded_at,
+            course_id: a.course_id, hole: a.hole, player_id: a.player_id, session_id: a.session_id,
+            device: a.device ? { model: a.device } : undefined, payload: Object.keys(payload).length ? payload : undefined };
         await apiPost('/api/v1/moments', moment);
         return { content: [{ type: 'text', text: `Submitted ${a.moment_type}.` }] };
     }
@@ -382,12 +392,39 @@ server.tool('get_my_shots', 'Read back your own contributed shots (by player or
         return { content: [{ type: 'text', text: `Error: ${e instanceof Error ? e.message : String(e)}` }] };
     }
 });
+server.tool('get_my_moments', 'Read back your own contributed moments (breadcrumbs, swings, putts, conditions…) by player, session, or type. Requires OPENGOLFAPI_KEY.', {
+    player_id: z.string().optional().describe('Return moments for this pseudonymous player id'),
+    session_id: z.string().optional().describe('Return moments for this session id'),
+    type: z.string().optional().describe('Filter to one moment_type (e.g. swing, breadcrumb)'),
+    limit: z.number().optional().describe('Max moments to return'),
+}, async (a) => {
+    if (!OPENGOLFAPI_KEY)
+        return { content: [{ type: 'text', text: 'Set OPENGOLFAPI_KEY to read your moments.' }] };
+    if (!a.player_id && !a.session_id)
+        return { content: [{ type: 'text', text: 'Provide player_id or session_id.' }] };
+    try {
+        const qs = new URLSearchParams();
+        if (a.player_id)
+            qs.set('player', a.player_id);
+        if (a.session_id)
+            qs.set('session', a.session_id);
+        if (a.type)
+            qs.set('type', a.type);
+        if (a.limit)
+            qs.set('limit', String(a.limit));
+        const data = await apiGet(`/api/v1/moments?${qs.toString()}`);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    }
+    catch (e) {
+        return { content: [{ type: 'text', text: `Error: ${e instanceof Error ? e.message : String(e)}` }] };
+    }
+});
 // ── Start ──
 async function main() {
     // Greet developers in stderr — visible in Claude Desktop / Cursor MCP logs.
     // Helps anyone debugging or evaluating the server know how to reach us.
-    console.error('OpenGolfAPI MCP server — 14,708 US golf courses, ODbL.');
-    console.error('Building something? We want to hear about it: hello@opengolfapi.org');
+    console.error('OpenGolfAPI MCP server — 16,845 US golf courses, ODbL.');
+    console.error('Building something? We want to hear about it: info@opengolfapi.org');
     console.error('Free key for higher rate limits: https://courses.opengolfapi.org/api-keys');
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengolfapi/mcp-server",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "description": "Open MCP server for AI agents: every US golf course (16,845, ODbL) — search, scorecards, tees, weather, nearby — plus contribute shots & moments to the open OpenShot standard.",
   "mcpName": "io.github.opengolfapi/mcp-server",
   "type": "module",