Skip to main content
La especificación pública está en openapi.json, usa OpenAPI 3.1.0 y apunta a:

Operaciones disponibles

La lista admite limit, cursor, updatedAfter y active. La consulta por identificador exige un UUID y devuelve 404 EMPLOYEE_NOT_FOUND cuando el empleado no existe dentro del tenant de la credencial.

Autenticación

Envía el token dedicado en el encabezado:
Los tokens de prueba usan el prefijo sp_test y no son válidos como credenciales de producción. No uses tokens Firebase ni envíes un company_id: el backend resuelve la empresa desde la credencial.

MCP

El servidor MCP público está en:
El MCP activo permite buscar y leer esta documentación y el OpenAPI desde clientes compatibles. Las dos consultas de empleados están marcadas selectivamente con x-mint.mcp, conservando la autenticación Bearer, pero su aparición como herramientas ejecutables depende de que el plan de Mintlify permita exponer endpoints OpenAPI. Mientras tools/list no las muestre, llama la API por HTTPS con tu token; no existe una credencial pública compartida.

Límites del contrato

Esta versión es de solo lectura y publica exclusivamente empleados. Las rutas administrativas, TimeClock, nómina, bancos, DGI, SIPE, notificaciones y proveedores permanecen fuera del contrato externo.