API y MCP de RuleX

Autenticación

El servidor MCP responde sin credencial con las herramientas públicas (buscar_licitaciones_secop, liquidar_intereses_cgp) y un límite por minuto y por IP. Con API Key sirve el catálogo completo de Rulex Data. La clave se obtiene con tu sesión en el panel, sección API / MCP.

Authorization: Bearer rx_data_live_TU_API_KEY
X-API-Key: rx_data_live_TU_API_KEY
POST /api/mcp?apiKey=rx_data_live_TU_API_KEY

Regenerar la clave en el panel revoca la anterior de inmediato: las peticiones con la clave vieja pasan a devolver 401. El endpoint /api/chat no es parte de esta API: pertenece a la aplicación web y usa la sesión de RuleX, no un Bearer token.

Cuotas y límites

• El día se corta a medianoche hora de Colombia (America/Bogota).
• Cada respuesta trae X-RateLimit-Limit, X-RateLimit-Remaining y X-RuleX-Plan.
• Una petición malformada no consume cuota: primero se valida y después se cobra.
• El cuerpo máximo por petición es de 200 KB.

Conectar tu cliente

Reemplaza rx_data_live_TU_API_KEY por tu clave. En el panel estos mismos bloques aparecen con la clave ya inyectada.

{
  "mcpServers": {
    "rulex-data": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://rulex.org/api/mcp",
        "--header",
        "Authorization: Bearer rx_data_live_TU_API_KEY"
      ]
    }
  }
}

Catálogo de herramientas

Todas son de solo lectura ( readOnlyHint: true ) y declaran inputSchema y outputSchema, así que tu cliente puede validar la respuesta antes de dársela al modelo.

* obligatorio. Alias históricos conservados por compatibilidad: buscar_licitaciones_secop, liquidar_intereses_cgp.

Llamar por MCP

Streamable HTTP stateless: implementa initialize, ping, tools/list y tools/call. No hay sesión que mantener ni stream SSE, y GET /api/mcp responde 405 a propósito.

curl -X POST "https://rulex.org/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer rx_data_live_TU_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "rulex_rag_juridico",
      "arguments": {"query":"estabilidad laboral reforzada fuero de salud","limit":3}
    }
  }'

La respuesta trae el resultado dos veces: como texto en result.content[0].text y ya estructurado en result.structuredContent. Un fallo de ejecución llega como result.isError: true, no como error JSON-RPC: así el modelo distingue "el RAG falló" de "no hay jurisprudencia".

Llamar por REST

El mismo catálogo en una llamada plana, para lenguajes o automatizaciones (n8n, Make, scripts) que no hablan JSON-RPC. Devuelve { ok, tool, data, usage }, donde data es idéntico al structuredContent de MCP.

curl -X POST "https://rulex.org/api/data/query" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer rx_data_live_TU_API_KEY" \
  -d '{
    "tool": "rulex_secop_contratos",
    "args": {"query":"suministro de medicamentos","tipo":"ambos","limit":5}
  }'

Códigos de error

Consulta SECOP I y II

Búsqueda pública de contratación estatal, sin credencial. Parámetros: query, type (secop1 o secop2; si se omite consulta ambas), mode (abiertos por defecto o historico) y limit.

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

Liquidación de intereses

Liquidación de referencia con el IBC certificado por la Superintendencia Financiera. Requiere capital, fecha_inicio, fecha_corte y tipo_interes (moratorio o corriente); tipo_proceso es opcional. La respuesta trae sus propias advertencias de alcance: el tope de 1,5× IBC es una referencia cuando corresponde, no una regla universal.

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"
  }'

Estado del sistema

Endpoint público y sin autenticación para verificar operatividad, latencia y conexión con los servicios externos de RuleX.

Alcance y límites

Las fuentes son colombianas: SECOP I y II, RUES, Rama Judicial, Superfinanciera, Supersociedades, INVIMA y el corpus jurídico de las altas cortes. Otros países todavía no están habilitados en este servidor.

Los extractos jurisprudenciales son material de consulta con enlace a la fuente oficial: verifica la providencia completa antes de citarla en estrados. Ninguna herramienta reemplaza el criterio, la firma ni la responsabilidad profesional.