Desarrolladores

Emisso Connect para desarrolladores.

Un endpoint entre tus agentes, o tu software, y los sistemas chilenos: el SII, Previred, cinco bancos de empresa, la emisión de documentos tributarios y los indicadores del Banco Central. Por MCP, por REST o con el SDK de TypeScript.

El producto se ejecuta en connect.emisso.ai, y ahí viven la documentación, el contrato y las API keys. Esta página es el índice: qué hay, dónde está y cómo se llama.

Ver la documentaciónCrear cuenta

Recursos máquina-legibles

Todas estas URLs responden hoy. Si vas a apuntar un agente o un script a Emisso, parte por el contrato OpenAPI o por el llms.txt.

RecursoQué es
Documentaciónhttps://connect.emisso.ai/docsGuías, conceptos y la referencia de cada tool del catálogo.
Contrato OpenAPIhttps://connect.emisso.ai/docs/openapi.jsonOpenAPI 3.1 con el JSON-Schema de entrada y de salida de cada tool.
Referencia de la APIhttps://connect.emisso.ai/docs/apiLos endpoints REST del gateway, con sus cabeceras y sus códigos.
Servidor MCPhttps://connect.emisso.ai/mcpRemoto, sobre Streamable HTTP y por POST. Sin token responde 401: es un recurso protegido, no una ruta caída.
Metadata de OAuthhttps://connect.emisso.ai/.well-known/oauth-authorization-serverEl authorization server, con registro dinámico de clientes y PKCE S256.
Índice para agenteshttps://connect.emisso.ai/llms.txtEl llms.txt de Connect, con el mapa de toda su documentación.
Catálogo de sistemashttps://connect.emisso.ai/docs/sistemasQué sistemas hay conectados y qué expone cada uno.
SDK de TypeScripthttps://connect.emisso.ai/docs/sdkEl paquete @emisso/connect: tipos generados desde el mismo contrato.
Catálogo de erroreshttps://connect.emisso.ai/docs/referencia/erroresCada código, su status y su suggested_fix.
Lectura pública sin cuentahttps://connect.emisso.ai/public/v1/indicadores/ufEl valor de la UF de hoy en JSON, sin autenticación.
Índice de este sitiohttps://www.emisso.ai/llms.txtEl llms.txt de emisso.ai, con el mapa del sitio y cuándo usar cada cosa.

Las tres formas de llamar

Las tres corren sobre el mismo OAuth, los mismos scopes y la misma bitácora. Cambia quién escribe la llamada, no lo que pasa detrás.

MCP

Servidor MCP remoto sobre Streamable HTTP. Anuncia dos herramientas y no cambian nunca: search_docs para descubrir qué existe y execute para correr una tool. El catálogo completo viaja detrás de ellas, así que el contexto del agente no se llena con cientos de definiciones.

claude mcp add --transport http emisso https://connect.emisso.ai/mcp

REST

Dos cabeceras que no son opcionales. Content-Type: sin ella el gateway responde 415. Y X-Connect-Connection en todo sistema conectable: la conexión es la empresa, y no hay elección implícita ni cuando hay una sola.

curl https://connect.emisso.ai/api/v1/tools/sii.rcv.consultar/execute \
  -H "Authorization: Bearer $EMISSO_TOKEN" \
  -H "X-Connect-Connection: $EMISSO_CONEXION" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "periodo": "2026-07", "perspectiva": "compras" } }'

SDK de TypeScript

El paquete @emisso/connect, con los tipos generados desde el mismo contrato que sirve la API. Es el único SDK que existe; desde Python se llama el REST directamente.

import { EmissoConnect } from "@emisso/connect";

const connect = new EmissoConnect({ token });

const rcv = await connect.tools.sii.rcv.consultar(
  { periodo: "2026-07", perspectiva: "compras" },
  { connectionId },
);

Qué puede hacer un agente

  • Calcular o declarar el IVA de una empresa a partir del registro de compras y ventas del SII.
  • Emitir una factura, una nota de crédito o una nota de débito con folio y timbre real.
  • Revisar boletas electrónicas, guías de despacho o boletas de honorarios, y el XML firmado de cualquiera de esos documentos.
  • Consultar saldo y movimientos de una cuenta corriente de empresa en BancoEstado, Banco de Chile, BCI PyME, Banco Security o BICE Empresas.
  • Ver cotizaciones previsionales en Previred: qué planillas se pagaron, cuánto cotizó cada trabajador y si hay deuda.
  • Convertir montos con la UF, el dólar, el euro, el IPC o la UTM de una fecha.
  • Conectar los sistemas de un tercero sin que su clave pase por tu aplicación: Connect emite un enlace de un solo uso para que la entregue esa persona.

Lo que no hace, que suele importar tanto como lo anterior: no hay conectores fuera de Chile ni de banca de personas, y ningún conector mueve plata. No transfiere fondos, no paga cotizaciones y no carga una nómina. Lo único que Connect escribe en un sistema externo es la emisión de documentos tributarios.

Leer un dato son dos pasos: <sistema>.conexion.sincronizar hace el login real y guarda, y <recurso>.consultar lee lo ya guardado. Una tool .consultar nunca pregunta en vivo.

Empezar