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, actualizado a diario, con tarjetas de puntuación, GPS y greens en 3D vía API.

GitHubPrueba este MCPPatrocinado

Documentación

Golf Intelligence, by Stracka

Golf Intelligence, by Stracka. El conjunto de datos de campos de golf de la más alta 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 3D vía API. No es un raspado de datos.

Golf Intelligence es un conjunto de datos propietario construido mediante 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. Obtén más información en golfintelligence.com.

Este repositorio es el plugin instalable para Cursor / Grok Bot con el identificador golf. El código 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 simple de golf. Los identificadores de plugin de Cursor, Agent Plugins y Claude Code permanecen como golf.

Obtén acceso a la API

Crea una Cuenta de API en console.golfintelligence.com, luego configura las dos variables requeridas del plugin:

GI_CLIENT_ID: tu ID de Cliente
GI_ACTIVE_TOKEN: tu Token Activo

El Token Activo se intercambia por un token de portador de corta duración. No es un token de portador; no pegues un token de portador en GI_ACTIVE_TOKEN.

Planes:

Personal: $49 por 50 créditos de prueba para tu 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ía un correo a data@golfintelligence.com; Starter no tiene un enlace de pago.

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

Herramientas y créditos

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

Herramienta	Qué devuelve	Créditos
`search_course_groups`	Resultados de búsqueda de grupos de campos	0
`get_course_group_scorecard`	Datos de tarjeta de puntuación	1
`get_course_group_gps`	Geometría y coordenadas del campo mapeado	2
`get_course_group_detail`	Datos detallados del grupo de campos	3
`get_green_slope_image`	Imagen de pendiente del green en vertical o cuadrado	1

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.

HTTP Streamable

El punto de entrada HTTP de producción sirve el transporte oficial MCP Streamable HTTP en /mcp y una verificación de salud en /health. La forma prevista de 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. Inicia 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:

X-GI-Client-ID y X-GI-Active-Token cabeceras HTTP proporcionadas juntas en cada solicitud MCP.
Variables de entorno del lado del servidor GI_CLIENT_ID y GI_ACTIVE_TOKEN.

Codex admite http_headers estático y env_http_headers respaldado por entorno para servidores MCP Streamable HTTP. Para la revisión de OpenAI, configura una cuenta de API de revisión dedicada como variables de entorno de despliegue o proporciona las dos cabeceras personalizadas si la configuración de revisión las admite. El Token Activo sigue siendo una credencial de intercambio y no debe enviarse como un valor de Authorization: Bearer. Un despliegue de producción debe usar una cuenta dedicada con un límite de crédito apropiado 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 de campos.
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 efectos secundarios adicionales.

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 a los mismos costos 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 verifica /health. Antes del primer despliegue, confirma que el nombre de la aplicación de Fly sea globalmente único y esté disponible (o cambia app), luego establece los secretos de ejecución y despliega:

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

Establece el dominio personalizado solo después de que el endpoint *.fly.dev desplegado pase una verificació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 vía 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 de Fly.io

Para desarrollo con Node.js 18 o más reciente:

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

pack:mcpb usa el 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.