WaveMaster AI

WaveMaster AI — Servidor MCP Oficial

Servidor oficial do Model Context Protocol (MCP) para WaveMaster AI — uma plataforma global de previsão de surfe que monitora mais de 880 pontos em 51 países.

Use estas ferramentas dentro do ChatGPT (Modo Desenvolvedor), Claude Desktop / Claude Code, Cursor ou qualquer cliente compatível com MCP para obter previsões de surfe em tempo real, rankings de melhores dias e recomendações personalizadas com tecnologia NOAA + Open-Meteo + o mecanismo proprietário SurfScore da WaveMaster.

---

Endpoints

A WaveMaster oferece dois endpoints MCP. Ambos usam MCP Streamable HTTP.

Endpoint	Autenticação	Ferramentas	Caso de uso
Público — https://wosilzqqvhdmpdvhcfyu.supabase.co/functions/v1/mcp	Nenhuma	8	Descoberta anônima de surfe: previsão, rankings, comparações
Pessoal — https://wosilzqqvhdmpdvhcfyu.supabase.co/functions/v1/mcp-me	OAuth 2.1	3	Dados do usuário conectado: favoritos, alertas ativos, última sessão registrada

O endpoint Pessoal usa Supabase OAuth 2.1 com Registro Dinâmico de Cliente — sem configuração manual, sem tokens para colar. Aprove uma vez em wavemasterai.com.br e seu assistente age como você.

---

Ferramentas

Públicas (/mcp)

• get_forecast — previsão de surfe de hoje (intervalo de altura da face da onda, período, vento, SurfScore) para qualquer ponto por nome em texto livre (PT-BR).
• melhor_dia_da_semana — melhor dia dos próximos 7 dias em um determinado ponto.
• melhores_praias_hoje — Top 10 pontos para surfar hoje em um determinado país.
• praias_perto_de_mim — pontos de surfe mais próximos para uma latitude/longitude.
• comparar_spots — comparação lado a lado de vários pontos.
• melhor_horario_hoje — melhor janela de horário hoje em um ponto.
• recomendar_praia_nivel — recomendações filtradas por nível do surfista (iniciante/intermediário/avançado).
• resumo_semana_pais — resumo semanal para o litoral de um país.

Pessoais (/mcp-me — OAuth)

• meus_favoritos_hoje — condições de hoje para seus pontos favoritos.
• meus_alertas_ativos — seus alertas de surfe ativos e o estado do último disparo.
• minha_ultima_sessao — sua última sessão de surfe registrada.

Esquemas completos em manifest.json e tools.json.

---

Início rápido

Claude Desktop / Claude Code

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "wavemaster": {
      "url": "https://wosilzqqvhdmpdvhcfyu.supabase.co/functions/v1/mcp"
    },
    "wavemaster-me": {
      "url": "https://wosilzqqvhdmpdvhcfyu.supabase.co/functions/v1/mcp-me"
    }
  }
}

Cursor

Adicione ao ~/.cursor/mcp.json — mesma estrutura acima. Veja examples/cursor.json.

ChatGPT (Modo Desenvolvedor)

Configurações → Conectores → Avançado → Modo Desenvolvedor → Adicionar servidor → cole a URL do endpoint.

HTTP bruto (qualquer cliente)

curl -s https://wosilzqqvhdmpdvhcfyu.supabase.co/functions/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Mais exemplos em examples/.

---

OAuth (endpoint Pessoal)

O endpoint /mcp-me é um servidor de recursos que verifica tokens de acesso OAuth 2.1 emitidos pelo Supabase. Clientes que suportam Registro Dinâmico de Cliente (Claude Desktop, ChatGPT Modo Dev, Cursor) se registram automaticamente — sem necessidade de client_id manual.

Fluxo: o assistente descobre /.well-known/oauth-protected-resource → redireciona você para wavemasterai.com.br/.lovable/oauth/consent → você entra e aprova → o assistente recebe um token com escopo para sua conta.

Detalhes: docs/OAUTH.md.

---

Fontes de dados e procedência

• NOAA GFS-Wave — modelo global de swell
• Open-Meteo Marine + Weather — ondas, vento e marés por hora
• WaveMaster SurfScore — pontuação proprietária que combina energia da onda, período, alinhamento do vento e orientação local
• Alturas de onda reportadas em intervalo de altura da face (padrão Surfline/MSW), não Hs bruto
• Vetores de direção apontam para a origem do swell (padrão da indústria)

Cobertura: mais de 880 pontos monitorados em 51 países e 6 continentes (contagem em tempo real nas estatísticas da plataforma).

---

Limites de taxa

• Endpoint público: 60 requisições/hora por cliente (limite flexível em memória)
• Endpoint pessoal: chamadas autenticadas com escopo nos dados do próprio usuário (aplicado por RLS)

---

Suporte e contato

• Site: wavemasterai.com.br
• Problemas neste repositório para bugs específicos do MCP ou solicitações de ferramentas
• Bugs da plataforma: use o formulário de feedback no aplicativo

---

Licença

MIT © WaveMaster AI