Isaak Platform API · Beta

Conecta tu software a Isaak.

API REST y protocolo MCP para automatizar facturas, emisión a VeriFactu y contabilidad en tiempo real. Integra en minutos desde cualquier entorno.

Empezar en 5 minutos Obtener API key

REST API

10 endpoints REST. Referencia interactiva con OpenAPI 3.1 — prueba peticiones directamente desde el navegador.

Abrir referencia

Protocolo MCP

Conecta Claude, ChatGPT u otro agente. 9 herramientas que Isaak entiende de forma nativa.

Ver MCP tools

Acceso beta

Solicita acceso anticipado. API keys disponibles desde tu cuenta. Sin límite durante la fase beta.

Solicitar acceso

MCP Inspector

Depura cualquier conector MCP desde el navegador. Un solo comando, sin instalación. Compatible con Claude, ChatGPT e Isaak.

Cómo usar el Inspector

Autenticación

Bearer token en cada petición

Todas las peticiones requieren un API key en la cabecera Authorization. Las keys se crean desde tu panel de Isaak y pueden revocarse en cualquier momento.

Producción

Authorization: Bearer isk_live_...

Acceso real a datos de tu empresa. Acciones hacia AEAT son definitivas.

Test / Sandbox

Authorization: Bearer isk_test_...

Datos simulados. Las emisiones a VeriFactu no se registran en AEAT.

Acciones irreversibles: Los endpoints que envían datos a AEAT requieren un paso de confirmación en dos tiempos. La primera llamada devuelve un preview y un token temporal; la segunda confirma la acción.

Quickstart

Tu primera factura en 5 minutos

Solo necesitas tu API key. El flujo completo: listar → crear borrador → emitir a AEAT.

Terminal

# 1. Lista tus facturas
curl https://isaak.verifactu.business/api/v1/invoices \
  -H "Authorization: Bearer isk_live_TU_API_KEY"

# 2. Crea un borrador
curl -X POST https://isaak.verifactu.business/api/v1/invoices \
  -H "Authorization: Bearer isk_live_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "clientName": "Cliente SL",
    "clientNif": "B87654321",
    "lines": [{ "description": "Consultoría", "quantity": 1, "unitPrice": 1000 }]
  }'

# 3. Emite a AEAT (requiere confirmación)
curl -X POST https://isaak.verifactu.business/api/v1/invoices/FACTURA_ID/issue \
  -H "Authorization: Bearer isk_live_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "confirmationToken": "TOKEN_DEL_PASO_PREVIO" }'

Consulta la referencia completa de endpoints para ver todos los parámetros disponibles.

Documentación detallada

Referencia, errores, límites y eventos

Todo lo que necesitas para construir integraciones robustas con Isaak. La referencia interactiva te deja ejecutar peticiones reales; las páginas dedicadas profundizan en casos límite.

Tutoriales

Guías paso a paso

Primera factura via cURL, webhooks con HMAC, conectar Holded, MCP en Claude Desktop. Código real, copy-paste.

Abrir guías

Interactivo

API Reference

OpenAPI 3.1 renderizado con Scalar. Esquemas, ejemplos por lenguaje, peticiones ejecutables con tu propia API key.

Abrir referencia

Referencia

Error codes

Códigos HTTP, error.code de aplicación, formato del envelope y guía de retry con backoff exponencial.

Ver códigos

Política

Rate limits

Límites por plan y por familia de endpoint. Headers de inspección. Recetario de burst y fairness.

Ver política

Beta cerrada

Webhooks

Eventos en tiempo real: factura emitida, validación AEAT, certificado a caducar. Firmas HMAC, reintentos, dead-letter.

Ver eventos

Referencia API

Endpoints disponibles

Base URL: https://isaak.verifactu.business

Método	Endpoint	Descripción	Scope
GET	`/api/v1/companies/current`	Datos fiscales de la empresa activa	`company.read`
GET	`/api/v1/invoices`	Listado de facturas con filtros opcionales	`invoices.read`
POST	`/api/v1/invoices`	Crear borrador de factura	`invoices.write`
GET	`/api/v1/invoices/:id`	Detalle completo de una factura	`invoices.read`
GET	`/api/v1/invoices/:id/pdf`	PDF firmado con QR VeriFactu	`invoices.read`
POST	`/api/v1/invoices/:id/issue`	Emitir factura a AEAT (irreversible, requiere token)	`invoices.issue`
GET	`/api/v1/verifactu/status`	Estado del servicio VeriFactu y registros AEAT	`verifactu.read`
GET	`/api/v1/audit/events`	Historial de acciones (auditoría)	`audit.read`
GET	`/api/v1/keys`	Listar tus API keys activas	`keys.read`
POST	`/api/v1/keys`	Crear nueva API key	`keys.write`

Todas las respuestas siguen el formato estándar: { "ok": true, "data": {}, "meta": { "requestId": "...", "timestamp": "..." } }

MCP — Model Context Protocol

Conecta Claude o ChatGPT a tu empresa

El servidor MCP de Isaak expone 9 herramientas que cualquier agente compatible puede usar para leer y actuar sobre tus datos fiscales. Funciona con Claude Desktop, Claude API y ChatGPT con conectores personalizados.

claude_desktop_config.json

{
  "mcpServers": {
    "isaak": {
      "url": "https://isaak.verifactu.business/api/mcp/isaak",
      "headers": {
        "Authorization": "Bearer isk_live_TU_API_KEY"
      }
    }
  }
}

Herramientas disponibles

isaak_get_company_context

Obtiene el contexto fiscal de la empresa

isaak_list_invoices

Lista facturas con filtros de fecha y estado

isaak_get_invoice

Detalle de una factura por ID o número

isaak_create_invoice_draft

Crea un borrador de factura

isaak_validate_verifactu_invoice

Valida datos antes de emitir a AEAT

isaak_issue_verifactu_invoice

Emite la factura a AEAT (con confirmación)

isaak_get_verifactu_status

Estado del registro en AEAT

isaak_get_fiscal_summary

Resumen fiscal del periodo

isaak_propose_action

Propone acciones fiscales a Isaak

MCP Inspector

Inspecciona y prueba cualquier conector MCP desde el navegador

El MCP Inspector es la herramienta oficial de debug del protocolo. Sin instalación — solo npx. Conecta a cualquiera de los tres servidores MCP disponibles, ve los tools en tiempo real y ejecuta llamadas directamente desde la UI.

Terminal — lanzar Inspector

npx @modelcontextprotocol/inspector@latest

El Inspector arranca en http://localhost:6274. Copia la URL con el token que imprime en la consola.

Conector Claude

URL: https://claude.verifactu.business/mcp
Auth: OAuth 2.0 DCR (el Inspector gestiona el flujo automáticamente)
Tools: 24 tools — 23 read-only + create_invoice_draft

Pulsa Connect → la página OAuth se abre en el navegador → introduce tu API key de Holded → autoriza.

Ver pasos en terminal

# En el Inspector UI:
# Transport: Streamable HTTP
# URL:       https://claude.verifactu.business/mcp
#
# → Pulsa Connect → completa el OAuth con tu API key de Holded
# → Verás 24 tools listadas con readOnlyHint / writeAnnotations

Conector ChatGPT

URL: http://localhost:3000/api/mcp/holded (local)
Auth: Bearer MCP_SHARED_SECRET (en .env.local)
Tools: 70+ tools (preset holded_priority1 en modo shared_secret)

Requiere apps/app corriendo en local. Añade Authorization header en el Inspector antes de conectar.

Ver pasos en terminal

# 1. Arranca apps/app en local
pnpm --dir apps/app dev

# 2. En el Inspector UI:
# Transport: Streamable HTTP
# URL:       http://localhost:3000/api/mcp/holded
# Header:    Authorization: Bearer <MCP_SHARED_SECRET de .env.local>

Servidor Isaak MCP

URL: https://isaak.verifactu.business/api/mcp/isaak
Auth: Bearer isk_live_TU_API_KEY
Tools: 9 tools — facturas, VeriFactu, resumen fiscal

Añade Authorization header con tu API key antes de conectar. tools/list es público.

Ver pasos en terminal

# En el Inspector UI:
# Transport: Streamable HTTP
# URL:       https://isaak.verifactu.business/api/mcp/isaak
# Header:    Authorization: Bearer isk_live_TU_API_KEY

Resolución de problemas

Puerto ocupado

# Puerto 6277 ocupado (Windows)
netstat -ano | findstr ":6274 :6277" | for /f "tokens=5" %P in ('more') do taskkill /PID %P /F

# Puerto 6277 ocupado (macOS / Linux)
lsof -ti :6274,:6277 | xargs kill -9

Guía técnica completa → isaak.verifactu.business/developers

Empieza hoy, gratis durante la beta.

Crea una cuenta, genera tu primera API key y conecta en minutos.

Crear cuenta gratuita Hablar con el equipo