Obligatorio antes de cualquier otra herramienta si no hay sesión. Sin argumentos: abre el navegador en /device (estilo gh auth login). También acepta access_token (ztk_...) manualmente.

Devuelve el usuario asociado al token del agente (sesión MCP), no la del navegador.

Borra el token cacheado del agente (~/.kairo/). La próxima llamada pedirá autorización de nuevo.

Lista los documentos visibles para el usuario del token, respetando reglas de Estudio (owner/socio/abogado).

Obtiene un documento por id con sus firmas (si el usuario lo puede ver).

Descarga el PDF original de un documento y devuelve metadata + bytes en base64.

Lista los estudios donde el usuario es miembro junto con su rol y áreas.

Devuelve una URL para abrir en el navegador y firmar con mouse/touch. Modo 'account': firma completa con tu cuenta (PIN, firma guardada, certificado fuerte) — requiere sesión iniciada en el browser. Modo 'external': link efímero sin login (duración según settings del usuario). No intentes firmar desde la terminal: la experiencia con canvas no es usable ahí.

Hace polling hasta que el documento se firme o se agote el tiempo. Usá los waitParams que devuelve kairo_get_sign_url. Cuando signed=true, incluye verifyUrl para ver el certificado.

Preferí kairo_get_sign_url(mode=external) o kairo_sign_workflow. Crea link externo con share links.

Lista los pedidos de firma externa (token efímero) abiertos para un documento.

Invalida un pedido de firma externa (el link deja de funcionar inmediatamente). Requiere scope 'write'.

Crea un nuevo estudio (requiere plan Premium y scope 'write'). Devuelve el estudio creado.

Verifica una firma de Zyta a partir del hash del documento. No requiere subir el PDF.

Sube un PDF a Zyta. Requiere scope 'write'. Devuelve el documento creado o error 409 si es duplicado (usá force=true para subir igual).

Cambia el alias de un documento que subiste. Requiere scope 'write'.

Elimina un documento que subiste (y sus firmas asociadas). Requiere scope 'write'.

Descarga el PDF estampado de una firma. Podés acceder si ves el documento (incluye firmas del estudio).

Devuelve el certificado JSON de una firma (incluye verifyUrl). Requiere ver el documento.

Lista la biblioteca de firmas guardadas del usuario (nombre, DNI, CUIL opcionales).

Guarda una firma en la biblioteca. Requiere scope 'write'. La imagen PNG en base64 es obligatoria.

Modifica datos y/o imagen de un preset. Requiere scope 'write'.

Elimina un preset de la biblioteca. Requiere scope 'write'.

Obtiene un estudio con áreas, miembros y tu rol.

Cambia el nombre de un estudio. Requiere rol de gestión y scope 'write'.

Elimina un estudio definitivamente. Requiere rol de gestión y scope 'write'.

Crea un área dentro de un estudio. Requiere gestión y scope 'write'.

Cambia el nombre de un área. Requiere gestión y scope 'write'.

Elimina un área del estudio. Los documentos quedan sin área. Requiere scope 'write'.

Invita a un usuario registrado por email. Roles: socio o abogado. Requiere scope 'write'.

Cambia rol y/o área de un miembro. Requiere scope 'write'.

Elimina a un miembro del estudio. Requiere scope 'write'.

Devuelve plan (free/premium), features, firmas usadas este mes y límite.

Sube un PDF y verifica contra signatureId o certificado JSON.

Varios PDFs en un solo link. Mínimo 2 documentos.

Sube PDF, crea link externo, devuelve share links.