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
initializea 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) yiris://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:readpara 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-classesy 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-BRes traducción propia de Tarno. Las herramientas de catálogo (list_nice_classes,list_legal_norms,list_sections,list_holidays) dicen enmeta.dataAsOfla fecha de su fuente —la OMPI, la BCN, el calendario—, no la de la sync de marcas; enlist_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, ysectionFamilyen las anotaciones) es una cadena abierta: hoypresentacion,forma,fondo,publicacion,pago,oposicion,resolucion,renovaciony, desde el 2026-10-10,caducidad(los actos de un juicio de caducidad por falta de uso; no es el estadocaducado) 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 llevaannotationNumber, 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. Esnullcuando no se conoce (el Estado Diario no lo imprime): un hueco esnull, nunca un número supuesto.meta.coverageThroughesnullen los catálogos (no tienen «hasta»), salvo enlist_holidays: el último día con calendario declarado. Detalle en Cobertura. - Guiones — tres, por su nombre real:
availability_check(¿está disponible un nombre? — usasearch_trademarksconsimilarTopara los parecidos yqpara la coincidencia literal),case_history(¿qué ha pasado con un expediente?) yweekly_watch(¿qué parecidas tienen las solicitudes que vigilo? — su único argumento,applicationNumber, es opcional: con él leelist_similarity_hitsde esa solicitud; sin él,list_watched_applicationsylist_similarity_hitsde 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). Confrom/toobligatorios (como mucho 366 días, los dos extremos incluidos) y el filtro de marcas —el lote de hasta 100applicationNumber,renewalStatus,holder,niceClass…—, una fila por (marca, hito de renovación) en el rango:renewal_window_openygrace_end(Ley 19.039 art. 24), cada una idéntica al hito de losmilestones[]de la marca, más suapplicationNumber, por fecha y número. «Las fechas de renovación de mi lista este año» es UNA llamada. Pagina conlimit+cursor,totalexacto.q, la similitud y la ventana de oposición sonvalidation_error. Acepta el objetoportfolio(una marca añadida a mano está aunque no cumplaportfolio.refine); sin él, la misma respuesta queGET /trademarks/renewal-calendar. Detalle: informes.
list_parties— los dos órdenes son rápidos. Sinsort, 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 conkind/role). Las partes sin marcas nunca se esconden (trademarkCount: 0), ymetallevadataAsOfycoverageThrough.
list_party_relations— las relaciones de una parte (2026-09-24). Gemela deGET /parties/{id}/relations. Aristas tipadas con otras partes:co_holder,represents/represented_by,assigned_to/assigned_from(cesionesA07T) yopposed/opposed_by(oponentes identificados). Cada una con la otra parte,trademarkCount,firstOn/lastOn, hasta 5 marcas deevidence(+evidenceTruncated) ycoverageFrom: las oposiciones sólo desde el 2024-04-19 — «no se opuso nunca» se lee «no desde entonces». Filtrostype(lista) yrelation. ⛔ 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:reado el del informe), denegado por defecto. Detalle: informes. -get_daily_bulletin≡GET /reports/daily-bulletin: lo que el Estado Diario publicó endate, fila a fila con partes, paginado, contotalexacto y el índice del día enmeta.sections({code, label, count}). Un día sin boletín ingerido esout_of_coverage(422) con la cobertura, nunca una lista vacía. -get_clearance_report≡GET /reports/clearance: contextyniceClass, los confundibles por canal (phonetic,fuzzy,semantic) coninOppositionWindow(pertenencia; el cierre viaja enmilestonescomoopposition_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 supartyId(nunca por su nombre) — recuentos por estado y por clase, las marcas con un vencimiento (expiry) dentro dehorizonDays(defecto 90, máximo 366), las que están hoy en ventana de oposición (pertenencia; el cierre viaja enmilestonescomoopposition_close), quién se opuso, sus representantes y el resumen de sus relaciones. Cada marca trae surenewalStatus(art. 24), ybyRenewalStatuslas 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 contraapplicationNumber— su ficha conmilestones, si está hoy en ventana (pertenencia; el cierre viaja enmilestonescomoopposition_close), conownApplicationNumbersu 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 porapplicationNumber— 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 (iddelist_legal_norms) en la versión que regía enasOf(defecto: hoy en Chile), con sus letras, incisos y notas de BCN.letter/subsectionacotan;transitional: truelee 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 esout_of_coverage(422); una clave repetida,ambiguous_selector(409).dataAsOfes 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 suextractionStatus; filtroskindyq(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;versionlee una anterior. Una versiónimage_onlyresponde conoutline: []y lo declara; unaocr(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, porpath(III.D.▪1.§7) o porparagraph(el § que cita un abogado). La cita estable escode+version.seq+path. Un párrafo repetido esambiguous_selector(409) con lospath; una versión sin texto (image_only),out_of_coverage(422).dataAsOfes 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/documentacotan. -search_statutes≡POST /legal-norms/search: busca ARTÍCULOS de ley en el texto que rige hoy (la misma regla queget_legal_norm_article), en el deasOf, o conallVersions: trueen TODAS las vigencias — el mismo texto repetido entre vigencias sale una vez con todas envalidity.normacota a una norma del catálogo (sin texto:out_of_coverage).Las dos:
modehybrid(defecto),textosemantic;matchedBydice qué canal encontró cada acierto; si el canal de parecido no puede correr,hybridlo dice enmeta.channels.semantic: "unavailable"ysemanticesservice_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, conamountClpDERIVADO al leer (amountUtm × utm.value, exacto, sin redondear) con la UTM deutmMonth(defecto: el mes en curso en Chile);utm.basisdice si es la del mes pedido (requested_month) o la última publicada (latest_published); sin UTM,null.surchargeDoubtes 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 porcodey rangofrom/to, conmeta.coverage; un rango entero fuera esout_of_coverage(422). ⚠ Cada fila del IPC lleva subaseNote: 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 (effectiveDateliteral 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_annotationconexpand: ["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 queget_legal_norm_article) y las señales de las Directrices: los documentos que citan ese artículo/letra concitingCount/unnamedCounty hasta tres apartados, nunca «el» apartado que la interpreta.textStatusdice por qué una cita no trae texto. Exigelegal:readademás debrands:read(sin él,forbiddensin consumir cuota); sólo en el detalle — los listados rechazanexpand. Sinexpand, 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 afrom(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 debusinessDays(N lo pones tú:term.source: caller,term.legalBasis: null— es un conteo, no un plazo) opreset; el único preset esopposition(art. 5, 30 días hábiles desde la publicación), con la misma fecha que elopposition_closede la marca. Un ancla inhábil o un tramo fuera del calendario danbasis: estimatedcon su motivo. Permisobrands:read. -calculate_fees≡POST /fee-schedule/calculate: las tasas OFICIALES de INAPI deapplication_and_registrationorenewal, porniceClassCountoapplicationNumber, 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). Permisobrands:read. -get_party_outcomes≡GET /parties/{id}/outcomes: los desenlaces de las marcas de una parte por grupo de estado publicado, connygrantSharesobre las decididas (pendientes fuera;nullsin decididas) y la definición entera. No es una «tasa de éxito». Permisobrands:read. -compare_trademarks≡POST /trademarks/compare: dos marcas (texto oapplicationNumber) 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 ydistinctiveSignalssobre los núcleos; sin puntuación global ni nivel (comparar). Permisobrands: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 deget_party_outcomes, percentiles APROXIMADOS (±15 días) del tiempo hasta el registro con sun, proporción con actos de fondo, forma y oposición, y la cobertura dicha encoverage.503 class_stats_pendingantes del primer cálculo (estadísticas). Permisobrands: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: permisoreports:conflict-landscape:readoreports: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 unsignalIndex0–100 con su fórmula literal y los pesos aplicados (provisionales); «no es un veredicto» (índice). Un INFORME: permisoreports:registration-signals:readoreports: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). Permisobrands: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 enmilestones(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: permisoreports:filing-context:readoreports:read; conexpand=legalTexts, ademáslegal: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). Permisologo: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 mismaimagequeanalyze_logo,niceClasses,limit; salida futura:results[]conscoreysignals.visualde parecido visual) para poder programar contra ella, pero hoy responde siempre503 image_similarity_not_available, nunca resultados. No la reintentes ni presentes su respuesta como «no hay marcas parecidas» (parecido por imagen). Permisologo:similar, que no se concede a ninguna clave todavía. Es la última detools/list. -search_annotationsacepta ademáspartyId/taxId(+partyRole,relation) ytrademarkStatus;search_trademarks,partyRolejunto ataxId(anotaciones por parte, RUT). - Toda anotación (search_annotations,get_annotation, el boletín) llevainapiTermLabel: 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;nullen los demás. ⛔ No es una fecha ni un hito (el rótulo de INAPI). -search_annotationspor 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),denominationydetectedAten cada anotación y el horizontemeta.detectedThroughpara encadenar «cambios desde X» sin saltar filas (por lista y detección).detectedAftersolo (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;maxActAgeDaysdeja fuera los actos que ya tenían más de N días al detectarse (una página puede venir corta o vacía connext: síguelo) (el feed).
get_trademark_insights— las dimensiones degroupBy.filedMonth,status,niceClass,holder,representative, desde el 2026-09-24expiresMonthytransferYear, y desde el 2026-09-25renewalStatus. Todas devuelven{ key, label, count }conlabelenes-CL/en/pt-BR, y aplican el filtro completo desearch_trademarks(o400). -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 enmeta.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 INAPIA07T) 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 surenewalStatus(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 ameta.undatedCounty las que tienen fecha pero la regla no se les aplica (Madrid, o niregistradaniesperando_renovacion) ameta.notApplicableCount: Σcount+undatedCount+notApplicableCount= marcas filtradas. Nunca un estado deducido. -niceClassrotula 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_trademarksyget_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_trademarksusasearch_trademarks, yget_trademark_insightsen lugar desearch_trademark_insights(mismos argumentos).Las personas dicen qué clase de parte son. Cada persona de
get_trademark(parties,holders,representatives,formerParties) llevakind(natural/legal/unknown),kindSource(tax_id/suffix/manual/name_pattern, omitido, nuncanull, 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) yrevision. Enlist_partiescada persona lleva el mismokind,kindSource(ahínullcuando no hubo señal),publishedName, la cláusula comojurisdictionClausey la revisión comoreview. Se leen bajo el mismo scopebrands:read. La paridad REST≡MCP está verificada con un test deep-equal contra la base de datos real, incluida la omisión dekindSource. Qué significa cada uno: búsqueda de personas.⚠ Nombres anteriores (corte del contrato,
[BREAK]del 2026-09-23): estos campos se llamarontipo,tipoOrigen,observacionynombrePublicado, con los valoresjuridica/desconocidoyrut/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.
⚠
requestIdviaja 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
- Autenticación y scopes —
X-API-Key,brands:read, ciclo de vida, códigos de error. - Ejemplos de código — un cliente mínimo del SDK de MCP.
- Primeros pasos — la puesta en marcha equivalente en REST.