@opengolfapi/mcp-server 1.0.0 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @opengolfapi/mcp-server
 
-Free MCP server for AI agents to query the OpenGolfAPI dataset (16,908 US golf courses).
+Open MCP server for AI agents to query the OpenGolfAPI dataset (16,908 US golf courses). All data is ODbL licensed and open.
 
 ## Install
 
@@ -24,10 +24,11 @@ Add to your MCP client config:
 
 ## Tools
 
-- `search_courses(query, state?)` — find courses by name + state
-- `get_course(id)` — full free-tier course record with scorecard
-
-For premium data (per-tee ratings, climate, nearby POIs, booking links), see **[GolfAGI](https://golfagi.com)**.
+- `search_courses(query, state?, lat?, lng?, radius_mi?)` — find courses by name, state, or location
+- `get_course(id)` — full course record with scorecard (par + handicap index per hole)
+- `get_tees(id)` — all tee sets with ratings, slopes, and yardages
+- `get_climate(id)` — monthly climate normals for the course location
+- `get_nearby(id)` — nearby POIs (hotels, restaurants, airports)
 
 ## License
 

package/dist/index.d.ts

@@ -1,11 +1,10 @@
 #!/usr/bin/env node
 /**
- * OpenGolfAPI MCP Server — Free tier.
+ * OpenGolfAPI MCP Server
  *
- * 2 tools: search_courses, get_course
- * Returns only open/free fields.
+ * Tools: search_courses, get_course, get_tees, get_climate, get_nearby
+ * All data is open — ODbL licensed.
  *
  * Install: npx @opengolfapi/mcp-server
- * Or connect via: npx tsx mcp-server/opengolf.ts
  */
 export {};

package/dist/index.js

@@ -1,12 +1,11 @@
 #!/usr/bin/env node
 /**
- * OpenGolfAPI MCP Server — Free tier.
+ * OpenGolfAPI MCP Server
  *
- * 2 tools: search_courses, get_course
- * Returns only open/free fields.
+ * Tools: search_courses, get_course, get_tees, get_climate, get_nearby
+ * All data is open — ODbL licensed.
  *
  * Install: npx @opengolfapi/mcp-server
- * Or connect via: npx tsx mcp-server/opengolf.ts
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -19,14 +18,13 @@ if (!SUPABASE_KEY) {
     process.exit(1);
 }
 const supabase = createClient(SUPABASE_URL, SUPABASE_KEY);
-const FREE_FIELDS = 'id, course_name, latitude, longitude, state, city, course_type, par_total, phone, website, year_built, address, postal_code';
 const server = new McpServer({
     name: 'opengolfapi',
-    version: '1.0.0',
-    description: 'Open database of 17,000+ US golf courses. Free, ODbL licensed. opengolfapi.org',
+    version: '2.0.0',
+    description: 'Open database of 17,000+ US golf courses. ODbL licensed. opengolfapi.org',
 });
 // ── Tool: search_courses ──
-server.tool('search_courses', 'Search golf courses by name, state, or location. Returns basic course info. Free, ODbL licensed data from OpenGolfAPI.', {
+server.tool('search_courses', 'Search golf courses by name, state, or location. Returns full course info. ODbL licensed data from OpenGolfAPI.', {
     lat: z.number().optional().describe('Latitude for geo search'),
     lng: z.number().optional().describe('Longitude for geo search'),
     radius_mi: z.number().optional().default(25).describe('Search radius in miles'),
@@ -34,7 +32,7 @@ server.tool('search_courses', 'Search golf courses by name, state, or location.
     state: z.string().optional().describe('2-letter US state code'),
     limit: z.number().optional().default(10).describe('Max results'),
 }, async ({ lat, lng, radius_mi, query: q, state, limit }) => {
-    let query = supabase.from('golf_courses').select(FREE_FIELDS);
+    let query = supabase.from('golf_courses').select('*');
     if (q)
         query = query.ilike('course_name', `%${q}%`);
     if (state)
@@ -57,8 +55,13 @@ server.tool('search_courses', 'Search golf courses by name, state, or location.
         lng: c.longitude,
         type: c.course_type,
         par: c.par_total,
+        total_yardage: c.total_yardage,
         phone: c.phone,
         website: c.website,
+        architect: c.architect,
+        year_built: c.year_built,
+        address: c.address,
+        postal_code: c.postal_code,
     }));
     return {
         content: [{
@@ -67,18 +70,17 @@ server.tool('search_courses', 'Search golf courses by name, state, or location.
                     courses,
                     total: courses.length,
                     source: 'OpenGolfAPI (opengolfapi.org) — ODbL licensed',
-                    upgrade: 'Tee ratings, climate, weather, booking → golfagi.com/api',
                 }, null, 2),
             }],
     };
 });
 // ── Tool: get_course ──
-server.tool('get_course', 'Get detailed golf course info including scorecard. Free, ODbL licensed. For tee ratings, climate, weather, booking → golfagi.com/api', {
+server.tool('get_course', 'Get detailed golf course info including full scorecard with par and handicap index per hole. ODbL licensed.', {
     course_id: z.string().describe('Course UUID from search results'),
 }, async ({ course_id }) => {
     const [courseRes, holesRes] = await Promise.all([
-        supabase.from('golf_courses').select(FREE_FIELDS).eq('id', course_id).single(),
-        supabase.from('golf_course_holes').select('hole_number, par').eq('course_id', course_id).not('par', 'is', null).order('hole_number'),
+        supabase.from('golf_courses').select('*').eq('id', course_id).single(),
+        supabase.from('golf_course_holes').select('hole_number, par, handicap_index').eq('course_id', course_id).not('par', 'is', null).order('hole_number'),
     ]);
     if (courseRes.error || !courseRes.data) {
         return { content: [{ type: 'text', text: 'Course not found' }] };
@@ -87,6 +89,7 @@ server.tool('get_course', 'Get detailed golf course info including scorecard. Fr
     const scorecard = (holesRes.data ?? []).map(h => ({
         hole: h.hole_number,
         par: h.par,
+        handicap_index: h.handicap_index,
     }));
     return {
         content: [{
@@ -100,19 +103,78 @@ server.tool('get_course', 'Get detailed golf course info including scorecard. Fr
                     lng: c.longitude,
                     type: c.course_type,
                     par: c.par_total,
+                    total_yardage: c.total_yardage,
                     holes: scorecard.length,
                     phone: c.phone,
                     website: c.website,
+                    architect: c.architect,
                     year_built: c.year_built,
                     address: c.address,
                     postal_code: c.postal_code,
                     scorecard,
                     source: 'OpenGolfAPI (opengolfapi.org) — ODbL licensed',
-                    upgrade: 'Tee ratings, slopes, yardages, climate, weather, nearby hotels, booking → golfagi.com/api',
                 }, null, 2),
             }],
     };
 });
+// ── Tool: get_tees ──
+server.tool('get_tees', 'Get all tee sets for a course including ratings, slopes, and yardages per tee. ODbL licensed.', {
+    course_id: z.string().describe('Course UUID'),
+}, async ({ course_id }) => {
+    const { data, error } = await supabase
+        .from('golf_course_tees')
+        .select('*')
+        .eq('course_id', course_id)
+        .order('total_yardage', { ascending: false });
+    if (error) {
+        return { content: [{ type: 'text', text: `Error: ${error.message}` }] };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({ tees: data ?? [], source: 'OpenGolfAPI (opengolfapi.org) — ODbL licensed' }, null, 2),
+            }],
+    };
+});
+// ── Tool: get_climate ──
+server.tool('get_climate', 'Get monthly climate normals for a course (temperature, precipitation, playability). ODbL licensed.', {
+    course_id: z.string().describe('Course UUID'),
+}, async ({ course_id }) => {
+    const { data, error } = await supabase
+        .from('golf_course_climate')
+        .select('*')
+        .eq('course_id', course_id)
+        .maybeSingle();
+    if (error) {
+        return { content: [{ type: 'text', text: `Error: ${error.message}` }] };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({ climate: data, source: 'OpenGolfAPI (opengolfapi.org) — ODbL licensed' }, null, 2),
+            }],
+    };
+});
+// ── Tool: get_nearby ──
+server.tool('get_nearby', 'Get nearby points of interest for a course (hotels, restaurants, airports) within ~20 miles. ODbL licensed.', {
+    course_id: z.string().describe('Course UUID'),
+}, async ({ course_id }) => {
+    const { data, error } = await supabase
+        .from('golf_course_nearby')
+        .select('*')
+        .eq('course_id', course_id)
+        .order('distance_miles')
+        .limit(20);
+    if (error) {
+        return { content: [{ type: 'text', text: `Error: ${error.message}` }] };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({ nearby: data ?? [], source: 'OpenGolfAPI (opengolfapi.org) — ODbL licensed' }, null, 2),
+            }],
+    };
+});
 // ── Start ──
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@opengolfapi/mcp-server",
-  "version": "1.0.0",
-  "description": "Free MCP server for AI agents to query the OpenGolfAPI dataset",
+  "version": "2.0.0",
+  "description": "Open MCP server for AI agents to query the OpenGolfAPI dataset",
   "type": "module",
   "bin": {
     "opengolfapi-mcp": "dist/index.js"