La API de IA que hay detrás de cada agente de SuperCognit
Una API REST para crear agentes y servidores MCP, asociar herramientas y conocimiento, leer todas las conversaciones y enviar eventos a tus sistemas. OpenAPI 3.1, autenticación por clave, sin SDK.
https://api.supercognit.com/v1Tu primera llamada
Sirve cualquier cliente HTTP — curl, tu backend, una herramienta de automatización u otro agente.
curl https://api.supercognit.com/v1/products \
-H "X-Api-Key: $SUPERCOGNIT_API_KEY"Autentícate con una clave del espacio de trabajo
Crea una clave en el panel y envíala en la cabecera X-Api-Key. Las claves tienen alcance de lectura o escritura y pueden limitarse a un único producto — así una integración solo toca lo que le has dado.
Qué cubre la API
Lo que haces en el panel también lo hace tu código — el mismo espacio de trabajo, los mismos recursos.
Productos
/v1/productsCrea, actualiza, publica y despublica agentes de chat y servidores MCP — prompt, resumen, slug y precio incluidos.
Herramientas
/v1/toolsGestiona la biblioteca de herramientas del espacio de trabajo: herramientas LLM, HTTP y estáticas, sus inputs y qué productos las usan.
Bases de conocimiento
/v1/knowledge-basesLista el conocimiento que sostiene tus respuestas y comprueba a qué productos está asociada cada base.
Conversaciones
/v1/sessionsLee conversaciones y transcripciones completas — cada mensaje, modelo y recuento de tokens, listos para tu analítica o tu CRM.
Webhooks
/v1/webhooksRegistra endpoints, revisa entregas y reintentos y reactiva un endpoint sin abrir el panel.
Monedero
/v1/walletConsulta el saldo de créditos de uso y cada recarga, cargo y reembolso.
Usuarios finales
/v1/verify-userValida un token de sesión en tu servidor, para que tu aplicación sepa con quién está hablando.
Qué construyen los equipos con ella
Un agente por cliente
Agencias y equipos de SaaS crean, configuran y publican un agente por cliente desde su propio onboarding — sin pasar por el panel.
Conversaciones en tu CRM
Envía cada conversación y cada contacto capturado a HubSpot, Salesforce o tu propia base de datos, según ocurren.
Conocimiento siempre al día
Actualiza una fuente de conocimiento cuando cambia tu documentación, para que las respuestas sigan al producto en vez de quedarse atrás.
Uso que puedes facturar
Lee el monedero y las transcripciones para saber exactamente qué consumió una cuenta y cóbralo dentro de tu propio producto.
Eventos, enviados a ti
Registra un endpoint y SuperCognit envía JSON por POST según ocurren las conversaciones. Cada petición va firmada con HMAC-SHA256 sobre el cuerpo original, se reintenta hasta cinco veces con espera exponencial y queda en un registro de entregas con el estado de la respuesta.
- conversation.created — alguien inició una conversación nueva
- message.created — se envió un mensaje, de un visitante o del agente
- message.completed — el agente terminó su respuesta
REST para tus sistemas, MCP para clientes de IA
La API es cómo tu código gobierna SuperCognit. MCP es cómo los clientes de IA — Claude, Cursor, tus propios agentes — usan lo que publicas. Ambos corren sobre el mismo espacio de trabajo, así que una herramienta creada una vez es accesible por los dos caminos.
Ver servidores MCP →Preguntas de quien programa
Sí. Todos los planes incluyen acceso a la API sin coste adicional — pagas tu plan y el uso que generan tus agentes, igual que desde el panel. La prueba gratuita de 7 días también la incluye.
Con una clave de API del espacio de trabajo, enviada en la cabecera X-Api-Key. Las claves declaran alcances — se necesita escritura para todo lo que no sea un GET — y una clave puede limitarse a un único producto, en cuyo caso no toca recursos del espacio de trabajo como herramientas, bases de conocimiento o webhooks.
No. Es REST sobre JSON, así que sirve cualquier cliente HTTP. El documento OpenAPI 3.1 es público, de modo que también puedes generar un cliente tipado en el lenguaje que prefieras en un par de minutos.
Sí. Crea el producto, asocia herramientas y bases de conocimiento y publícalo — el mismo ciclo que usa el panel. Así es como los equipos aprovisionan automáticamente un agente por cliente.
La plataforma ejecuta un modelo curado detrás de tus agentes, así que tu integración nunca maneja claves de proveedores ni nombres de modelos. Tú construyes y lanzas el agente; nosotros mantenemos el modelo al día por debajo.
De dos formas: leyendo los endpoints de conversaciones para sesiones y transcripciones, o registrando un webhook y recibiendo cada mensaje en el momento. La mayoría de equipos usa webhooks para tiempo real y los endpoints para el histórico.
Construye con la API
Crea un espacio de trabajo, genera una clave y lanza tu integración — gratis durante 7 días.