@opengolfapi/mcp-server 2.3.6 → 2.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +8 -0
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -422,6 +422,14 @@ server.tool('get_my_moments', 'Read back your own contributed moments (breadcrum
|
|
|
422
422
|
return { content: [{ type: 'text', text: `Error: ${e instanceof Error ? e.message : String(e)}` }] };
|
|
423
423
|
}
|
|
424
424
|
});
|
|
425
|
+
server.tool('how_to_build', 'The safe playbook for building on OpenGolfAPI and contributing data the right way. Call once before contributing.', {}, async () => ({ content: [{ type: 'text', text: 'BUILD ON OPENGOLFAPI — the safe playbook:\n' +
|
|
426
|
+
'1. READ free, no key (search/get tools).\n' +
|
|
427
|
+
'2. CONTRIBUTE: free key from courses.opengolfapi.org/api-keys → set OPENGOLFAPI_KEY.\n' +
|
|
428
|
+
'3. SIGNAL PRINCIPLE — send what you have. Breadcrumbs are the floor (phone GPS via submit_moment); richer signals (swing/putt/club/score) are additive and free. Emitting any signal is strictly dominant.\n' +
|
|
429
|
+
'4. SAFELY: pseudonymous player_id (no PII); dedup_key for idempotency (safe backfill); biometric/precise-location ONLY with explicit user consent; default presence to private.\n' +
|
|
430
|
+
'5. COURSE MISSING? Create from name + GPS — triggers our enrichment crawl, human-reviewed.\n' +
|
|
431
|
+
'6. BRIDGE AN APP: map fields to /api/v1/moments/fields + /api/v1/openshot/fields and POST (batch + dedup_key = safe backfill). Or have your AI write the adapter from /openapi.json.\n' +
|
|
432
|
+
'Contributing makes you a recognized member of the commons — every signal makes the shared data better for every golfer.' }] }));
|
|
425
433
|
// ── Start ──
|
|
426
434
|
async function main() {
|
|
427
435
|
// Greet developers in stderr — visible in Claude Desktop / Cursor MCP logs.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@opengolfapi/mcp-server",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.4.0",
|
|
4
4
|
"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.",
|
|
5
5
|
"mcpName": "io.github.opengolfapi/mcp-server",
|
|
6
6
|
"type": "module",
|