API de RuleX

Documentación oficial de las interfaces públicas de RuleX: datos de SECOP, cálculo de intereses, estado del sistema y un servidor MCP de solo lectura para agentes.

Acceso y límites

SECOP, liquidación de intereses, estado y MCP son públicos. Las invocaciones MCP tienen rate limiting. El endpoint /api/chat pertenece a la aplicación web autenticada: usa la sesión de RuleX y no es una API pública con Bearer token.

Descubrimiento de contratos

OpenAPI: https://rulex.org/api/openapi.json
MCP: https://rulex.org/api/mcp

POST/api/mcp

MCP público para agentes

Endpoint Streamable HTTP compatible con MCP 2025-06-18. Expone dos herramientas de solo lectura: búsqueda de licitaciones SECOP y liquidación de intereses de referencia.

Métodos JSON-RPC

initialize, ping, tools/list y tools/call.

Ejemplo de Código

curl -X POST https://rulex.org/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

GET/api/secop

Consulta SECOP I y II

Realiza consultas a las bases de datos de contratación pública del Estado Colombiano (SECOP I y SECOP II) mediante palabras clave, devolviendo contratos y licitaciones coincidentes.

Parámetros Query

query (string, requerido): Texto de búsqueda.
type (string, requerido): secop1 o secop2.

Ejemplo de Código

curl -X GET "https://rulex.org/api/secop?query=asesoria+juridica&type=secop2"

POST/api/liquidar-intereses

Liquidación de Intereses (CGP)

Liquida intereses civiles, comerciales o de mora sobre un capital determinado entre dos fechas dadas. Se alimenta directamente de las tasas oficiales publicadas por la Superintendencia Financiera de Colombia.

Parámetros del Body

capital (number, requerido): Monto principal.
fecha_inicio (string, requerido): Formato YYYY-MM-DD.
fecha_corte (string, requerido): Formato YYYY-MM-DD.
tipo_proceso (string, requerido): Tipo de proceso legal.
tipo_interes (string, requerido): moratorio o corriente. Usa sólo el alcance y las advertencias que devuelve la respuesta.

Ejemplo de Código

curl -X POST https://rulex.org/api/liquidar-intereses \
  -H "Content-Type: application/json" \
  -d '{
    "capital": 10000000,
    "fecha_inicio": "2026-01-01",
    "fecha_corte": "2026-01-31",
    "tipo_proceso": "singular",
    "tipo_interes": "moratorio"
  }'

GET/api/status

Estado del Sistema

Un endpoint público y sin autenticación para verificar la operatividad y salud del sistema de RuleX, así como la latencia y la conexión con sus servicios externos.