Golf Intelligence, by Stracka

Golf Intelligence, by Stracka

Golf Intelligence, by Stracka. O conjunto de dados de campos de golfe da mais alta qualidade para desenvolvedores que estão criando um aplicativo de golfe. 20 anos de mapeamento proprietário (laser, drone, avião, satélite), atualizado diariamente. A busca é gratuita. Scorecards, GPS, e greens 3D via API. Não é um scrape.

Golf Intelligence é um conjunto de dados proprietário construído por meio de mapeamento campo a campo, não um clone de uma API de campos de golfe do GitHub. Dez pessoas mapeiam todos os dias, e os dados são atualizados continuamente desde 2007. Saiba mais em golfintelligence.com.

Este repositório é o plugin instalável do Cursor / Grok Bot com o handle golf. O código-fonte do aplicativo do marketplace do Cursor é a URL pública do GitHub:

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

Revisores do marketplace podem enviar essa URL em cursor.com/marketplace/publish. O título do catálogo é Golf Intelligence, by Stracka.

O nome oficial do Registro MCP é io.github.golf-data/golf. O registro não aceita um nome golf simples. Os handles de plugins do Cursor, Agent Plugins e Claude Code permanecem como golf.

Obtenha acesso à API

Crie uma Conta de API em console.golfintelligence.com e, em seguida, configure as duas variáveis obrigatórias do plugin:

• GI_CLIENT_ID: seu Client ID
• GI_ACTIVE_TOKEN: seu Active Token

O Active Token é trocado por um bearer token de curta duração. Ele não é um bearer token; não cole um bearer token em GI_ACTIVE_TOKEN.

Planos:

• Personal: US$ 49 por 50 créditos de teste para seu aplicativo Cursor, Grok ou Claude de uso próprio. Comprar Personal.
• Starter: US$ 399/mês por 10.000 créditos ao disponibilizar um aplicativo para outros usuários. Envie um e-mail para data@golfintelligence.com; o Starter não tem link de checkout.

Dúvidas sobre dados, planos ou integração: data@golfintelligence.com.

Ferramentas e créditos

Sempre busque primeiro. search_course_groups é gratuito. Antes de cada chamada paga, o usuário deve confirmar explicitamente o custo informado; o servidor recusa ferramentas pagas a menos que confirm_spend=true.

Ferramenta	O que retorna	Créditos
search_course_groups	Resultados de busca por grupo de campos	0
get_course_group_scorecard	Dados de scorecard	1
get_course_group_gps	Geometria e coordenadas mapeadas do campo	2
get_course_group_detail	Dados detalhados do grupo de campos	3
get_green_slope_image	Imagem de inclinação do green em retrato ou quadrado	1

Autenticação

O servidor troca as credenciais configuradas com:

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

Ele envia o access_token retornado como Authorization: Bearer <access_token>, armazena em cache apenas em memória e atualiza uma vez após um HTTP 401. As credenciais nunca são registradas em logs.

HTTP Streamable

O endpoint HTTP de produção serve o transporte oficial MCP Streamable HTTP em /mcp e uma verificação de saúde em /health. O formato pretendido de URL de domínio personalizado é:

https://mcp.golfintelligence.com/mcp

Este repositório não garante que essa URL esteja ativa; DNS e implantação devem ser concluídos antes de enviá-la para revisão. Inicie o servidor HTTP localmente com:

npm run build
PORT=3000 npm run start:http

Ele vincula a 0.0.0.0:$PORT. O endpoint stdio node dist/index.js existente e todos os pacotes de plugins permanecem inalterados.

O serviço HTTP resolve as credenciais do Golf Intelligence nesta ordem:

1. X-GI-Client-ID e X-GI-Active-Token cabeçalhos HTTP fornecidos juntos em cada solicitação MCP.
2. Variáveis de ambiente GI_CLIENT_ID e GI_ACTIVE_TOKEN no lado do servidor.

O Codex suporta http_headers estático e env_http_headers baseado em ambiente para servidores MCP HTTP Streamable. Para revisão da OpenAI, configure uma conta de API de revisão dedicada como variáveis de ambiente de implantação ou forneça os dois cabeçalhos personalizados se a configuração de revisão os suportar. O Active Token permanece uma credencial de troca e não deve ser enviado como um valor de Authorization: Bearer. Uma implantação de produção deve usar uma conta dedicada com um limite de crédito apropriado, pois as credenciais baseadas em ambiente disponibilizam as ferramentas de consulta para todos os chamadores do endpoint público.

Cada ferramenta anuncia explicitamente estas anotações MCP:

• readOnlyHint: true — cada ferramenta apenas recupera dados do campo.
• openWorldHint: false — nenhuma ferramenta grava em sistemas públicos ou externos.
• destructiveHint: false — nenhuma ferramenta exclui, sobrescreve, publica ou envia qualquer coisa.
• idempotentHint: true — repetir uma consulta não tem efeito colateral adicional.

Essas frases também podem ser usadas como justificativas de anotação no formulário de envio da OpenAI. Consultas pagas ainda exigem confirm_spend=true com os mesmos custos de crédito documentados acima.

Implantação em contêiner

Dockerfile compila ambos os transportes sem incorporar credenciais. fly.toml configura um pequeno serviço Fly.io e verifica /health. Antes da primeira implantação, confirme se o nome do aplicativo Fly globalmente exclusivo está disponível (ou altere app) e, em seguida, defina os segredos de tempo de execução e implante:

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

Defina o domínio personalizado somente depois que o endpoint *.fly.dev implantado passar em uma verificação do MCP Inspector. Nenhuma implantação é realizada por este repositório.

Estrutura do repositório

• .cursor-plugin/plugin.json — manifesto do marketplace do Cursor e variáveis obrigatórias
• plugin.json — manifesto de padrão aberto do Agent Plugins (handle golf)
• .claude-plugin/plugin.json — manifesto do plugin Claude Code / Cowork (handle golf)
• server.json — metadados oficiais do Registro MCP (io.github.golf-data/golf)
• manifest.json — manifesto do pacote MCPB para o servidor Node stdio
• .github/workflows/publish-mcp.yml — publica io.github.golf-data/golf no Registro MCP oficial via GitHub OIDC
• mcp.json — configuração do servidor MCP golf empacotado
• skills/golf/SKILL.md — orientação sobre fluxo de trabalho e confirmação de gastos
• src/ — servidor MCP TypeScript e cliente de API
• dist/index.js — pacote ESM stdio confirmado usado pelos instaladores
• dist/http.js — pacote ESM HTTP Streamable confirmado usado pelo contêiner
• Dockerfile e fly.toml — contêiner HTTP de produção e serviço Fly.io

Para desenvolvimento com Node.js 18 ou mais recente:

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

pack:mcpb usa a CLI oficial @anthropic-ai/mcpb pack para produzir golf.mcpb e grava seu SHA-256 em server.json. O GitHub Releases hospeda esse ativo em https://github.com/golf-data/golf/releases/download/v1.0.0/golf.mcpb.

O código do plugin está disponível sob a Licença MIT. Os dados da API do Golf Intelligence permanecem sujeitos aos termos em golfintelligence.com.