API para desarrolladores

La Biblioteca Legal de Colombia como servidor MCP

Name: Kelsen
Author: Kelsen

Conecte Kelsen a Claude, Cursor, n8n o cualquier cliente compatible con el protocolo MCP. Búsqueda de normas y jurisprudencia, consulta de artículos y verificación de vigencia, sobre el corpus jurídico colombiano más completo.

Conecte en minutos

Endpoint HTTP estándar. Pegue la configuración en su cliente MCP y empiece a consultar.

Vigencia primero

Cada resultado indica si la norma sigue vigente, según el Citator de Kelsen.

Sin construir el corpus

Casi un millón de documentos y más de 500 mil providencias ya indexados y mantenidos por nosotros.

Herramientas disponibles

Herramienta	Qué hace	Parámetros
buscar_normas	Busca leyes, decretos, códigos, doctrina y el Estatuto Tributario. Cada resultado trae su estado de vigencia.	query (texto), area (opcional), solo_vigente (opcional — Si es true, excluye del resultado los fragmentos cuya vigencia registrada (columna o corrección editorial) es false. Esto incluye el fragmento cuyo texto trae una marca de derogatoria sin derogante resuelto: si esa marca aparece en el resultado se rotula “sin dato”, no “derogada”, pero con el filtro activado se excluye de todas formas. Los fragmentos sin ninguna marca (vigencia nula) se conservan siempre y se etiquetan “sin dato”.)
buscar_jurisprudencia	Busca providencias de las altas cortes (Corte Constitucional, Consejo de Estado, Corte Suprema).	query (texto), tipo_sentencia (C / T / SU, opcional)
consultar_articulo	Recupera un artículo específico por referencia exacta.	referencia (texto)
vigencia	Verifica si una norma sigue siendo derecho vigente y devuelve la cita en formato judicial colombiano.	referencia (texto)
verificar_cita	Anti-alucinación: confirma si una cita (norma o sentencia) EXISTE en el corpus y su estado de vigencia. Devuelve NO ENCONTRADA si la referencia es inexistente.	cita (texto)

Salidas reales

Ejemplos de structuredContent capturados contra el corpus en producción por la prueba de verdad del MCP (recortados a tres resultados y 200 caracteres de contenido).

verificar_cita({"cita":"Sentencia C-075 de 2026"})

{
  "version": "4",
  "veredicto": "EXISTE",
  "estado_vigencia": "no_aplica",
  "fuente": "Sentencia C-75/26",
  "cita": null,
  "afectada_por": null,
  "url": "https://www.corteconstitucional.gov.co/relatoria/2026/C-075-26.htm",
  "procedencia": {
    "derivacion": "no_aplica",
    "confianza": "sin_dato",
    "limite": null,
    "evidencia": null,
    "verificable_en": "https://www.corteconstitucional.gov.co/relatoria/2026/C-075-26.htm"
  },
  "confirmacion": null
}

vigencia({"referencia":"Ley 1437 de 2011"})

{
  "version": "4",
  "documentos": [
    {
      "fuente": "Ley 1437 de 2011",
      "fuente_id": "7abf2e72-8c47-461a-8d2f-78adb4449af4",
      "estado_vigencia": "vigente",
      "vigente": true,
      "cita": "Ley 1437 de 2011.",
      "afectada_por": null,
      "articulos_con_estado_propio": [
        {
          "articulo": "Artículo 1",
          "estado_vigencia": "modificada",
          "procedencia": {
            "derivacion": "grafo_resuelto",
            "confianza": "verificado",
            "limite": null,
            "evidencia": "Ley 1564 de 2012 · modifica · Ley 1437 de 2011",
            "verificable_en": "http://www.secretariasenado.gov.co/senado/basedoc/ley_1437_2011.html"
          }
        },
        {
          "articulo": "ARTÍCULO 1o.",
          "estado_vigencia": "modificada",
          "procedencia": {
            "derivacion": "grafo_resuelto",
            "confianza": "verificado",
            "limite": null,
            "evidencia": "Ley 1564 de 2012 · modifica · Ley 1437 de 2011",
            "verificable_en": null
          }
        },
        {
          "articulo": "Artículo 2",
          "estado_vigencia": "modificada",
          "procedencia": {
            "derivacion": "grafo_resuelto",
            "confianza": "verificado",
            "limite": null,
            "evidencia": "Ley 1564 de 2012 · modifica · Ley 1437 de 2011",
            "verificable_en": "http://www.secretariasenado.gov.co/senado/basedoc/ley_1437_2011.html"
          }
        }
      ],
      "url": "http://www.secretariasenado.gov.co/senado/basedoc/ley_1437_2011.html",
      "procedencia": {
        "derivacion": "flag_de_fragmento",
        "confianza": "indicativo",
        "limite": "Estado sin arista que lo respalde — verifíquelo en la fuente antes de citar.",
        "evidencia": null,
        "verificable_en": "http://www.secretariasenado.gov.co/senado/basedoc/ley_1437_2011.html"
      },
      "confirmacion": null
    }
  ]
}

consultar_articulo({"referencia":"Artículo 86 de la Constitución"})

{
  "version": "4",
  "resultados": [
    {
      "fuente": "Constitución Política de 1991",
      "fuente_id": "0e4a7661-3825-4fc0-9011-831eed31b335",
      "tipo": "constitucion",
      "articulo": "ARTICULO 86.",
      "contenido": "ARTICULO 86.\nToda persona tendrá acción de tutela para reclamar ante los jueces, en todo momento y lugar, mediante un procedimiento preferente y sumario, por sí misma o por quien actúe a su nombre, la…",
      "url": null,
      "fecha": null,
      "estado_vigencia": "vigente",
      "vigente": true,
      "vigencia_nota": null,
      "afectada_por": null,
      "relevancia": null,
      "procedencia": {
        "derivacion": "flag_de_fragmento",
        "confianza": "indicativo",
        "limite": "Estado sin arista que lo respalde — verifíquelo en la fuente antes de citar.",
        "evidencia": null,
        "verificable_en": null
      },
      "confirmacion": {
        "via": "etiqueta_de_articulo",
        "confianza": "verificado",
        "limite": null
      }
    },
    {
      "fuente": "Constitución Política de 1991",
      "fuente_id": "779ecb25-c554-44b5-a726-26cc938614b4",
      "tipo": "constitucion",
      "articulo": null,
      "contenido": "Antecedentes \n\n ARTICULO 86. Toda persona tendrá acción de tutela para reclamar ante los jueces, en todo momento y lugar, mediante un procedimiento preferente y sumario, por sí misma o por quien actúe…",
      "url": "http://www.secretariasenado.gov.co/senado/basedoc/constitucion_politica_1991.html",
      "fecha": null,
      "estado_vigencia": "vigente",
      "vigente": true,
      "vigencia_nota": null,
      "afectada_por": null,
      "relevancia": null,
      "procedencia": {
        "derivacion": "flag_de_fragmento",
        "confianza": "indicativo",
        "limite": "Estado sin arista que lo respalde — verifíquelo en la fuente antes de citar.",
        "evidencia": null,
        "verificable_en": "http://www.secretariasenado.gov.co/senado/basedoc/constitucion_politica_1991.html"
      },
      "confirmacion": {
        "via": "coincidencia_por_contenido",
        "confianza": "indicativo",
        "limite": "El fragmento se identificó por su texto, no por una etiqueta de artículo: podría transcribir el artículo de otra norma. Verifíquelo en la fuente antes de citar."
      }
    }
  ]
}

buscar_jurisprudencia({"query":"casación laboral pensión de sobrevivientes compañera permanente"})

{
  "version": "4",
  "resultados": [
    {
      "fuente": "Sentencia SU.444/23",
      "fuente_id": "9373df6d-e276-4821-92b7-81ccbf9c367a",
      "tipo": "sentencia_su",
      "articulo": null,
      "contenido": "decisión, la Corte Suprema recalcó que esas disposiciones establecen el derecho supletorio de los compañeros permanentes a acceder a la pensión de sobrevivientes, supeditado a la falta de cónyuge supé…",
      "url": "https://www.corteconstitucional.gov.co/relatoria/2023/SU444-23.htm",
      "fecha": "2023-10-26",
      "estado_vigencia": "no_aplica",
      "vigente": null,
      "vigencia_nota": null,
      "afectada_por": null,
      "relevancia": 0.8815438,
      "procedencia": {
        "derivacion": "no_aplica",
        "confianza": "sin_dato",
        "limite": null,
        "evidencia": null,
        "verificable_en": "https://www.corteconstitucional.gov.co/relatoria/2023/SU444-23.htm"
      },
      "confirmacion": null
    },
    {
      "fuente": "Sentencia T-1074/12",
      "fuente_id": "8de62ecc-4bf5-4ce5-9440-1b9eb6c092d2",
      "tipo": "sentencia_t",
      "articulo": null,
      "contenido": "RESUELVE:\n\nPrimero.- REVOCAR la sentencia proferida por el Tribunal Superior del Distrito Judicial de Cali, Sala Laboral, del 24 de mayo de 2012 que confirmó la dictada por el Juzgado Noveno Laboral d…",
      "url": "https://www.corteconstitucional.gov.co/relatoria/2012/T-1074-12.htm",
      "fecha": "2012-12-12",
      "estado_vigencia": "no_aplica",
      "vigente": null,
      "vigencia_nota": null,
      "afectada_por": null,
      "relevancia": 0.8800674,
      "procedencia": {
        "derivacion": "no_aplica",
        "confianza": "sin_dato",
        "limite": null,
        "evidencia": null,
        "verificable_en": "https://www.corteconstitucional.gov.co/relatoria/2012/T-1074-12.htm"
      },
      "confirmacion": null
    },
    {
      "fuente": "STP2395-2022.pdf",
      "fuente_id": "1e386f46-35b8-4cd5-b128-c67c3aee6085",
      "tipo": "sentencia",
      "articulo": null,
      "contenido": "Expuso que la figura procesal\napropiada para integrar el contradictorio cuando se discutía\nuna pensión de sobrevivientes entre cónyuge y compañera\npermanente o compañero permanente, o entre compañeras…",
      "url": "https://consultaprovidencias.cortesuprema.gov.co/#/visualizador/L3Zhci93d3cvaHRtbC9JbmRleC9UVVRFTEFTL1BFTkFMLzIwMjIvRHJhLiBNeXJpYW0gw4F2aWxhIFJvbGTDoW4vU2VudGVuY2lhcy9TVFAyMzk1LTIwMjIucGRm/Tutelas/STP2395-2022",
      "fecha": "2022-03-07",
      "estado_vigencia": "no_aplica",
      "vigente": null,
      "vigencia_nota": null,
      "afectada_por": null,
      "relevancia": 0.86928266,
      "procedencia": {
        "derivacion": "no_aplica",
        "confianza": "sin_dato",
        "limite": null,
        "evidencia": null,
        "verificable_en": "https://consultaprovidencias.cortesuprema.gov.co/#/visualizador/L3Zhci93d3cvaHRtbC9JbmRleC9UVVRFTEFTL1BFTkFMLzIwMjIvRHJhLiBNeXJpYW0gw4F2aWxhIFJvbGTDoW4vU2VudGVuY2lhcy9TVFAyMzk1LTIwMjIucGRm/Tutelas/STP2395-2022"
      },
      "confirmacion": null
    }
  ]
}

buscar_normas({"query":"la acción penal prescribirá en un tiempo igual al máximo de la pena","solo_vigente":true})

{
  "version": "4",
  "resultados": [
    {
      "fuente": "Código Penal (Ley 599/2000)",
      "fuente_id": "b93ab3f0-06ed-47ff-aa69-aaeca1bede5e",
      "tipo": "ley",
      "articulo": "artículo\n8",
      "contenido": "artículo\n8\nde la Ley 2098 de 2021. El nuevo texto es el siguiente:> La acción penal prescribirá en un tiempo igual al máximo de la pena fijada en la ley, si fuere privativa de la libertad, pero en nin…",
      "url": null,
      "fecha": null,
      "estado_vigencia": "vigente",
      "vigente": true,
      "vigencia_nota": null,
      "afectada_por": null,
      "relevancia": 0.9341134,
      "procedencia": {
        "derivacion": "flag_de_fragmento",
        "confianza": "indicativo",
        "limite": "Estado sin arista que lo respalde — verifíquelo en la fuente antes de citar.",
        "evidencia": null,
        "verificable_en": null
      },
      "confirmacion": null
    },
    {
      "fuente": "Sentencia C-229/08",
      "fuente_id": "349e2d4d-5427-436d-a95e-816a4c333cfc",
      "tipo": "sentencia_c",
      "articulo": null,
      "contenido": "tencia C-229 08\r\rPRINCIPIO NON BIS IN IDEM-Concepto\r\rPRINCIPIO NON BIS IN IDEM-Consagración en instrumentos internacionales\r\rPRINCIPIO NON BIS IN IDEM-Alcance\r\rPRESCRIPCION DE LA ACCION PENAL-Concepto…",
      "url": "https://www.corteconstitucional.gov.co/relatoria/2008/C-229-08.htm",
      "fecha": "2008-03-05",
      "estado_vigencia": "no_aplica",
      "vigente": null,
      "vigencia_nota": null,
      "afectada_por": null,
      "relevancia": 0.9336793,
      "procedencia": {
        "derivacion": "no_aplica",
        "confianza": "sin_dato",
        "limite": null,
        "evidencia": null,
        "verificable_en": "https://www.corteconstitucional.gov.co/relatoria/2008/C-229-08.htm"
      },
      "confirmacion": null
    },
    {
      "fuente": "Sentencia C-417/09",
      "fuente_id": "d327c39c-dd4c-42ae-b65e-303e854dac29",
      "tipo": "sentencia_c",
      "articulo": null,
      "contenido": "DECISIÓN DE PRECLUSIÓN. En firme la sentencia que decreta la preclusión, cesará con efectos de cosa juzgada la persecución penal en contra del imputado por esos hechos. Igualmente, se revocarán todas…",
      "url": "https://www.corteconstitucional.gov.co/relatoria/2009/C-417-09.htm",
      "fecha": "2009-06-26",
      "estado_vigencia": "no_aplica",
      "vigente": null,
      "vigencia_nota": null,
      "afectada_por": null,
      "relevancia": 0.9323611,
      "procedencia": {
        "derivacion": "no_aplica",
        "confianza": "sin_dato",
        "limite": null,
        "evidencia": null,
        "verificable_en": "https://www.corteconstitucional.gov.co/relatoria/2009/C-417-09.htm"
      },
      "confirmacion": null
    }
  ]
}

verificar_cita({"cita":"Decreto 240 de 2026"})

{
  "version": "4",
  "veredicto": "EXISTE_SOLO_CATALOGO",
  "estado_vigencia": "sin_dato",
  "fuente": "DECRETO No. 0240 DEL 12 DE MARZO DE 2026",
  "cita": null,
  "afectada_por": null,
  "url": "https://dapre.presidencia.gov.co/normativa/normativa/DECRETO No. 0240 DEL 12 DE MARZO DE 2026.pdf",
  "procedencia": {
    "derivacion": "catalogo",
    "confianza": "sin_dato",
    "limite": "El corpus no tiene aún el texto de esta norma ni su dato de vigencia.",
    "evidencia": null,
    "verificable_en": "https://dapre.presidencia.gov.co/normativa/normativa/DECRETO No. 0240 DEL 12 DE MARZO DE 2026.pdf"
  },
  "confirmacion": null
}

Contrato de salida (v4)

Cada herramienta devuelve texto legible y, además, structuredContent con el mismo vocabulario. El estado de vigencia usa exactamente estos siete valores; una providencia judicial no tiene vigencia y se marca no_aplica.

estado_vigencia	Significado
vigente	Derecho vigente: no consta derogatoria, inexequibilidad ni modificación.
modificada	Vigente con modificaciones: otra norma o una sentencia afectó parte de su texto; se indica cuál.
derogada	Derogada: una norma posterior la retiró del ordenamiento (total o para el artículo citado).
inexequible	Declarada inexequible por la Corte Constitucional: no produce efectos.
exequible_condicionado	Exequible de forma condicionada: vigente en el entendido que fijó la Corte.
sin_dato	Sin dato de vigencia: no consta derogatoria ni inexequibilidad; verifíquese antes de citar.
no_aplica	No aplica: es una providencia judicial, no una norma — la vigencia no es un atributo suyo.

verificar_cita responde con uno de cuatro veredictos:

EXISTE	La referencia existe en el corpus con texto.
EXISTE_SOLO_CATALOGO	La referencia existe en el catálogo oficial; el corpus no tiene aún su texto ni dato de vigencia.
PENDIENTE_PUBLICACION	Número de ley sancionado o en trámite que la fuente oficial aún no publica; el corpus lo ingiere automáticamente cuando aparezca.
NO_ENCONTRADA	No existe en el corpus. Posible cita inexistente o referencia imprecisa.

Conectar en un clic: claude.ai, Claude Desktop y móvil

Al crear su clave, más abajo, recibirá también un enlace de conector con la forma https://kelsen.io/api/mcp/c/…. En Claude vaya a Ajustes → Conectores → «Añadir conector personalizado», pegue el enlace y listo: verá las cinco herramientas sin configurar nada más.

Los conectores personalizados de Claude están disponibles en los planes de pago de Claude (Pro, Max, Team y Enterprise).
El enlace contiene su clave: trátelo como una contraseña. Si se filtra, revoque la clave y cree otra; el enlace anterior deja de funcionar al instante.
Cada conector consume la cuota de su plan de Kelsen igual que la clave por cabecera.

Conexión

Endpoint: https://kelsen.io/api/mcp. Autenticación por encabezado Authorization: Bearer klsk_live_…. Estado del servicio, versión del contrato y frescura del corpus, sin clave: /api/mcp/health.

Configuración para Claude Desktop o cualquier cliente con mcp.json:

{
  "mcpServers": {
    "kelsen": {
      "type": "http",
      "url": "https://kelsen.io/api/mcp",
      "headers": {
        "Authorization": "Bearer klsk_live_SU_CLAVE"
      }
    }
  }
}

Planes y cuotas

Plan	Llamadas / mes	Ráfaga (solicitudes / min)
Gratis	200	30
Pro	5.000	60
Firma	50.000	120
Enterprise	Ilimitado	240

¿Necesita más capacidad? Vea los planes.

Obtenga su clave

Cree una clave de API y péguela en su cliente MCP. La clave se muestra una sola vez: cópiela y guárdela en un lugar seguro.

Sus claves de API

Cargando…

Nota: la cobertura de fechas de vigencia del corpus es parcial. El Citator marca el estado conocido de cada norma; ante una ausencia de datos, verifique siempre contra la fuente oficial.