Descripción general e inicio rápido

Elija REST o MCP

Ambas interfaces utilizan el mismo motor de cálculo y el mismo modelo de permisos. Utilice REST con una clave API para aplicaciones y scripts donde controle cada solicitud. Utilice MCP cuando un asistente o agente de IA deba descubrir las herramientas disponibles, comprender sus esquemas y elegir el cálculo correcto por sí mismo.

Autenticación

Dos métodos de inicio de sesión llegan al mismo motor de cálculo. Los clientes de IA interactivos se conectan al servidor MCP y autorizan el acceso en el navegador con OAuth. Las aplicaciones, servicios, scripts e integraciones manuales usan una clave Mariner GPS Tools API enviada como token Bearer. Las claves se pueden crear de forma gratuita y se pueden rotar o revocar en cualquier momento.

Authorization: Bearer mrt_live_...

Inicio rápido sobre REST

Envíe una solicitud JSON a cualquier terminal REST versionado utilizando su clave API. Las respuestas utilizan un consistenteok, data, yerrorestructura en todas las herramientas de cálculo.

curl -X POST https://marinergps.tools/api/v1/bearing \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "from": { "lat": 50.1, "lng": -4.2 },
    "to": { "lat": 49.8, "lng": -3.1 }
  }'

Inicio rápido sobre MCP

Añada la URL del servidor a un cliente de IA compatible y apruebe el acceso en su navegador cuando se abra la página de autorización de Mariner Tools. El cliente descubre automáticamente la configuración de inicio de sesión y las herramientas disponibles, sin claves ni tokens que copiar.

https://marinergps.tools/mcp

Alternativa: configuración manual con una clave API

Los clientes sin autorización en el navegador y las integraciones programáticas pueden enviar una clave API en su lugar:

{
  "mcpServers": {
    "mariner-tools": {
      "url": "https://marinergps.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Formato de respuesta REST

Las respuestas exitosas REST devuelven el resultado calculado endata. Los errores de validación y solicitud devuelven un código de error estable legible por máquina junto con un mensaje legible por humanos.

{
  "ok": true,
  "data": {
    "degrees": 112.7,
    "compass": "ESE"
  }
}

{
  "ok": false,
  "error": {
    "code": "invalid_request",
    "message": "Invalid bearing input."
  }
}