MarginTide — Guía del servidor MCP

• robot_2Sin humano en el procesoTu cliente MCP lee instantáneas de precios, acepta recomendaciones seguras y activa ejecuciones sin que nadie abra el panel.
• tuneRespeta los límites del planCada llamada a una herramienta respeta los mismos límites de unidades de investigación y de frecuencia que el panel. Las llamadas que exceden el límite devuelven un error accionable con la fecha de reinicio.
• boltDiseño centrado en instantáneasget_pricing_snapshot devuelve el catálogo, los precios de la competencia y la recomendación abierta en una sola llamada — 2 idas y vueltas para responder «¿dónde estamos sobrevalorados?»

workspace_premiumRequiere el plan Max o Empresarial. Actualiza o consulta la API REST para acceso sin MCP en cualquier plan.

1. 1. Agrega la URL del servidor a tu cliente: https://www.margintide.com/api/mcp.
2. 2. Tu cliente te redirige para iniciar sesión y aprobar la conexión — elige el espacio de trabajo y revisa los permisos.
3. 3. Aprueba para terminar. Tu cliente muestra las herramientas de inmediato según el espacio de trabajo y los permisos otorgados.

Puedes revisar o desconectar cualquier asistente en cualquier momento desde Administrar asistentes conectados.

Los clientes que no admiten OAuth siguen funcionando con un token pck_ — consulta los pasos de configuración a continuación.

Ve a Configuración → Claves de API y crea un nuevo token. Selecciona los alcances que tu cliente MCP necesita:

El prefijo del token es pck_…. Cópialo ahora — se muestra solo una vez.

Agrega el servidor de MarginTide a la configuración de tu cliente. El servidor habla el protocolo MCP 2025-06-18 sobre HTTP en streaming (sin estado — no requiere sesión SSE).

{
  "mcpServers": {
    "price-checker": {
      "url": "https://www.margintide.com/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer pck_YOUR_TOKEN_HERE"
      }
    }
  }
}

{
  "mcpServers": {
    "price-checker": {
      "url": "https://www.margintide.com/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer pck_YOUR_TOKEN_HERE"
      }
    }
  }
}

Después de conectar tu cliente, llama a tools/list (o pídele a tu cliente MCP que «liste las herramientas disponibles»). Deberías ver las herramientas que los alcances de tu token permiten. Si ves una lista vacía, revisa tus alcances — una herramienta solo aparece cuando tu token tiene todos los alcances requeridos.

# Quick smoke-check with curl (JSON-RPC over HTTP)
curl -s -X POST https://www.margintide.com/api/mcp \
  -H "Authorization: Bearer pck_YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

• Un token de API o una autorización OAuth por espacio de trabajo: emitir un token, o aprobar una conexión OAuth, siempre lo limita a exactamente un espacio de trabajo.
• N espacios de trabajo significan N conexiones MCP independientes en tu cliente — una entrada de cliente (o autorización OAuth) por cada espacio de trabajo al que necesites acceso simultáneo.
• Cambiar de espacio de trabajo significa cambiar de clave: apunta tu cliente a un token distinto (o a una autorización OAuth distinta) para dirigirte a otro espacio de trabajo.
• El límite de 60 solicitudes por minuto se aplica por clave y se comparte con la API REST — las llamadas MCP y REST realizadas con el mismo token consumen el mismo presupuesto.

El campo instructions del servidor (devuelto en initialize) le enseña a su agente cómo combinar las herramientas de forma eficiente:

1. Llame primero a get_pricing_snapshot; combina los datos del catálogo, los precios de la competencia y la recomendación abierta en una sola llamada (ahorra 2 o más viajes de ida y vuelta frente a encadenar llamadas de listado).
2. Revise la instantánea y luego llame a accept_recommendation o dismiss_recommendation solo después de confirmar la acción con el usuario.
3. Después de llamar a trigger_run, consulte get_run_status periódicamente hasta que la ejecución alcance un estado terminal y luego lea los resultados con get_latest_run_results.