@opengolfapi/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenGolfAPI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# @opengolfapi/mcp-server
+
+Free MCP server for AI agents to query the OpenGolfAPI dataset (16,908 US golf courses).
+
+## Install
+
+```bash
+npm install -g @opengolfapi/mcp-server
+```
+
+## Configure
+
+Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "opengolfapi": {
+      "command": "opengolfapi-mcp"
+    }
+  }
+}
+```
+
+## 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)**.
+
+## License
+
+MIT

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+/**
+ * OpenGolfAPI MCP Server — Free tier.
+ *
+ * 2 tools: search_courses, get_course
+ * Returns only open/free fields.
+ *
+ * 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';
+import { z } from 'zod';
+import { createClient } from '@supabase/supabase-js';
+const SUPABASE_URL = process.env.SUPABASE_URL ?? 'https://ysbzokxixabqrdogdvqc.supabase.co';
+const SUPABASE_KEY = process.env.SUPABASE_SERVICE_ROLE_KEY ?? '';
+if (!SUPABASE_KEY) {
+    console.error('SUPABASE_SERVICE_ROLE_KEY required');
+    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',
+});
+// ── 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.', {
+    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'),
+    query: z.string().optional().describe('Course name search'),
+    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);
+    if (q)
+        query = query.ilike('course_name', `%${q}%`);
+    if (state)
+        query = query.eq('state', state.toUpperCase());
+    if (lat !== undefined && lng !== undefined) {
+        const r = radius_mi ?? 25;
+        const latDelta = r / 69.0;
+        const lngDelta = r / (69.0 * Math.cos(lat * Math.PI / 180));
+        query = query
+            .gte('latitude', lat - latDelta).lte('latitude', lat + latDelta)
+            .gte('longitude', lng - lngDelta).lte('longitude', lng + lngDelta);
+    }
+    const { data } = await query.limit(limit ?? 10);
+    const courses = (data ?? []).map((c) => ({
+        id: c.id,
+        name: c.course_name,
+        city: c.city,
+        state: c.state,
+        lat: c.latitude,
+        lng: c.longitude,
+        type: c.course_type,
+        par: c.par_total,
+        phone: c.phone,
+        website: c.website,
+    }));
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    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', {
+    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'),
+    ]);
+    if (courseRes.error || !courseRes.data) {
+        return { content: [{ type: 'text', text: 'Course not found' }] };
+    }
+    const c = courseRes.data;
+    const scorecard = (holesRes.data ?? []).map(h => ({
+        hole: h.hole_number,
+        par: h.par,
+    }));
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    id: c.id,
+                    name: c.course_name,
+                    city: c.city,
+                    state: c.state,
+                    lat: c.latitude,
+                    lng: c.longitude,
+                    type: c.course_type,
+                    par: c.par_total,
+                    holes: scorecard.length,
+                    phone: c.phone,
+                    website: c.website,
+                    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),
+            }],
+    };
+});
+// ── Start ──
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@opengolfapi/mcp-server",
+  "version": "1.0.0",
+  "description": "Free MCP server for AI agents to query the OpenGolfAPI dataset",
+  "type": "module",
+  "bin": {
+    "opengolfapi-mcp": "dist/index.js"
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/opengolfapi/mcp-server.git"
+  },
+  "keywords": ["mcp", "golf", "opengolfapi", "ai"],
+  "author": "OpenGolfAPI",
+  "license": "MIT",
+  "bugs": { "url": "https://github.com/opengolfapi/mcp-server/issues" },
+  "homepage": "https://opengolfapi.org",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@supabase/supabase-js": "^2.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}