WaveMaster AI

WaveMaster AI — Servidor MCP Oficial

Servidor oficial del Protocolo de Contexto de Modelos (MCP) para WaveMaster AI — una plataforma global de pronósticos de surf que monitorea más de 880 spots en 51 países.

Usa estas herramientas dentro de ChatGPT (Modo Desarrollador), Claude Desktop / Claude Code, Cursor, o cualquier cliente compatible con MCP para obtener pronósticos de surf en tiempo real, clasificaciones de mejores días y recomendaciones personalizadas impulsadas por NOAA + Open-Meteo + el motor propietario SurfScore de WaveMaster.

---

Endpoints

WaveMaster ofrece dos endpoints MCP. Ambos hablan MCP Streamable HTTP.

Endpoint	Autenticación	Herramientas	Caso de uso
Público — https://wosilzqqvhdmpdvhcfyu.supabase.co/functions/v1/mcp	Ninguna	8	Descubrimiento anónimo de surf: pronóstico, clasificaciones, comparaciones
Personal — https://wosilzqqvhdmpdvhcfyu.supabase.co/functions/v1/mcp-me	OAuth 2.1	3	Datos de usuario autenticado: favoritos, alertas activas, última sesión registrada

El endpoint Personal usa Supabase OAuth 2.1 con Registro Dinámico de Clientes — sin configuración manual de cliente, sin tokens que pegar. Aprueba una vez en wavemasterai.com.br y tu asistente actuará como tú.

---

Herramientas

Públicas (/mcp)

• get_forecast — pronóstico de surf de hoy (rango de altura de cara de ola, período, viento, SurfScore) para cualquier spot por nombre en texto libre (PT-BR).
• melhor_dia_da_semana — mejor día de los próximos 7 días en un spot determinado.
• melhores_praias_hoje — Top 10 de spots para surfear hoy en un país determinado.
• praias_perto_de_mim — spots de surf más cercanos para una lat/lng.
• comparar_spots — comparación lado a lado de múltiples spots.
• melhor_horario_hoje — mejor ventana horaria de hoy en un spot.
• recomendar_praia_nivel — recomendaciones filtradas por nivel de surfista (principiante/intermedio/avanzado).
• resumo_semana_pais — resumen semanal para la costa de un país.

Personales (/mcp-me — OAuth)

• meus_favoritos_hoje — condiciones de hoy para tus spots favoritos.
• meus_alertas_ativos — tus alertas de surf activas y su último estado de activación.
• minha_ultima_sessao — tu última sesión de surf registrada.

Esquemas completos en manifest.json y tools.json.

---

Inicio rápido

Claude Desktop / Claude Code

Añade a tu 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

Añade a ~/.cursor/mcp.json — misma estructura que arriba. Ver examples/cursor.json.

ChatGPT (Modo Desarrollador)

Configuración → Conectores → Avanzado → Modo Desarrollador → Añadir servidor → pega la URL del endpoint.

HTTP sin procesar (cualquier 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"}'

Más ejemplos en examples/.

---

OAuth (Endpoint Personal)

El endpoint /mcp-me es un servidor de recursos que verifica tokens de acceso OAuth 2.1 emitidos por Supabase. Los clientes que soportan Registro Dinámico de Clientes (Claude Desktop, ChatGPT Modo Dev, Cursor) se registran automáticamente — sin necesidad de client_id manual.

Flujo: el asistente descubre /.well-known/oauth-protected-resource → te redirige a wavemasterai.com.br/.lovable/oauth/consent → inicias sesión y apruebas → el asistente obtiene un token limitado a tu cuenta.

Detalles: docs/OAUTH.md.

---

Fuentes de datos y procedencia

• NOAA GFS-Wave — modelo global de oleaje
• Open-Meteo Marine + Weather — olas, viento y mareas por hora
• WaveMaster SurfScore — puntuación propietaria que combina energía de ola, período, alineación del viento y orientación local
• Alturas de ola reportadas en rango de altura de cara (estándar Surfline/MSW), no Hs crudo
• Los vectores de dirección apuntan hacia el origen del oleaje (estándar de la industria)

Cobertura: más de 880 spots monitoreados en 51 países y 6 continentes (conteo en tiempo real en las estadísticas de la plataforma).

---

Límites de tasa

• Endpoint público: 60 solicitudes/hora por cliente (límite flexible en memoria)
• Endpoint personal: llamadas autenticadas limitadas a los datos propios del usuario (aplicado por RLS)

---

Soporte y contacto

• Sitio web: wavemasterai.com.br
• Problemas en este repositorio para errores específicos de MCP o solicitudes de herramientas
• Errores de plataforma: usa el formulario de comentarios dentro de la aplicación

---

Licencia

MIT © WaveMaster AI