Saltar a contenido

Conecta tu agente de IA (MCP)

Tarno incluye un servidor MCP neutral para que un agente de IA pueda consultar el corpus de marcas de INAPI a través del Model Context Protocol (todo de lectura, salvo dar de alta y de baja las solicitudes que vigila la propia org, con watch:write). Expone el mismo contrato de lectura que la API REST — respaldado por la misma capa de consultas y los mismos esquemas — de modo que los dos transportes devuelven resultados idénticos.

Endpoint y transporte

Propiedad Valor
Endpoint https://mcp.tarno.cl
Transporte Streamable HTTP (MCP)
Autenticación Encabezado X-API-Key, enviado por solicitud
Identidad del servidor tarno-read-mcp

El servidor responde MCP JSON-RPC sobre el transporte Streamable HTTP. Una sonda GET /health es la única ruta no autenticada; cada llamada a herramienta está autenticada.

Un mensaje JSON-RPC por petición HTTP. Los lotes (un array de mensajes en el cuerpo) se rechazan con HTTP 400 y el error JSON-RPC -32600. La especificación MCP los retiró en la versión 2025-06-18 y los clientes oficiales no los envían. Cada llamada a una herramienta y cada lectura de un recurso con ruta REST gemela (resources/read) gasta una unidad de cuota y de límite de ráfaga, igual que su petición gemela en REST. Una llamada con argumentos que no cumplen el esquema de la herramienta no gasta nada (como un 400 en REST) y devuelve el error en el mismo cuerpo Problem Details que el resto (status: 400, code: "validation_error" y errors[] por campo); el protocolo (initialize, tools/list, resources/list…) tampoco gasta.

Autenticación

La autenticación es por herramienta, no por conexión. Cada handler de herramienta verifica la clave presentada antes de leer cualquier cosa, de modo que una clave ausente o inválida nunca devuelve datos del corpus. Envía tu clave emitida por el operador en el encabezado X-API-Key en las solicitudes del transporte (marcador de posición <API_KEY> en esta documentación):

X-API-Key: <API_KEY>

Cada herramienta exige el mismo scope que su ruta REST gemela: brands:read la mayoría; insights:read las de sistema, agregados y feriados; watch:read/watch:write las cuatro de vigilancia; legal:read la base documental; y cada informe, su permiso propio. Una clave sin restricción (scopes vacíos) tiene las lecturas base — consulta la guía de autenticación. Una clave ausente/inválida se rechaza como un error de herramienta unauthorized; una clave válida a la que le falta el scope se rechaza como forbidden.

⚠ Los ocho informes (get_daily_bulletin, get_clearance_report, get_portfolio_report, get_opposition_brief, get_opposition_response_brief, get_conflict_landscape, get_registration_signals y get_filing_context) llevan permiso propio: reports:read (todos) o el del informe (reports:daily-bulletin:read, reports:clearance:read, reports:portfolio:read, reports:opposition-brief:read, reports:opposition-response-brief:read, reports:conflict-landscape:read, reports:registration-signals:read, reports:filing-context:read). Se conceden explícitamente — una clave sin restricción (scopes vacíos) no los recibe, ni la clave de prueba — y cada llamada cuenta una unidad de cuota.

⚠ analyze_logo también lleva permiso propio, logo:analyze, concedido explícitamente con la misma regla (ni una clave sin restricción, ni la de prueba, ni reports:read lo reciben): cada llamada cuesta dinero en un tercero y tiene además una cuota diaria propia (análisis de un logo). Y find_similar_logos, la operación futura, lleva el suyo, logo:similar, con la misma regla (tampoco lo abre logo:analyze); no se concede a ninguna clave hasta que se anuncie disponible.

El handshake initialize a nivel de transporte puede tener éxito sin clave — la invariante estricta es que una llamada a herramienta nunca devuelve datos del corpus a menos que la clave sea válida y tenga el scope. Envía siempre el encabezado.

Cuota

La misma cuota mensual que rige la API REST aplica al MCP. Cuando una clave está sobre la cuota, el servidor responde con HTTP 429 y un encabezado Retry-After (segundos hasta el reinicio), coincidiendo byte por byte con la respuesta de cuota de REST:

HTTP/1.1 429 Too Many Requests
Retry-After: 1209600

{ "type": "https://api.tarno.cl/problems/quota_exceeded", "title": "Rate limit exceeded", "status": 429,
  "detail": "Monthly quota exceeded", "code": "quota_exceeded", "requestId": "..." }

Si la clave no se puede verificar porque el servicio que valida las claves no está disponible en ese momento, el servidor responde HTTP 503 con code: "service_unavailable", el mismo cuerpo que REST, y la herramienta no se ejecuta. Reintenta con espera.

Recursos, guiones y reglas

Además de las herramientas, el servidor expone (el manifiesto contract/mcp-manifest-38.json anuncia exactamente estos nombres: una prueba construye el servidor y compara lo servido con lo anunciado):

  • Recursos — los catálogos del corpus enumerables por URI: iris://catalogs/states (estados), iris://catalogs/sections (secciones), iris://catalogs/nice-classes (clases de Niza) y iris://catalogs/holidays/{year} (feriados por año). Salen de la MISMA fuente que las rutas REST y se leen con la MISMA clave y el MISMO alcance que su ruta (brands:read; insights:read para los feriados), y cada lectura gasta una unidad de cuota como su ruta (los estados, sin ruta REST, no gastan); listarlos no pide clave ni gasta. Las clases de Niza (list_nice_classes ≡ GET /nice-classes y este recurso) llevan los encabezamientos de la edición vigente en Chile HOY: la 13-2026 hasta el 2026-12-31 y la 13-2027 desde el 2027-01-01 (cambian las clases 6, 9, 21, 29 y 31), sin intervención de nadie; pt-BR es traducción propia de Tarno. Las herramientas de catálogo (list_nice_classes, list_legal_norms, list_sections, list_holidays) dicen en meta.dataAsOf la fecha de su fuente —la OMPI, la BCN, el calendario—, no la de la sync de marcas; en list_sections, el día en que se leyó por última vez la leyenda de códigos de INAPI. La familia de una sección (family, y sectionFamily en las anotaciones) es una cadena abierta: hoy presentacion, forma, fondo, publicacion, pago, oposicion, resolucion, renovacion y, desde el 2026-10-10, caducidad (los actos de un juicio de caducidad por falta de uso; no es el estado caducado) y, desde el 2026-10-11, cancelacion_y_limitacion_territorial (los juicios de cancelación y de limitación territorial). Un valor que no conozcas es otra familia, no un error. Cada anotación lleva annotationNumber, el número de anotación de INAPI (el «N° de anotación» del expediente, el que se cita); una resolución lleva el de la anotación que resuelve. Es null cuando no se conoce (el Estado Diario no lo imprime): un hueco es null, nunca un número supuesto. meta.coverageThrough es null en los catálogos (no tienen «hasta»), salvo en list_holidays: el último día con calendario declarado. Detalle en Cobertura.
  • Guiones — tres, por su nombre real: availability_check (¿está disponible un nombre? — usa search_trademarks con similarTo para los parecidos y q para la coincidencia literal), case_history (¿qué ha pasado con un expediente?) y weekly_watch (¿qué parecidas tienen las solicitudes que vigilo? — su único argumento, applicationNumber, es opcional: con él lee list_similarity_hits de esa solicitud; sin él, list_watched_applications y list_similarity_hits de todas). Dan señales, no veredictos.
  • Versión — la fecha de contrato (2026-10-04), igual que el OpenAPI.
  • Instrucciones — las cuatro reglas de lectura del corpus, cada una con el fallo que evita: decir la fecha del dato; omitir lo que no se sabe; dar señales y no veredictos; plazos sólo con su artículo.

Catálogo de herramientas

El servidor registra 54 herramientas —una de ellas, find_similar_logos, una operación futura que hoy responde siempre 503—. Todas leen salvo dos que escriben, las de vigilancia con watch:write (watch_application, unwatch_application), que sólo tocan lo que vigila la propia org. 53 son el gemelo exacto de una ruta REST: misma validación, mismos datos, mismos códigos de error; la que no tiene ruta es explain_section_code, que lee la base de conocimiento sobre INAPI y no el corpus. La paridad se lee «toda herramienta es una ruta» (salvo esa), no al revés: cuatro rutas REST existen sólo por ser REST y no tienen herramienta propia —GET /trademarks (enlazable/cacheable) es la gemela REST de search_trademarks, GET /trademarks/application-numbers la de list_application_numbers, GET /trademarks/renewal-calendar la de get_renewal_calendar (las tres sin el objeto portfolio, que no viaja en una URL), y POST /insights/trademarks/search (para filtros que no caben en una URL) la de get_trademark_insights—. search_trademarks y get_trademark son las de entrada (detalladas más abajo); el catálogo completo está en la tabla que sigue (tu cliente MCP lo enumera con tools/list) e incluye, entre otras, get_trademark_insights (los agregados por groupBy), list_holidays (calendario de feriados y el rango que afirma cubrir), get_system_freshness, list_sync_runs, list_parties y las cuatro de vigilancia de parecidos —watch_application, unwatch_application, list_watched_applications, list_similarity_hits— (guía). watch_application devuelve el mismo cuerpo que REST y no distingue un alta nueva de una repetida (REST: 201 / 200); unwatch_application devuelve { "applicationNumber": "N", "watched": false } (REST: 204 sin cuerpo). list_watched_applications anuncia el final de una vigilancia con terminalSince, watchEndsOn (el último día de la vigilancia, no un plazo legal) y watchEndBasis; al día siguiente la solicitud deja de listarse. list_similarity_hits devuelve sólo las parecidas vigentes: una que pasa a estado terminal o deja de parecerse desaparece sin aviso y, si vuelve, vuelve con un id nuevo (cómo cambia una vigilancia). Es un feed: next viene siempre, se pagina mientras hasMore sea true y el último next, enviado más tarde como cursor, trae sólo lo que la organización pudo leer después (cómo leer lo nuevo).

Las 54 herramientas, con su ruta REST gemela y el scope que exigen (reports:read concede también todos los informes):

Grupo Herramienta REST gemela Scope Qué hace
Marcas search_trademarks POST /trademarks/search brands:read Colección, lote, parecido y ventana de oposición en una llamada
Marcas get_trademark GET /trademarks/{applicationNumber} brands:read Una marca, con expansión opcional
Marcas compare_trademarks POST /trademarks/compare brands:read Compara dos marcas vía por vía: señales, sin veredicto
Marcas get_deadlines GET /trademarks/{applicationNumber}/deadlines brands:read Los plazos de una marca con su norma: apelar un rechazo o una aceptación parcial, pagar los derechos de concesión y contestar el traslado de una oposición
Marcas get_renewal_calendar POST /trademarks/renewal-calendar brands:read Los hitos de renovación (art. 24) de un conjunto de marcas
Marcas list_application_numbers POST /trademarks/application-numbers brands:read Todos los números de solicitud que casan con un filtro, por páginas de hasta 10.000 (next es el cursor; total exacto; 409 cursor_stale si una sincronización corrió entre páginas); acepta el objeto portfolio. Sin él, la misma respuesta que GET /trademarks/application-numbers
Marcas get_trademark_insights GET /insights/trademarks insights:read Agregados por groupBy sobre las marcas que casan
Anotaciones search_annotations POST /annotations/search brands:read Búsqueda transversal de anotaciones y feed de actos detectados
Anotaciones list_trademark_annotations GET /trademarks/{applicationNumber}/annotations brands:read Las anotaciones de una marca
Anotaciones get_annotation GET /annotations/{id} brands:read Una anotación por su id
Partes list_parties GET /parties brands:read Partes, con su recuento de marcas
Partes get_party GET /parties/{id} brands:read Una parte
Partes list_party_trademarks GET /parties/{id}/trademarks brands:read Las marcas de una parte, por papel
Partes list_party_relations GET /parties/{id}/relations brands:read Las relaciones de una parte con otras
Partes get_party_outcomes GET /parties/{id}/outcomes brands:read Los desenlaces de las marcas de una parte
Catálogos y cálculo list_nice_classes GET /nice-classes brands:read Las 45 clases de Niza de la edición vigente
Catálogos y cálculo get_class_stats GET /nice-classes/{niceClass}/stats brands:read Estadísticas de una clase de Niza, con su cobertura
Catálogos y cálculo recommend_nice_classes POST /nice-classes/recommend brands:read Clases de Niza para una descripción libre
Catálogos y cálculo list_sections GET /sections brands:read Las secciones de INAPI
Catálogos y cálculo get_section GET /sections/{code} brands:read Una sección, con sus equivalencias
Catálogos y cálculo explain_section_code — brands:read Qué significa un código de sección (sin ruta REST)
Catálogos y cálculo list_legal_norms GET /legal-norms brands:read Catálogo de normas citadas
Catálogos y cálculo get_legal_norm GET /legal-norms/{id} brands:read Una norma, con sus artículos
Catálogos y cálculo list_holidays GET /holidays insights:read Calendario de feriados y el rango que afirma cubrir
Catálogos y cálculo compute_business_days GET /business-days brands:read El N.º día hábil tras una fecha, con su norma
Catálogos y cálculo calculate_fees POST /fee-schedule/calculate brands:read Las tasas de una solicitud o renovación
Informes get_daily_bulletin GET /reports/daily-bulletin reports:daily-bulletin:read El boletín del Estado Diario de un día
Informes get_clearance_report GET /reports/clearance reports:clearance:read Señales de disponibilidad de un nombre
Informes get_conflict_landscape GET /reports/conflict-landscape reports:conflict-landscape:read Quién representa y es titular de las parecidas vivas
Informes get_registration_signals GET /reports/registration-signals reports:registration-signals:read El índice orientativo de un nombre, por señales
Informes get_filing_context GET /reports/filing-context reports:filing-context:read Los hechos de un escrito, cada uno con su fuente
Informes get_portfolio_report GET /reports/portfolio reports:portfolio:read La cartera de una parte
Informes get_opposition_brief GET /reports/opposition-brief reports:opposition-brief:read Hechos para oponerse a una marca
Informes get_opposition_response_brief GET /reports/opposition-response-brief reports:opposition-response-brief:read Hechos para responder a una oposición
Base documental list_guidance_documents GET /guidance/documents legal:read Los documentos de INAPI con su versión vigente
Base documental get_guidance_document GET /guidance/documents/{code} legal:read Un documento con su Sumario y versiones
Base documental get_guidance_section GET /guidance/documents/{code}/section legal:read Un apartado literal, con página, versión y citas
Base documental search_guidance POST /guidance/search legal:read Buscar en los documentos vigentes
Base documental list_guidance_changes GET /guidance/changes legal:read Qué apartados cambiaron y cuándo
Base documental get_legal_norm_article GET /legal-norms/{id}/articles/{article} legal:read El texto de un artículo a una fecha
Base documental search_statutes POST /legal-norms/search legal:read Buscar artículos de ley
Base documental get_fee_schedule GET /fee-schedule legal:read La tabla de tasas en UTM y en pesos
Base documental list_economic_indicators GET /economic-indicators legal:read Indicadores del SII (UTM, UF, IPC…)
Logos analyze_logo POST /logos/analyze logo:analyze Describe un logo y propone códigos de Viena (modelo)
Logos find_similar_logos POST /logos/similar logo:similar FUTURA: hoy siempre 503
Vigilancia watch_application POST /watch/applications watch:write Vigilar una solicitud por número
Vigilancia unwatch_application DELETE /watch/applications/{applicationNumber} watch:write Dejar de vigilarla
Vigilancia list_watched_applications GET /watch/applications watch:read Lo que vigila tu organización
Vigilancia list_similarity_hits GET /watch/hits watch:read Las parecidas de lo vigilado
Sistema get_system_me GET /system/me insights:read Tu clave: alcances, cuota y uso de 12 meses
Sistema get_system_freshness GET /system/freshness insights:read Frescura del corpus por fuente
Sistema get_system_coverage GET /system/coverage insights:read Cobertura de ingesta por fecha de boletín
Sistema get_vigilance_horizon GET /system/vigilance-horizon insights:read La ventana que la retención conserva
Sistema list_sync_runs GET /system/sync-runs insights:read Historial de sincronizaciones

⚠ [BREAK] 2026-10-04: las diez herramientas de watchlists (create_watchlist, list_watchlists, get_watchlist, update_watchlist, delete_watchlist, add_watchlist_item, remove_watchlist_item, list_watchlist_items, list_watchlist_hits, list_watchlist_deliveries) se retiraron de una vez, sin convivencia. Las sustituyen esas cuatro: se vigila una solicitud de INAPI por su número, sin listas, filtros ni webhook. El mapa antes → después está en la guía de Vigilancia.

get_renewal_calendar ≡ POST /trademarks/renewal-calendar — el calendario de renovación (2026-09-25). Con from/to obligatorios (como mucho 366 días, los dos extremos incluidos) y el filtro de marcas —el lote de hasta 100 applicationNumber, renewalStatus, holder, niceClass…—, una fila por (marca, hito de renovación) en el rango: renewal_window_open y grace_end (Ley 19.039 art. 24), cada una idéntica al hito de los milestones[] de la marca, más su applicationNumber, por fecha y número. «Las fechas de renovación de mi lista este año» es UNA llamada. Pagina con limit + cursor, total exacto. q, la similitud y la ventana de oposición son validation_error. Acepta el objeto portfolio (una marca añadida a mano está aunque no cumpla portfolio.refine); sin él, la misma respuesta que GET /trademarks/renewal-calendar. Detalle: informes.

list_parties — los dos órdenes son rápidos. Sin sort, las partes vienen por volumen de marcas (de mayor a menor), servido por un recuento que se guarda al final de cada sincronización; sort: "name" elige la página primero. Durante una sincronización en curso el orden por volumen se calcula al vuelo (misma respuesta, 1–3 s; hasta 8 s con kind/role). Las partes sin marcas nunca se esconden (trademarkCount: 0), y meta lleva dataAsOf y coverageThrough.

list_party_relations — las relaciones de una parte (2026-09-24). Gemela de GET /parties/{id}/relations. Aristas tipadas con otras partes: co_holder, represents/represented_by, assigned_to/assigned_from (cesiones A07T) y opposed/opposed_by (oponentes identificados). Cada una con la otra parte, trademarkCount, firstOn/lastOn, hasta 5 marcas de evidence (+ evidenceTruncated) y coverageFrom: las oposiciones sólo desde el 2024-04-19 — «no se opuso nunca» se lee «no desde entonces». Filtros type (lista) y relation. ⛔ Señales con evidencia, nunca veredictos: sin «mismo grupo» ni parecido de nombre. Detalle: búsqueda de personas.

Los informes de una llamada (2026-09-24). Permiso propio (reports:read o el del informe), denegado por defecto. Detalle: informes. - get_daily_bulletin ≡ GET /reports/daily-bulletin: lo que el Estado Diario publicó en date, fila a fila con partes, paginado, con total exacto y el índice del día en meta.sections ({code, label, count}). Un día sin boletín ingerido es out_of_coverage (422) con la cobertura, nunca una lista vacía. - get_clearance_report ≡ GET /reports/clearance: con text y niceClass, los confundibles por canal (phonetic, fuzzy, semantic) con inOppositionWindow (pertenencia; el cierre viaja en milestones como opposition_close), los titulares dominantes de las clases y las normas citadas en las anotaciones de los confundibles. ⛔ Señales, nunca «registrable» ni «infringe». - get_portfolio_report ≡ GET /reports/portfolio: la cartera de UNA parte por su partyId (nunca por su nombre) — recuentos por estado y por clase, las marcas con un vencimiento (expiry) dentro de horizonDays (defecto 90, máximo 366), las que están hoy en ventana de oposición (pertenencia; el cierre viaja en milestones como opposition_close), quién se opuso, sus representantes y el resumen de sus relaciones. Cada marca trae su renewalStatus (art. 24), y byRenewalStatus las cuenta por estado, con las sin fecha y las no aplicables aparte. Detalle: informes. - get_opposition_brief ≡ GET /reports/opposition-brief: para PRESENTAR una oposición contra applicationNumber — su ficha con milestones, si está hoy en ventana (pertenencia; el cierre viaja en milestones como opposition_close), con ownApplicationNumber su posición entre las 100 más parecidas a tu marca en sus clases (similarity; sin tu marca la clave no viaja), el historial de oposiciones de sus titulares y las normas citadas en las oposiciones que han recibido sus marcas. Detalle: informes. - get_opposition_response_brief ≡ GET /reports/opposition-response-brief: para RESPONDER a las oposiciones recibidas por applicationNumber — sus actos de oposición (sección en tres idiomas, normas, oponentes resueltos), y por oponente sus oposiciones y sus marcas vigentes en las clases de la tuya, buscadas por su id y nunca por su nombre. Las menciones de oponente sin resolver se cuentan y no se nombran. Detalle: informes.

⛔ Los cinco dan señales, nunca veredictos: ninguno dice si una marca es registrable ni si una oposición prosperará, y ninguno publica una fecha de cierre de oposición fuera de milestones.

La base documental (2026-09-28). Permiso propio, legal:read, denegado por defecto: una clave sin restricción no lo tiene (se concede explícitamente). Detalle: base documental. - get_legal_norm_article ≡ GET /legal-norms/{id}/articles/{article}: el texto LITERAL de un artículo de una norma del catálogo (id de list_legal_norms) en la versión que regía en asOf (defecto: hoy en Chile), con sus letras, incisos y notas de BCN. letter/subsection acotan; transitional: true lee el transitorio. Un artículo que no se pudo partir con seguridad se sirve entero (split: false, article_not_split), nunca con un corte inventado. Una norma sin texto cargado o una fecha fuera de sus ventanas es out_of_coverage (422); una clave repetida, ambiguous_selector (409). dataAsOf es la fecha de la fuente de leyes, no la del corpus de marcas. - list_guidance_documents ≡ GET /guidance/documents: los documentos de INAPI (capítulos de las Directrices, circulares, página y manual de Madrid, tasas), cada uno con su versión vigente y su extractionStatus; filtros kind y q (título, sin acentos). - get_guidance_document ≡ GET /guidance/documents/{code}: un documento con su Sumario (todos los apartados de la versión, en orden, SIN cuerpos) y el historial de sus versiones; version lee una anterior. Una versión image_only responde con outline: [] y lo declara; una ocr (imágenes leídas a máquina) tiene un apartado por página y su texto NO es literal. - get_guidance_section ≡ GET /guidance/documents/{code}/section: un apartado LITERAL con su página, su versión, sus hijos y las normas que cita, por path (III.D.▪1.§7) o por paragraph (el § que cita un abogado). La cita estable es code + version.seq + path. Un párrafo repetido es ambiguous_selector (409) con los path; una versión sin texto (image_only), out_of_coverage (422). dataAsOf es la fecha de la fuente de INAPI. - search_guidance ≡ POST /guidance/search: busca en los apartados VIGENTES de INAPI por texto (español, sin acentos) y por parecido (búsqueda semántica), fusionados; kind/document acotan. - search_statutes ≡ POST /legal-norms/search: busca ARTÍCULOS de ley en el texto que rige hoy (la misma regla que get_legal_norm_article), en el de asOf, o con allVersions: true en TODAS las vigencias — el mismo texto repetido entre vigencias sale una vez con todas en validity. norm acota a una norma del catálogo (sin texto: out_of_coverage).

Las dos: mode hybrid (defecto), text o semantic; matchedBy dice qué canal encontró cada acierto; si el canal de parecido no puede correr, hybrid lo dice en meta.channels.semantic: "unavailable" y semantic es service_unavailable (503) — nunca una lista vacía. Extractos LITERALES, sin puntuaciones. Detalle: buscar. - get_fee_schedule ≡ GET /fee-schedule: la tabla de tasas del cap. 13 de las Directrices en UTM, LITERAL, con amountClp DERIVADO al leer (amountUtm × utm.value, exacto, sin redondear) con la UTM de utmMonth (defecto: el mes en curso en Chile); utm.basis dice si es la del mes pedido (requested_month) o la última publicada (latest_published); sin UTM, null. surchargeDoubt es la nota informativa del recargo por renovación tardía: la regla es la tabla de las Directrices 2026 y las notas literales de las publicaciones de INAPI que difieren no bloquean nada. Detalle: tasas. - list_economic_indicators ≡ GET /economic-indicators: UTM, UTA, IPC, UF o dólar observado por code y rango from/to, con meta.coverage; un rango entero fuera es out_of_coverage (422). ⚠ Cada fila del IPC lleva su baseNote: puntos de bases distintas no se comparan. - list_guidance_changes ≡ GET /guidance/changes: qué apartados cambiaron entre versiones de un documento de INAPI o de un texto de BCN y cuándo lo detectamos (effectiveDate literal de BCN); a lo sumo 100 apartados por cambio (sectionsTruncated). meta.dataAsOf: la fuente del editor pedido o la más antigua de las dos. - get_annotation con expand: ["citations"] ≡ GET /annotations/{id}?expand=citations: la cita explicada — por cada norma que cita la anotación, el texto LITERAL del artículo/letra que regía en su fecha (text.asOf; la misma regla que get_legal_norm_article) y las señales de las Directrices: los documentos que citan ese artículo/letra con citingCount/unnamedCount y hasta tres apartados, nunca «el» apartado que la interpreta. textStatus dice por qué una cita no trae texto. Exige legal:read además de brands:read (sin él, forbidden sin consumir cuota); sólo en el detalle — los listados rechazan expand. Sin expand, la anotación de siempre. Detalle: cita explicada.

Análisis y cálculo. Herramientas neutrales que calculan o reúnen señales con su fuente, nunca veredictos. Detalle: análisis y cálculo. - compute_business_days ≡ GET /business-days: el N.º día hábil ESTRICTAMENTE posterior a from (lunes a viernes sin los feriados del calendario — el mismo cómputo que la ventana de oposición), con los fines de semana y feriados saltados, la cobertura declarada del calendario y la base legal del cómputo (Ley 19.039 art. 11, Ley 19.880 art. 25). Exactamente uno de businessDays (N lo pones tú: term.source: caller, term.legalBasis: null — es un conteo, no un plazo) o preset; el único preset es opposition (art. 5, 30 días hábiles desde la publicación), con la misma fecha que el opposition_close de la marca. Un ancla inhábil o un tramo fuera del calendario dan basis: estimated con su motivo. Permiso brands:read. - calculate_fees ≡ POST /fee-schedule/calculate: las tasas OFICIALES de INAPI de application_and_registration o renewal, por niceClassCount o applicationNumber, en UTM literal y pesos al leer. En la gracia de renovación se aplica la fila del mes de la tabla de las Directrices 2026 (renewal.surchargeRuleSource) y el TOTAL se calcula, con la discrepancia de las otras publicaciones como nota (renewal.surchargeDoubt); pasada la gracia, lapsed. Nunca incluye el Diario Oficial ni honorarios (excluded). Permiso brands:read. - get_party_outcomes ≡ GET /parties/{id}/outcomes: los desenlaces de las marcas de una parte por grupo de estado publicado, con n y grantShare sobre las decididas (pendientes fuera; null sin decididas) y la definición entera. No es una «tasa de éxito». Permiso brands:read. - compare_trademarks ≡ POST /trademarks/compare: dos marcas (texto o applicationNumber) comparadas vía por vía —trigramas, edición, fonética española, similitud semántica— con los términos genéricos de cada lado DECLARADOS y distinctiveSignals sobre los núcleos; sin puntuación global ni nivel (comparar). Permiso brands:read. - get_class_stats ≡ GET /nice-classes/{niceClass}/stats: las estadísticas de una clase por años de presentación enteros (por defecto, los cinco últimos completos): población, desenlaces con los grupos de get_party_outcomes, percentiles APROXIMADOS (±15 días) del tiempo hasta el registro con su n, proporción con actos de fondo, forma y oposición, y la cobertura dicha en coverage. 503 class_stats_pending antes del primer cálculo (estadísticas). Permiso brands:read. - get_conflict_landscape ≡ GET /reports/conflict-landscape: las parecidas VIVAS de la disponibilidad agregadas por representante y por titular, con evidencia y su total en la clase (panorama). Un INFORME: permiso reports:conflict-landscape:read o reports:read. - get_registration_signals ≡ GET /reports/registration-signals: el índice orientativo como DESGLOSE de seis señales por clase (1 a 3), cada una con su valor, n, evidencia y fuente, y un signalIndex 0–100 con su fórmula literal y los pesos aplicados (provisionales); «no es un veredicto» (índice). Un INFORME: permiso reports:registration-signals:read o reports:read. - recommend_nice_classes ≡ POST /nice-classes/recommend: las clases de Niza de la edición vigente (13-2026; 13-2027 desde el 2027-01-01) para una descripción libre, por cuatro vías declaradas —términos oficiales de la OMPI por significado y por texto, encabezamientos y evidencia del corpus—, con la atribución a la OMPI (recomendar). Permiso brands:read. - get_filing_context ≡ GET /reports/filing-context: los HECHOS de un escrito (poder, oposición, contestación, respuesta a observaciones, desistimiento), cada uno con su fuente; los plazos con artículo en milestones (el cierre de oposición y, desde el cambio del 2026-10-10, la contestación del traslado, opposition_response_close), y los omitidos con su motivo (milestonesOmitted). Sin redacción: la escribe el consumidor (expediente). Un INFORME: permiso reports:filing-context:read o reports:read; con expand=legalTexts, además legal:read. - analyze_logo ≡ POST /logos/analyze: un modelo de lenguaje (Anthropic) describe un logo en los términos de INAPI y propone códigos de Viena VCL10, contrastados con el catálogo de la OMPI; la respuesta dice que lo generó un modelo (generatedBy, disclaimer). La imagen va en los argumentos (base64, ≤ 700 KB, ≤ 2.000 px), se envía a Anthropic y no se guarda (logo). Permiso logo:analyze; cuota diaria propia (20 por clave, 200 en total); sin clave del proveedor en el servidor, 503 logo_analysis_not_configured. - find_similar_logos ≡ POST /logos/similar — ⛔ OPERACIÓN FUTURA, todavía no disponible: las marcas cuyo logo se parece a una imagen. Está declarada (entrada: la misma image que analyze_logo, niceClasses, limit; salida futura: results[] con score y signals.visual de parecido visual) para poder programar contra ella, pero hoy responde siempre 503 image_similarity_not_available, nunca resultados. No la reintentes ni presentes su respuesta como «no hay marcas parecidas» (parecido por imagen). Permiso logo:similar, que no se concede a ninguna clave todavía. Es la última de tools/list. - search_annotations acepta además partyId/taxId (+ partyRole, relation) y trademarkStatus; search_trademarks, partyRole junto a taxId (anotaciones por parte, RUT). - Toda anotación (search_annotations, get_annotation, el boletín) lleva inapiTermLabel: el plazo que INAPI imprime en el nombre del acto, citado (basis: "inapi_label", p. ej. "30 días") para una lista cerrada de 14 códigos de observaciones; null en los demás. ⛔ No es una fecha ni un hito (el rótulo de INAPI). - search_annotations por lista y por detección: applicationNumbers (hasta 100 marcas por cursor; más ⇒ 422 batch_too_large), detectedAfter/detectedUntil (cuándo lo supo el corpus), denomination y detectedAt en cada anotación y el horizonte meta.detectedThrough para encadenar «cambios desde X» sin saltar filas (por lista y detección). detectedAfter solo (sin marca, lista ni parte) es el feed de todo el corpus: los actos de todas las marcas en orden de detección, sin filtros de contenido; maxActAgeDays deja fuera los actos que ya tenían más de N días al detectarse (una página puede venir corta o vacía con next: síguelo) (el feed).

get_trademark_insights — las dimensiones de groupBy. filedMonth, status, niceClass, holder, representative, desde el 2026-09-24 expiresMonth y transferYear, y desde el 2026-09-25 renewalStatus. Todas devuelven { key, label, count } con label en es-CL/en/pt-BR, y aplican el filtro completo de search_trademarks (o 400). - expiresMonth: marcas por mes de vencimiento (key = 2027-03-01, label = «marzo de 2027» / «March 2027» / «março de 2027»). ⚠ Las marcas sin fecha de vencimiento no caen en ningún mes y se DECLARAN en meta.undatedCount (Σ count + undatedCount = marcas filtradas). Son muchas —las solicitudes en trámite aún no vencen—: no las des por inexistentes. - transferYear: por año del acto, las marcas con una transferencia (código INAPI A07T) que retiró a un titular conocido, desde 2011-08-01. Una marca cuenta en cada año en que tuvo una; los cambios de nombre no son transferencias. - renewalStatus: marcas por su renewalStatus (el mismo valor que trae cada marca; art. 24, hoy en hora de Chile): not_due «Renovación aún no abierta», window_open «Ventana de renovación abierta», grace «Vigente, en plazo de gracia de renovación», lapsed «Plazo de renovación vencido». ⚠ Las marcas sin fecha de vencimiento van a meta.undatedCount y las que tienen fecha pero la regla no se les aplica (Madrid, o ni registrada ni esperando_renovacion) a meta.notApplicableCount: Σ count + undatedCount + notApplicableCount = marcas filtradas. Nunca un estado deducido. - niceClass rotula el número en los tres idiomas: «Clase 9» / «Class 9» / «Classe 9».

Retiradas el 2026-09-24 — la herramienta de listado de marcas y la de búsqueda de agregados eran gemelas exactas de search_trademarks y get_trademark_insights (mismo esquema, mismo sobre, mismo camino). Pedir cualquiera de las dos es hoy una herramienta desconocida; la MISMA pregunta, con los mismos argumentos, se hace con la que queda. Las rutas REST no cambian.

⚠ La guía de migración del 2026-09-23 es histórica y conserva los nombres de entonces: donde dice list_trademarks usa search_trademarks, y get_trademark_insights en lugar de search_trademark_insights (mismos argumentos).

Las personas dicen qué clase de parte son. Cada persona de get_trademark (parties, holders, representatives, formerParties) lleva kind (natural/legal/unknown), kindSource (tax_id/suffix/manual/name_pattern, omitido, nunca null, cuando no hubo señal), observation (la cláusula de jurisdicción que INAPI publica pegada al nombre, tal cual), publishedName (el nombre exactamente como lo publicó INAPI) y revision. En list_parties cada persona lleva el mismo kind, kindSource (ahí null cuando no hubo señal), publishedName, la cláusula como jurisdictionClause y la revisión como review. Se leen bajo el mismo scope brands:read. La paridad REST≡MCP está verificada con un test deep-equal contra la base de datos real, incluida la omisión de kindSource. Qué significa cada uno: búsqueda de personas.

⚠ Nombres anteriores (corte del contrato, [BREAK] del 2026-09-23): estos campos se llamaron tipo, tipoOrigen, observacion y nombrePublicado, con los valores juridica/desconocido y rut/sufijo; ninguno sale ya.

search_trademarks

La herramienta de marcas: la colección con sus filtros, el lote, la similitud y la ventana de oposición, en una llamada. Idéntica a REST POST /trademarks/search; sin los tres campos que eligen motor (similarTo, similarToTrademark, oppositionWindow) responde exactamente lo mismo que GET /trademarks para la misma pregunta —mismos filtros, mismo sobre, mismo JSON—, lote incluido. (Hasta el 2026-09-24 esa ruta GET tenía su propia herramienta gemela; se retiró porque era la misma pregunta.)

Entrada (todos los campos opcionales; ⛔ un argumento que la herramienta no declara es un error de entrada, nunca se ignora):

Campo Tipo Notas
q string Texto libre, hasta 256 caracteres. Con él, los resultados se ordenan por relevancia.
applicationNumber string[] El lote, hasta 100, cada número de hasta 17 caracteres. Aplica los demás filtros; ver abajo.
niceClass integer[] Clases de Niza 1–45 (OR dentro de la lista), hasta 45.
status string[] Estado publicado (el derivado, catálogo controlado), hasta 14.
signType string[] Tipo de signo (catálogo controlado), hasta 14 códigos de hasta 20 caracteres.
holder · representative · taxId string[] Partes, OR dentro de la lista: un elemento por nombre, con sus comas («PEPSICO, INC.» es uno; una coma nunca separa). Hasta 20 valores de 2 a 256 caracteres con al menos una letra o dígito; vacío o [] ⇒ error de validación; relation (current/former/all, defecto current) dice si vale quien la tiene hoy o quien la tuvo.
denomination · registrationNumber string La denominación (texto, hasta 512 caracteres; q, 256) · el número de registro (exacto, hasta 17).
goodsAndServices string ⭐ Texto de productos y servicios de las clases de la marca, por palabras, sin tildes ni mayúsculas (calzado encuentra «Calzados»); 2–200 caracteres. -palabra excluye, pero hace falta al menos una palabra que deba aparecer: sólo palabras vacías (de la) o sólo exclusiones (-calzado) es un 400 validation_error.
filedFrom/filedTo · expiresFrom/expiresTo · registeredFrom/registeredTo · publishedFrom/publishedTo YYYY-MM-DD Rangos de las cuatro fechas.
milestoneFrom/milestoneTo · milestoneKind YYYY-MM-DD · string[] ⭐ Marcas con algún hito en el rango: expiry, opposition_close, renewal_window_open y/o grace_end (milestoneKind acota; sin él, cualquiera de los cuatro). Cada tipo casa exactamente la fecha que publica la marca (el cierre, derivado o estimado; los de renovación, nunca en marcas del régimen anterior, de Madrid ni fuera de registrada/esperando_renovacion). Rango invertido = invalid_range; milestoneKind sin rango o con un tipo desconocido = validation_error.
renewalStatus string[] ⭐ Sólo las marcas cuyo renewalStatus (hoy, hora de Chile) es uno de not_due · window_open · grace · lapsed · renewed_expiry_pending (OR). Con el lote, «¿cuáles de esta lista están en gracia?» es UNA llamada, y cada marca devuelta trae ese mismo renewalStatus. Las de null no salen por ninguno; otro valor = validation_error.
liveOnly boolean Excluye las marcas en estado terminal: rechazada, denegada, desistida, abandonada, anulada, caducado, vencida.
partyRole string Limita taxId a un papel: holder o representative. Sin él, los dos. Exige taxId.
party string[] ⭐ Partes por id (de list_parties) y papel: "<id>:holder" o "<id>:representative", OR dentro de la lista (hasta 20). El papel significa lo mismo que en list_party_trademarks; vale relation. Sirve para partes sin RUT.
includeApplicationNumber · excludeApplicationNumber string[] ⭐ La cartera a mano (hasta 500 cada una): ((filtros de parte ∪ incluidas) − excluidas) ∩ demás filtros. Los filtros de parte son party/holder/representative/taxId; una incluida tiene que cumplir los demás filtros; la exclusión gana; sin filtro de parte, las incluidas son la cartera. Números como los escribe INAPI (991652209-2).
portfolio object ⭐ La cartera como objeto {party, refine, includeApplicationNumber, excludeApplicationNumber}: (((partes ∩ refine) ∪ incluidas) − excluidas) ∩ filtros de primer nivel. refine (los filtros de predicado de list_application_numbers) acota sólo las marcas de las partes: una incluida está siempre; la exclusión gana; los filtros de primer nivel se aplican a todo. Hasta 10.000 números por lista. Con él, party/includeApplicationNumber/excludeApplicationNumber de primer nivel son validation_error. También en list_application_numbers y get_renewal_calendar.
text object ⭐ La búsqueda de texto configurable (vocabulario de Algolia): {query, queryType, typoTolerance, minWordSizefor1Typo, minWordSizefor2Typos, exactOnSingleWordQuery, removeWordsIfNoResults, phonetic, semantic, getRankingInfo}. Con todo por defecto responde lo mismo que q. Configurado: primero el bloque de palabras clave (determinista, completo, tamaño exacto en total o, con aproximadas, en meta.keywordTotal; exacta → prefijo → palabras → errores → sort), después las aproximadas de phonetic/semantic (sólo en meta.estimatedTotal). Con q/denomination es validation_error. En list_application_numbers y portfolio.refine.text, sólo como conjunto (phonetic/semantic en false).
similarTo · similarToTrademark · allClasses · oppositionWindow string · string · boolean · string Eligen motor en vez de filtrar; ver «Los tres campos que eligen motor», abajo. allClasses sólo vale con similarToTrademark.
citedNorm · article · letter string Declarados, pero no filtran marcas: con cualquiera de ellos la llamada es un 400 validation_error que nombra el campo y remite a search_annotations (filtran anotaciones por la norma que citan).
facets string[] niceClass, status: recuentos en meta.facets.
sort string relevance, filedOn:desc… status/status:asc/status:desc ordena por el estado publicado.
limit · cursor · minScore Página (defecto 20, máximo 100) · cursor opaco · suelo de relevancia.

Salida: el sobre común del contrato — { results: [...], limit, next, hasMore, total?, meta } —, idéntico a REST. meta lleva siempre dataAsOf y coverageThrough; meta.estimatedTotal es una cota inferior; meta.facets (niceClass, status) sólo si se piden; meta.mode: "advanced" cuando un campo competidor desplazó a q. matchedFields[].field nombra el filtro que hizo salir cada marca (denomination, applicationNumber, registrationNumber, holder, representative, taxId). La carga útil es el primer bloque de texto del resultado (parséala como JSON).

El lote. Con applicationNumber la respuesta trae las marcas en el orden de la petición y meta.notFound con los números que no existen; los demás filtros se APLICAN (una marca que existe y no casa simplemente no sale), total es exacto y no hay página siguiente. limit, cursor, sort, minScore, q, denomination y facets con el lote son un error validation_error. Más de 100 es batch_too_large, nunca un recorte en silencio.

Hitos. Cada marca del resultado trae milestones[] ([] si no tiene). Con el lote, «¿qué marcas de esta lista tienen un hito en los próximos 30 días, y cuándo?» es UNA llamada: { "applicationNumber": [ …hasta 100… ], "milestoneFrom": "2026-09-24", "milestoneTo": "2026-10-24" }. Y «¿qué marcas cierran su ventana de oposición la semana que viene?», otra: { "milestoneKind": ["opposition_close"], "milestoneFrom": "2026-09-28", "milestoneTo": "2026-10-04" }. El core publica las fechas; a quién y cuándo avisar lo decide tu aplicación.

⛔ Un lote de cero devuelve un lote de cero, no la colección: construir la lista desde una cartera que resulta no tener marcas devolvería, si no, la primera página del corpus entero.

Los tres campos que eligen motor (excluyentes entre sí: pedir dos es un validation_error): similarTo (texto libre, ordenado por parecido en cuatro canales: fonético, léxico, semántico y de elemento distintivo; matchedBy dice cuáles la encontraron), similarToTrademark (una marca existente: excluye la base y acota a sus clases; allClasses: true ensancha) y oppositionWindow: "open" (marcas con fecha de publicación, cuyo 30.º día hábil es hoy o después y cuyo status no es terminal ni registrada/concedida —el mismo plazo que publica el objeto marca, que no mira el estado: una registrada con expired: false NO está en ventana—; exige niceClass y uno de q o applicationNumber). Con la similitud, applicationNumber es un validation_error; con la ventana es UN número de solicitud —la marca de referencia contra la que se ordena—, no un lote: más de uno es un validation_error. Con cualquiera de los motores, sort sólo admite relevance.

get_trademark

Obtiene UNA marca por su número de solicitud, con expansión opcional. Idéntica a REST GET /trademarks/{applicationNumber}.

Entrada:

Campo Tipo Notas
applicationNumber string El número de solicitud (obligatorio).
expand string[] classes, parties, annotations, encumbrances, norms. Lo no pedido viaja null (≠ []). norms (las normas citadas en las anotaciones, con recuento, fechas e ids; sin texto) exige además legal:read.
dedupe boolean Defecto true: las filas del MISMO hecho se colapsan en una, con las demás en duplicates[]. false devuelve cada versión. renewals es idéntico en los dos modos.

Salida: el objeto marca, plano. Un número desconocido devuelve un error de herramienta estructurado not_found, reflejando el 404 de REST: status: 404, title: "Not found" y el mismo detail (trademark 123 not found).

milestones[] viaja siempre: los hitos con fecha de la marca, [] si no hay. Cada uno dice de dónde sale (basis): source (un dato de INAPI, con el field verbatim) o derived (un plazo calculado, que lleva siempre anchor, rule y legalBasis — sin artículo no hay hito derivado) o estimated (la misma forma más estimateReasons: un plazo que la ley o el calendario no permiten afirmar). legalBasis es una lista de {norm, article, role}. Salen expiry (source, de expiresOn) y opposition_close (el cierre de la ventana de oposición: Ley 19.039 arts. 5 y 11, Ley 19.880 art. 25; estimated si se publicó en día inhábil o fuera de la cobertura del calendario; sin publicación no sale), y en las marcas nacionales registrada o esperando_renovacion con vencimiento desde el 2022-05-09 renewal_window_open y grace_end (vencimiento − 6 y + 6 meses, Ley 19.039 art. 24, Decreto 82/2022 art. 27, Código Civil art. 48 y Ley 19.880 art. 25; grace_end corrido al primer día hábil si es inhábil). Los cuatro se filtran con milestoneKind. ⭐ (44-14) Y appeal_close: la fecha límite para apelar un rechazo (024) o una aceptación parcial (444), el 15.º día hábil tras su publicación en el Estado Diario (Ley 19.039 art. 17 bis B y 11, Ley 19.880 art. 25), publicada pero no filtrable; su ancla auditable y lo que se omite y por qué los da get_deadlines. ⭐ (2026-10-10) Y dos más, tampoco filtrables: opposition_response_close (contestar el traslado de una oposición: 30.º día hábil tras su notificación, Ley 19.039 art. 9; estimated si el ancla se deduce) y grant_fee_close (acreditar el pago de los derechos de concesión: 60.º día hábil tras la notificación de la aceptación, Ley 19.039 art. 18 bis E; siempre estimated y con reservation en es/en/pt — la ley cuenta desde la ejecutoria e INAPI desde la notificación: citad la fecha con esa reserva). ⭐ (2026-10-26) Y resolution: la fecha en que INAPI aceptó o rechazó la solicitud (no es un plazo; anchor.kind acceptance/rejection con el acto, Ley 19.039 art. 13 con el papel notification), ausente si la solicitud no llegó a resolverse. ⭐ (2026-10-28) Y designation_ceased: la fecha en que INAPI dio por cesada una designación Madrid tras un DEATH de la OMPI (cese 1238/1240/1241/1242, no 1237; ancla = el acto de cese; Protocolo de Madrid y su Reglamento Común con el papel extinction); sale cuando la marca publica status: caducado por ese cese; ⭐ (2026-11-04) y también, anclado en el DEATH (anchor.kind: "wipo_death"), cuando la cancelación de la OMPI llegó durante el trámite e INAPI concedió después. ⭐ (2026-10-28) Aparte de los hitos, unas pocas marcas traen notices[] en get_trademark: hechos comprobados a mano en el expediente y en la OMPI; wipo_designation_ended dice que la OMPI inscribió que Chile ya no está designado, con la inscripción como fuente (source.reference, recordedOn, madridMonitorUrl) y el documento del expediente como respaldo (corroboration.documentIndex); wipo_refused_recording, que la OMPI no inscribió la declaración de concesión de INAPI porque Chile no está designado. Un aviso no decide status ni milestones: los deciden las anotaciones (Avisos). La lista de tipos, con ejemplo, está en Hitos.

renewalStatus viaja siempre (en get_trademark y en cada marca de search_trademarks): not_due | window_open | grace | lapsed | renewed_expiry_pending, evaluado en la fecha de la respuesta (hora de Chile), o null cuando la regla no se aplica — sin fecha de vencimiento, ni registrada ni esperando_renovacion, o vía Madrid. Describe el plazo para pedir la renovación; en grace el registro sigue vigente y aún puede renovarse (caduca por falta de renovación sólo si la gracia vence sin pedirla: Ley 19.039 art. 24 inc. 2º; Decreto 82/2022 art. 27 inc. 2º). renewed_expiry_pending, antes o después del vencimiento: la renovación ya está concedida y el vencimiento publicado aún no se ha actualizado; la marca no publica entonces renewal_window_open ni grace_end. La regla, en Hitos. También es un filtro de search_trademarks (renewalStatus), con la misma regla y la misma fecha que el campo.

renewals[] (en get_trademark ≡ GET /trademarks/{applicationNumber}, siempre presente, vacía si no hay ninguno) son los actos de renovación de la marca en orden cronológico, y cada uno dice qué es en kind: request (la renovación está pedida: presentada, u observada y pendiente; aún no concedida en esa fecha), grant (INAPI la concede, la acepta o la inscribe) u outcome (INAPI resuelve la solicitud sin concederla: abandono, desistimiento, rechazo…). lastRenewalOn es la fecha del último grant, y se omite si no hay ninguno: una renovación pedida y después abandonada o rechazada no cuenta como renovación.

procedureHistory[] (en get_trademark ≡ GET /trademarks/{applicationNumber}, siempre presente, vacía si no hay ninguno, igual con dedupe o sin él y con cualquier expand) es el índice del expediente de INAPI: los pasos de la tabla de trámites que muestra la ficha pública del expediente y, mezcladas con ellos por fecha, las anotaciones numeradas (presentaciones como una transferencia o una renovación, y las resoluciones sobre ellas). Va sin las filas del Estado Diario y sin la agrupación por hecho de annotations[]. Cada entrada lleva annotationId (el mismo id que en annotations[]), date, code (el código de INAPI), inapiText (la leyenda de INAPI para ese código, la misma que sectionName; null si INAPI nunca lo nombró), reference (el número de resolución o de escrito que INAPI imprime en la fila, como 2026/82718 o C/2026/123550; null si no imprime ninguno o si la fila no se ha leído desde que se guarda: hoy, la mayoría de las filas históricas) y annotationNumber (el número de anotación de INAPI de la fila; null en un paso de la tabla de trámites).

Una presentación que INAPI lista como paso y también como anotación numerada sale una sola vez, como la anotación numerada, emparejada una a una por fecha y código: dos presentaciones del mismo código el mismo día son dos entradas. Si esa entrada no trae reference, toma la del paso. Un paso que INAPI devolvió una vez con su observación y otra sin ella sale una sola vez, con el annotationId de la versión con observación. El orden es por fecha y, dentro del mismo día, por el lugar de cada código en el flujo del procedimiento de INAPI (la aceptación a trámite 009 antes que el pago de publicación 439, la concesión 158 antes que el título 1230), aprendido de los índices del expediente; los códigos sin lugar conocido van detrás y el resto de empates sigue el orden en que se registraron las filas. La posición de INAPI no se guarda, así que algún día puede salir en otro orden que en INAPI. Una anotación guardada sin su número (falta en parte de la historia) no se distingue de un paso y sale con annotationNumber: null.

Dos pasos del mismo día y del mismo código que INAPI distingue solo por su número de escrito (reference) son dos entradas. Un paso que INAPI lista varias veces igual el mismo día (sin texto ni número que lo distinga) sale tantas veces como lo lista, y todas las copias llevan el mismo annotationId, así que ese id no es único dentro de la lista. Parte de la historia se guardó antes de contarlo y muestra ese paso una vez hasta que la marca se vuelve a leer. Las marcas del Protocolo de Madrid no tienen la entrada «Expediente inicial (*)»: el índice del expediente la imprime, pero la ficha pública de INAPI no la publica, y no se inventa.

Forma de los errores

Todos los errores de herramienta comparten una sola forma: un resultado de herramienta con isError: true cuyo texto es un application/problem+json de la RFC 9457 — { "type", "title", "status", "detail", "code", "requestId" }—, idéntico al cuerpo que la API REST devuelve para 4xx/5xx (REST≡MCP). Un cliente puede hacer JSON.parse(text).code de forma uniforme para cualquier error de herramienta.

⚠ requestId viaja vacío en MCP: el transporte no tiene un id de petición propio, y el contrato declara el campo siempre presente. Vacío es «no hay», no «se nos olvidó».

Los code que verás:

code Significado
unauthorized Clave ausente, inválida, revocada o expirada.
forbidden La clave es válida pero le falta el scope requerido (p. ej. brands:read).
validation_error Entrada inválida (p. ej. la regla "exactamente uno de businessDays o preset").
not_found Búsqueda por id de un recurso desconocido (o de otro tenant). status 404, con el detail de REST.
query_timeout 504: la consulta excedió el presupuesto de tiempo; reintentable.
service_unavailable 503: dependencia temporalmente no disponible (la base sin recursos, el almacén de vigilancias, search_trademarks con q cuando fallan todos sus canales —antes un resultado vacío—…); reintentable.
coverage_not_declared 503 de list_holidays: el calendario no declara ningún año cubierto; reintentable.
application_terminal 422 de watch_application: la solicitud existe pero su estado es terminal; no se puede vigilar. El estado viaja en applicationStatus (y en detail).
watch_limit_reached 422 de watch_application: la org ya tiene el máximo de solicitudes vigiladas activas de su plan; el máximo viaja en limit.
watch_daily_limit_reached 429 de watch_application: la org agotó las altas del día (día de Chile); lleva limit y resetsAt (cuándo se reabre), los dos al primer nivel del cuerpo.
image_similarity_not_available 503 de find_similar_logos, operación futura declarada: NO es reintentable (a diferencia de service_unavailable); no estará disponible hasta que una entrada del changelog del contrato lo anuncie.
out_of_coverage Se pidió algo fuera de la cobertura declarada (un tramo del calendario de feriados, el boletín de un día, el texto de una norma o la versión de un documento, los indicadores). El error lleva coverage con el rango real.
internal_error Error interno genérico — nunca filtra detalles internos.

Los detalles internos de la base de datos o del transporte nunca se incluyen en el mensaje.

⭐ status es el del gemelo REST: 401 para unauthorized, 403 para forbidden —con el mismo detail que REST, que nombra el scope que falta (API key lacks required scope: brands:read)—, 400 para validation_error, 404 para not_found —con el mismo detail que REST (trademark 123 not found…)—, 422 para out_of_coverage. Hasta el 2026-09-28 el MCP decía 400 para unauthorized y forbidden, y hasta el 2026-09-29 también para not_found en 18 herramientas; el code no cambió.

⭐ Desde el 2026-09-30 (ERR-1) cada code tiene un solo status, el mismo que REST, sacado de una tabla única del código. Hasta esa fecha salían con 400: query_timeout cuando se agotaba el tope total de la herramienta (ahora 504), watchlist_too_large y unsafe_callback (ahora 422), idempotency_conflict (ahora 409) y service_unavailable del almacén de vigilancias (ahora 503). list_holidays sin calendario declarado decía service_unavailable con 400; ahora es coverage_not_declared con 503, como REST. (watchlist_too_large, idempotency_conflict, concurrent_modification y watchlist_retired dejaron de existir el 2026-10-04 con las herramientas de watchlists, y ninguna herramienta devuelve ya unsafe_callback.)

Conecta tu cliente de IA

Cliente MCP genérico de Streamable-HTTP

La mayoría de los clientes MCP aceptan una entrada de servidor HTTP con encabezados personalizados. Apúntalo al endpoint y envía tu clave en el encabezado X-API-Key:

{
  "mcpServers": {
    "tarno": {
      "type": "streamable-http",
      "url": "https://mcp.tarno.cl",
      "headers": { "X-API-Key": "<API_KEY>" }
    }
  }
}

Claude Desktop (mediante el puente mcp-remote)

Claude Desktop lanza servidores MCP sobre stdio, y su interfaz integrada de conector personalizado solo admite servidores con OAuth o sin autenticación — no tiene un campo para un encabezado X-API-Key personalizado. Para llegar a un endpoint autenticado por encabezado como Tarno, haz de puente con el asistente mcp-remote, que corre localmente sobre stdio e inyecta el encabezado en cada solicitud.

Requisito previo: Node.js 18 o superior en tu PATH (Claude Desktop invoca npx). Verifica con node --version.

1. Abre tu archivo de configuración de Claude Desktop (créalo si no existe):

OS Path
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json

También puedes llegar a él desde Settings → Developer → Edit Config.

2. Agrega Tarno a mcpServers. Mantén tu clave en una entrada env (no en línea dentro de args) — este es el patrón seguro y evita un bug conocido de Claude Desktop/Windows donde un espacio dentro de un valor de args se escapa mal al invocar npx:

{
  "mcpServers": {
    "tarno": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.tarno.cl",
        "--header", "X-API-Key:${TARNO_API_KEY}"
      ],
      "env": {
        "TARNO_API_KEY": "<API_KEY>"
      }
    }
  }
}

Reemplaza <API_KEY> con tu clave emitida por el operador. (Como una clave de API nunca contiene espacios, la forma en línea "--header", "X-API-Key:<API_KEY>" también funciona — pero el patrón env de arriba mantiene la clave fuera de la lista de args y esquiva el bug del espacio.)

3. Reinicia Claude Desktop por completo (cierra y vuelve a abrir). Tarno entonces aparece como una fuente de herramientas conectada; puedes pedirle a Claude que busque marcas u obtenga el detalle de una marca, y él llamará a search_trademarks / get_trademark por ti.

Resolución de problemas: si el servidor no aparece, confirma que node --version funcione en una terminal, que el JSON sea válido (sin comas finales) y que la clave sea una clave activa y con scope — un error de herramienta unauthorized/forbidden significa que la clave está ausente, es inválida o le falta brands:read.

Para un cliente programático (connect + callTool) usando @modelcontextprotocol/sdk, consulta los ejemplos de código.

Ver también