Skip to main content
Glama
Angelthebestone

Normativa Colombia MCP

by Angelthebestone
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Obtener el texto de un documento por fuente

obtener_documento

Fetch paginated text excerpts from Colombian legal and jurisprudential documents across seven sources by giving source-specific parameters; search terms, articles, sections, or change history.

Instructions

Devuelve el texto (troceado, nunca entero) de una de las siete fuentes con texto. CADA FUENTE EXIGE LO SUYO y los parámetros de otra no valen con ella: gestor necesita id; corte, ruta; suprema, ruta y sala; consejo, token; dian, link; creg, ruta; sectorial, entidad y url. Una combinación que no encaje se rechaza antes de salir a la red, diciendo qué falta y el ejemplo mínimo que funciona. Dentro del texto: buscar_en_texto localiza un término, articulo (gestor) o seccion (corte, suprema, consejo) una parte puntual, e historial (gestor) los cambios anotados. Respeta limite_caracteres (200–40.000, por defecto 8000), informa total/mostrado/omitido y devuelve el "desde" exacto del trozo siguiente.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idNoSolo gestor: id numérico de la norma
urlNoSolo sectorial: enlace del acto a leer, tal como lo devuelve buscar_normativa_sectorial
linkNoSolo dian: nombre del archivo, ej. "decreto_1625_2016.htm"
rutaNocorte/suprema/creg: ruta del documento
salaNoSolo suprema: la MISMA sala con la que se encontró
desdeNo
tokenNoSolo consejo: token que devuelve buscar_jurisprudencia_consejo_estado
enteroNoEn vez de trocear, escribe el documento a disco y devuelve la ruta con un trozo del texto
fuenteYesDe qué fuente sale el documento
entidadNoSolo sectorial: id del regulador (los lista buscar_normativa_sectorial)
seccionNoSolo corte, suprema y consejo: devuelve solo esa parte de la providencia. "consideraciones" es la motivación de la MAYORÍA; "salvamentos" y "aclaraciones" son los votos particulares, que NO son doctrina de la Sala.
articuloNoSolo gestor: número de artículo
historialNoSolo gestor: en vez del texto, devuelve los cambios anotados sobre la norma
sin_temasNoSolo gestor: omite el bloque de temas asociados (ahorra contexto cuando solo se quiere el articulado)
max_pasajesNoMáximo de pasajes con buscar_en_texto (por defecto 10)
ruta_destinoNoCarpeta donde guardar el archivo (con entero o para descargar el PDF/Word sin devolver texto)
buscar_en_textoNoDevuelve solo los fragmentos que mencionan este término
limite_caracteresNoTope del TEXTO devuelto; se ajusta al rango 200–40.000

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv1.14.0
    • changedInput schema / properties / seccion / description
      Previous value: -"Solo corte: devuelve solo esa parte de la providencia"New value: +"Solo corte, suprema y consejo: devuelve solo esa parte de la providencia. \"consideraciones\" es la motivación de la MAYORÍA; \"salvamentos\" y \"aclaraciones\" son los votos particulares, que NO son doctrina de la Sala."
    • changedInput schema / properties / seccion / enum
      Previous value: -[
-  "antecedentes",
-  "consideraciones",
-  "decision"
-]New value: +[
+  "encabezado",
+  "antecedentes",
+  "consideraciones",
+  "decision",
+  "salvamentos",
+  "aclaraciones",
+  "notas"
+]
  2. Changed1 schema field changedv1.13.0
    • addedInput schema / properties / sin_temas
      Added value: +{
+  "description": "Solo gestor: omite el bloque de temas asociados (ahorra contexto cuando solo se quiere el articulado)",
+  "type": "boolean"
+}
  3. Addedv1.11.2

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and delivers: chunked-not-whole returns, validation failure before the network with a stated missing-parameter and a working minimal example, total/shown/omitted reporting, the exact 'desde' cursor for the next chunk, and the disk-write alternative via 'entero'.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core behavior and the source-parameter matrix, then the return-metadata contract. Dense but every clause carries information; the liberal ALL-CAPS emphasis is stylistic noise rather than waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 18-parameter, no-annotation, no-output-schema tool, the description covers invocation rules per source, error behavior, and return shape including pagination. Nothing an agent needs to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 94%, so the per-parameter meanings are already documented with 'Solo X' prefixes. The description usefully synthesizes the source-to-parameter matrix in one place, but adds little semantic detail beyond what the schema fields already state.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb and resource (devuelve el texto de un documento) and immediately constrains scope: 'troceado, nunca entero'. It enumerates the seven sources and distinguishes the tool from siblings by defining exactly which source each invocation targets.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit per-source parameter requirements ('gestor necesita id; corte, ruta; suprema, ruta y sala...') and states that mismatched combinations are rejected before network access. It implies but does not explicitly state the workflow position relative to siblings like buscar_normas, so routing guidance is strong but not fully spelled out.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools