Portal de documentación de Tarno
Tarno expone un contrato de lectura neutral sobre el corpus de marcas de INAPI: una API REST (sin prefijo de versión) y un servidor Model Context Protocol (MCP), ambos respaldados por la misma capa de consultas y los mismos esquemas, de modo que los dos transportes devuelven resultados idénticos. Este portal es la documentación de puesta en marcha orientada a personas; es neutral y reutilizable entre consumidores.
El esquema autoritativo vive en la referencia OpenAPI en vivo en
https://api.tarno.cl/docs(una página Scalar interactiva generada a partir de los esquemas que el servidor usa de verdad). Estas guías explican cómo hacer la puesta en marcha y enlazan a esa referencia — no duplican el esquema. Cuando el detalle de un campo o endpoint no está especificado aquí, la referencia es la fuente de verdad.
Guías de integración
| Guía | Qué cubre |
|---|---|
| Primeros pasos | URL base https://api.tarno.cl, obtener una clave emitida por el operador, la primera llamada GET /trademarks (curl + TS fetch), paginación por cursor keyset, el sobre results[] y el cuerpo de error RFC 9457. |
| Autenticación y scopes | El encabezado X-API-Key, los scopes (vacío = sólo las lecturas base), el ciclo de vida de la clave (rotar/revocar/expiración) y la semántica de 401 / 403 / 429. |
| Conecta tu agente de IA (MCP) | El endpoint https://mcp.tarno.cl, X-API-Key, el transporte Streamable HTTP, el catálogo de 54 herramientas, 4 recursos y 3 guiones, y configuraciones de cliente de ejemplo. |
| Búsqueda por campos | Buscar acotando el texto a un campo (denominación, titular, representante, RUT) y el modo avanzado. |
| Vigilancia de parecidos | Vigilar solicitudes por número y leer sus parecidas: /watch/applications y /watch/hits. |
| Webhook «sync terminado» | El aviso sync.finished al terminar la cadena diaria, su firma y la entrega de prueba. |
| Informes y oposiciones | Boletín diario, despeje, panorama de conflictos, cartera y escritos de oposición. |
| Base documental (Directrices y leyes) | Las Directrices de INAPI, los textos de las leyes, tasas e indicadores (legal:read). |
| Análisis y cálculo | Comparar marcas, estadísticas por clase, plazos, días hábiles y tasas. |
| Búsqueda de personas | Partes (titulares y representantes), sus marcas, relaciones y desenlaces. |
| Ejemplos de código | Clientes REST (curl + TS fetch) y MCP (@modelcontextprotocol/sdk) listos para copiar y pegar. |
Contrato y operaciones
| Documento | Qué cubre |
|---|---|
| Estado | Estado del servicio y dónde se muestran la frescura/salud en vivo. |
| Versionado y deprecación | El contrato sin prefijo de versión: se versiona por su changelog, con fecha de contrato como versión. |
| SLA | Disponibilidad comprometida, RPO/RTO, mantenimiento, frescura y soporte. |
| Calendario de feriados | El calendario legal chileno que el corpus usa para contar días hábiles: GET /holidays, con la cobertura declarada en meta.coverage. |
| Modelo de datos | Las entidades que devuelve la API (marca, anotación, parte, clase, norma, informe, vigilancia), sus campos y cómo se relacionan. |
| Cobertura histórica | Hasta dónde llega el corpus de marcas hacia atrás (distinto del calendario de feriados). |
| Changelog del contrato | Cada cambio de la API y del MCP desde el 2026-09-17, con su etiqueta ([BREAK], [BEH], [ADD]…), su fecha y qué tienes que hacer. |
| Documentos legales | Términos de servicio, política de datos personales, encargo de tratamiento (DPA) y subencargados. |
Referencia autoritativa de la API
El esquema REST completo, generado de los esquemas y siempre actualizado por campo, es la referencia OpenAPI (Scalar)
interactiva servida en https://api.tarno.cl/docs. Comienza con las
guías anteriores para la puesta en marcha y luego usa esa referencia como el esquema canónico para cada endpoint,
parámetro y forma de respuesta.