Servidor MCP

Conecta tu agente LLM — Claude, Cursor o cualquier cliente MCP — a las 20 herramientas tipadas de Notta

Notta expone un servidor MCP (Model Context Protocol) para que tu agente emita DTEs y consulte tu cuenta con herramientas tipadas. Es uno de los 3 canales programáticos (API, CLI, MCP) + el dashboard: mismos shapes, misma API key.

El manifiesto de descubrimiento se sirve en https://notta.cl/.well-known/mcp.json, generado desde el toolset real del servidor: nombre, descripción y JSON Schema de input de cada herramienta. Si tu agente no habla MCP, el corpus completo de estas docs está en https://notta.cl/llms.txt y /llms-full.txt.

Servidor remoto (HTTP)

Además del servidor local de la sección de abajo, Notta expone un servidor MCP remoto por HTTP en https://app.notta.cl/api/mcp — no requiere instalar nada. Conéctalo con:

claude mcp add --transport http notta https://app.notta.cl/api/mcp

Al conectar por primera vez, tu agente pide autorización OAuth — acceso de solo lectura sobre DTEs, boletas y BHE, nunca de escritura. Administra o revoca las apps conectadas desde /app/mcp en el dashboard.

Catálogo distinto al servidor local

El servidor remoto expone dos herramientas (discover y execute) sobre el mismo catálogo de operaciones de solo lectura de la API — no el set completo de 20 herramientas del servidor local (@notta/mcp) de la siguiente sección.

Instalación

Agrega el servidor a la config de tu cliente MCP (p. ej. Claude Desktop, ~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "notta": {
      "command": "npx",
      "args": ["@notta/mcp"],
      "env": { "NOTTA_API_KEY": "ntt_cert_..." }
    }
  }
}

Disponibilidad

@notta/mcp está en proceso de publicación en npm — el npx de arriba todavía no resuelve. Mientras tanto, el dashboard y la API cubren el flujo completo: tu agente puede llamar la API directo con una API key.

Herramientas

El servidor expone 20 herramientas, espejo 1:1 de la API:

Tool	Para qué
`notta_dte_emit`	emitir un DTE (33/34/39/41/56/61) con validaciones tributarias previas
`notta_dte_get`	obtener un DTE por id — para chequear estado terminal post-emisión
`notta_dte_list`	listar DTEs con filtros `tipo_dte`/`from`/`to` y cursor pagination
`notta_dte_pdf`	URL del PDF con timbre electrónico
`notta_dte_refresh_status`	forzar un poll inmediato al SII
`notta_bhe_emit` · `notta_bhe_get` · `notta_bhe_list` · `notta_bhe_anular`	Boletas de Honorarios Electrónicas
`notta_certificate_list` · `notta_certificate_get`	certificados digitales — metadatos, nunca la clave privada
`notta_caf_list` · `notta_caf_status`	folios (CAF) con alertas de agotamiento
`notta_rcv_list` · `notta_rcv_refresh`	Registro de Compras y Ventas por período
`notta_f29_get` · `notta_f29_recompute`	F29 propuesto, calculado desde el RCV
`notta_audit_log_query`	audit log con hash chain (retención legal 6 años)
`notta_help_dte_decision` · `notta_help_explain_status`	ayuda al agente: qué documento emitir y qué significa cada estado SII

Tu agente invoca notta_dte_emit con el mismo shape que POST /api/v1/dtes — ver Emitir Factura 33. La herramienta genera el Idempotency-Key automáticamente, así que un retry del agente no duplica el documento.

Decisión tributaria asistida

notta_help_dte_decision recibe un escenario en lenguaje libre ("el cliente devolvió el producto") y devuelve el documento correcto con sus restricciones legales: NC 61 con cod_ref 1/2/3, ND 56, o un bloqueo — intereses moratorios legales (Oficio SII 2011/2020) o factura cedida hace más de 8 días (doctrina Corte Suprema 2025). notta_help_explain_status traduce los estados SII (EPR, RPR, RFR, RCT, RSC) a lenguaje natural con next_action.

RCV y F29

Las herramientas notta_rcv_list y notta_rcv_refresh le dan a tu agente el Registro de Compras y Ventas del SII por período — el insumo del crédito y débito fiscal. Con notta_f29_get y notta_f29_recompute, el agente arma el F29 propuesto del mes sin salir de la conversación. El detalle del modelo está en RCV y F29.

Próximos pasos

Agentes — patrones para que tu agente emita con confirmación humana y maneje la emisión async.
Emitir Factura 33 — el shape completo del request de emisión y los estados SII.
Autenticación — API keys, scopes y entornos sandbox/producción.
Referencia del CLI — las mismas operaciones desde tu terminal.