Golf Intelligence, by Stracka

Golf Intelligence, by Stracka. El conjunto de datos de campos de golf de mayor calidad para desarrolladores que crean una aplicación de golf. 20 años de mapeo propietario (láser, dron, avión, satélite), actualizado a diario. La búsqueda es gratuita. Tarjetas de puntuación, GPS y greens en 3D vía API. No es un scraping.

Golf Intelligence es un conjunto de datos propietario construido mediante el mapeo campo por campo, no un clon de una API de campos de golf de GitHub. Diez personas mapean cada día, y los datos se han actualizado continuamente desde 2007. Más información en golfintelligence.com.

Este repositorio es el plugin instalable de Cursor / Grok Bot con el identificador golf. La fuente de la aplicación del marketplace de Cursor es la URL pública de GitHub:

https://github.com/golf-data/golf

Los revisores del marketplace pueden enviar esa URL en cursor.com/marketplace/publish. El título del catálogo es Golf Intelligence, by Stracka.

El nombre oficial del Registro MCP es io.github.golf-data/golf. El registro no acepta un nombre golf simple. Los identificadores de Cursor, Agent Plugins y Claude Code siguen siendo golf.

Obtener acceso a la API

Cree una cuenta de API en console.golfintelligence.com y luego configure las dos variables requeridas del plugin:

• GI_CLIENT_ID: su Client ID

• GI_ACTIVE_TOKEN: su Active Token

El Active Token se intercambia por un token bearer de corta duración. No es un token bearer; no pegue un token bearer en GI_ACTIVE_TOKEN.

Planes:

• Personal: $49 por 50 créditos de prueba para su propia aplicación de Cursor, Grok o Claude. Comprar Personal.

• Starter: $399/mes por 10,000 créditos al lanzar una aplicación para otros usuarios. Envíe un correo a data@golfintelligence.com; Starter no tiene enlace de pago.

Preguntas sobre datos, planes o integración: data@golfintelligence.com.

Related MCP server: Korea Ground-Truth MCP

Herramientas y créditos

Busque siempre primero. search_course_groups es gratuito. Antes de cada llamada de pago, el usuario debe confirmar explícitamente el coste indicado; el servidor rechaza las herramientas de pago a menos que confirm_spend=true.

Autenticación

El servidor intercambia las credenciales configuradas con:

POST https://api.golfintelligence.com/auth/authenticateToken
grant_type=client_credentials
code=<GI_ACTIVE_TOKEN>
client_id=<GI_CLIENT_ID>

Envía el access_token devuelto como Authorization: Bearer <access_token>, lo almacena en caché solo en memoria y lo refresca una vez después de un HTTP 401. Las credenciales nunca se registran.

Streamable HTTP

El punto de entrada HTTP de producción sirve el transporte oficial MCP Streamable HTTP en /mcp y una comprobación de salud en /health. La forma prevista de la URL de dominio personalizado es:

https://mcp.golfintelligence.com/mcp

Este repositorio no afirma que esa URL esté activa; el DNS y el despliegue deben completarse antes de enviarla para revisión. Inicie el servidor HTTP localmente con:

npm run build
PORT=3000 npm run start:http

Se vincula a 0.0.0.0:$PORT. El punto de entrada stdio existente node dist/index.js y todos los paquetes de plugins permanecen sin cambios.

El servicio HTTP resuelve las credenciales de Golf Intelligence en este orden:

1. Los encabezados HTTP X-GI-Client-ID y X-GI-Active-Token proporcionados juntos en cada solicitud MCP.

2. Las variables de entorno GI_CLIENT_ID y GI_ACTIVE_TOKEN del lado del servidor.

Codex admite http_headers estáticos y env_http_headers respaldados por entorno para servidores MCP Streamable HTTP. Para la revisión de OpenAI, configure una cuenta de API de revisión dedicada como variables de entorno de despliegue o proporcione los dos encabezados personalizados si la configuración de revisión los admite. El Active Token sigue siendo una credencial de intercambio y no debe enviarse como valor Authorization: Bearer. Un despliegue de producción debe usar una cuenta dedicada con un límite de crédito adecuado porque las credenciales basadas en entorno hacen que las herramientas de búsqueda estén disponibles para cada llamador del endpoint público.

Cada herramienta anuncia explícitamente estas anotaciones MCP:

• readOnlyHint: true — cada herramienta solo recupera datos del campo.

• openWorldHint: false — ninguna herramienta escribe en sistemas públicos o externos.

• destructiveHint: false — ninguna herramienta elimina, sobrescribe, publica o envía nada.

• idempotentHint: true — repetir una búsqueda no tiene ningún efecto secundario adicional.

Estas frases también pueden usarse como justificaciones de anotación en el formulario de envío de OpenAI. Las búsquedas de pago aún requieren confirm_spend=true con los mismos costes de crédito documentados anteriormente.

Despliegue en contenedor

Dockerfile construye ambos transportes sin incrustar credenciales. fly.toml configura un pequeño servicio de Fly.io y comprueba /health. Antes del primer despliegue, confirme que el nombre de la aplicación Fly globalmente único esté disponible (o cambie app), luego establezca los secretos de ejecución y despliegue:

fly secrets set GI_CLIENT_ID=... GI_ACTIVE_TOKEN=...
fly deploy

Establezca el dominio personalizado solo después de que el endpoint *.fly.dev desplegado pase una comprobación de MCP Inspector. Este repositorio no realiza ningún despliegue.

Estructura del repositorio

• .cursor-plugin/plugin.json — manifiesto del marketplace de Cursor y variables requeridas

• plugin.json — manifiesto de estándar abierto de Agent Plugins (identificador golf)

• .claude-plugin/plugin.json — manifiesto de plugin de Claude Code / Cowork (identificador golf)

• server.json — metadatos oficiales del Registro MCP (io.github.golf-data/golf)

• manifest.json — manifiesto de paquete MCPB para el servidor Node stdio

• .github/workflows/publish-mcp.yml — publica io.github.golf-data/golf en el Registro MCP oficial mediante GitHub OIDC

• mcp.json — configuración del servidor MCP golf empaquetado

• skills/golf/SKILL.md — guía de flujo de trabajo y confirmación de gasto

• src/ — servidor MCP TypeScript y cliente de API

• dist/index.js — paquete ESM stdio confirmado usado por los instaladores

• dist/http.js — paquete ESM Streamable HTTP confirmado usado por el contenedor

• Dockerfile y fly.toml — contenedor HTTP de producción y servicio Fly.io

Para desarrollo con Node.js 18 o superior:

npm install
npm test
npm run build
npm run pack:mcpb

pack:mcpb usa la CLI oficial @anthropic-ai/mcpb pack para producir golf.mcpb y escribe su SHA-256 en server.json. GitHub Releases aloja ese activo en https://github.com/golf-data/golf/releases/download/v1.0.0/golf.mcpb.

El código del plugin está disponible bajo la Licencia MIT. Los datos de la API de Golf Intelligence siguen sujetos a los términos en golfintelligence.com.