Tomatina MCP Server

Punto de conexión oficial

Tomatina MCP Server

Conecta agentes de IA y clientes compatibles con MCP a la API pública de Tomatina mediante un catálogo versionado y controlado de herramientas.

Servicio operativo Mutaciones habilitadas Streamable HTTP
apitomatina-2026-09-05.1Release contractual
4.6.1API surface
109Tools publicadas
4Operaciones excluidas

Cómo conectarse

El endpoint no es una API REST navegable: utiliza MCP Streamable HTTP stateless y recibe solicitudes JSON-RPC por POST.

  1. Cliente compatible con MCPConfigure un cliente que soporte el transporte Streamable HTTP.
  2. Token API de TomatinaUtilice un Xtz-Token activo con los permisos necesarios para las tools que consumirá.
  3. Credencial server-sideEnvíe el token como Bearer o mediante el header Xtz-Token. No lo exponga en frontend.
  4. Control de escriturasLas operaciones de escritura requieren aprobación, confirmación exacta e idempotency key.
Configuración genérica de cliente MCP
{
  "url": "https://mcp.tomatina.cloud/mcp",
  "headers": {
    "Authorization": "Bearer <XTZ_TOKEN>"
  }
}

Endpoint: https://mcp.tomatina.cloud/mcp. Si se envían ambos headers de autenticación, sus valores deben coincidir.

Capacidades disponibles

El release activo publica 109 tools: 61 de lectura y 48 que representan operaciones de escritura. La disponibilidad efectiva también depende de los permisos del token.

Mensajería

20 tools

Envío, consulta, respuestas, reacciones y operaciones sobre mensajes.

Notificaciones

11 tools

Consulta, creación y administración de notificaciones operativas.

CRM y casos

18 tools

Contactos CRM, casos, asignaciones, estados, etiquetas y timeline.

Calendario

10 tools

Disponibilidad, eventos, participantes, estados y agenda compartida.

Formularios

9 tools

Formularios, submissions y acciones asociadas a contactos y casos.

Contactos y etiquetas

11 tools

Directorio operativo, información de contactos y clasificación.

Instancias y usuarios

6 tools

Consulta de conexiones, agentes y recursos autorizados de la cuenta.

Catálogos y grupos

17 tools

Catálogos auxiliares, campañas, grupos y metadatos de configuración.

Inteligencia artificial

2 tools

Solicitudes de IA disponibles dentro del contrato público.

SMTP

1 tools

Envío SMTP explícito mediante la operación pública soportada.

Otras capacidades

4 tools

Operaciones adicionales publicadas por el contrato activo.

Seguridad y alcance

El servidor no almacena el token ni reemplaza las validaciones de Tomatina. Cada llamada conserva el tenant, los permisos y las reglas de negocio del Xtz-Token presentado.

  • No utilice una API key de OpenAI en este endpoint.
  • No coloque tokens en URLs, repositorios ni logs.
  • Restrinja las tools permitidas en cada agente.
  • Exija aprobación humana antes de una mutación.

Documentación y diagnóstico

Consulte los manuales para conocer los parámetros y variantes de cada endpoint. El health check sólo publica estado técnico y no requiere autenticación.