cedula360-mcp

Servidor MCP (Model Context Protocol) de Cédula 360 — verificación de información pública oficial colombiana (ADRES, Rama Judicial, DIAN, RUES, SECOP, sanciones/PEP), Asistente Legal IA, MiniMax, OSINT (huella digital pública), envío de SMS y TerminalForge (orquestación de 14 agentes IA de terminal) — expuesto como 32 herramientas para LLMs y CLIs (Claude Code, OpenCode, Cursor, Cline, Windsurf…), usando tu misma API key c360_live_* (planes Premium+).

Genera tu API key en https://cedula360.tech/#api.

Uso

Remoto (recomendado, sin instalar nada)

Ya está hospedado en https://mcp.cedula360.tech/mcp (Streamable HTTP):

claude mcp add --transport http cedula360 https://mcp.cedula360.tech/mcp \
  --header "X-API-Key: c360_live_TU_KEY"

Local (stdio) — este paquete

# Claude Code
claude mcp add cedula360 -e CEDULA360_API_KEY=c360_live_TU_KEY -- npx -y cedula360-mcp

// Cursor / Cline / Windsurf / Continue (mcp.json)
{
  "mcpServers": {
    "cedula360": {
      "command": "npx",
      "args": ["-y", "cedula360-mcp"],
      "env": { "CEDULA360_API_KEY": "c360_live_TU_KEY" }
    }
  }
}

Variables de entorno

| Variable | Descripción | Default | |---|---|---| | CEDULA360_API_KEY | Tu API key c360_live_* (modo stdio) | — (requerida) | | CEDULA360_API_BASE | Base de la API REST | https://cedula360.tech/api | | TERMINALFORGE_API_BASE | Base de la API de TerminalForge | https://terminalforge.alexanderoviedofadul.dev/api/v1 | | MCP_HTTP | 1 para modo Streamable HTTP remoto | (stdio) | | MCP_PORT | Puerto en modo HTTP | 8133 |

Herramientas

consultar (dossier por CC/NIT/CE/TI/PA/PL/RAD/NOM/TEL/EMAIL/URL/IP), radicado, dian_rut, rues, dominio, telefono, ip, exportar, sanciones, gating, legal_preguntar, legal_buscar, legal_fuente, minimax_buscar, minimax_chat, minimax_imagen, mi_perfil, mi_uso, alertas_listar, alertas_crear, tf_listar_agentes, tf_ejecutar_agente, tf_estado_job, osint_leer, osint_buscar, osint_github_email, osint_youtube_transcribir, enviar_sms, sms_saldo.

enviar_sms es la única herramienta con efectos secundarios y costo (envía un SMS real vía LabsMobile, consume 1 de la cuota mensual + créditos). Requiere plan de pago (personal en adelante). Las demás son de lectura/consulta. sms_saldo reporta los créditos disponibles y no consume cuota.

Las herramientas tf_* orquestan los 14 agentes IA de terminal de TerminalForge (claude, anthropic, zai GLM-5.3, minimax MiniMax-M3, opencode, gemini, codex, deepseek CodeWhale, kimi, vibe, abacusai, mmx, mini-agent, agy) con la misma API key — redacción jurídica, extracción JSON, análisis, con fallback automático y modo sync/async.

El gating por plan se respeta dentro de cada herramienta (Legal=Business+, MiniMax=Enterprise+, TerminalForge=Premium+). Cada salida de IA legal es un borrador para revisión profesional, no asesoría jurídica autónoma.

Caché y frescura

Las consultas a fuentes oficiales usan una caché compartida entre todos los usuarios que no se borra nunca, pero sí envejece. Cada respuesta trae al principio un bloque _cache (se repite al final si la respuesta se trunca):

{
  "_cache": {
    "from_cache": true,
    "scraped_at": "2026-05-21T15:29:17.057Z",
    "cache_age_hours": 2100.16,
    "stale": true,
    "vencido": true,
    "refresh_pendiente": true,
    "aviso": "Estos datos se consultaron en las fuentes oficiales hace 88 días..."
  }
}

• scraped_at es la fecha real de consulta a las fuentes. Es el campo que importa.
• refrescar: true en consultar y radicado fuerza consulta en vivo: tarda 5-90 s y consume 1 de cuota. Úsalo cuando el usuario pida el estado de hoy o cuando el dato venga marcado vencido.
• max_age_horas (solo consultar) marca el dato como desactualizado por encima de N horas, sin forzar la consulta.
• Por encima de 30 días la API sirve la caché al instante y encola un refresco en segundo plano: la siguiente consulta trae datos frescos. Ese refresco no consume tu cuota.
• Los cache hits no consumen cuota; solo la consumen las consultas que llegan a las fuentes.

TTL sugerido por tipo: 7 días para CC/NIT/CE/TI/PA/PL/TEL/EMAIL, 24 h para RAD (las actuaciones judiciales cambian a diario), 30 días para NOM/IP, 3 días para URL.

c360_live_* y c360_test_* comparten datos y caché: el prefijo organiza tus keys, no crea un sandbox.

Ejemplo (en lenguaje natural al LLM)

«Verifica la cédula 91520888 y dime si tiene procesos judiciales o aparece en listas de sanciones.» → el asistente encadena consultar + sanciones.

Documentación: https://cedula360.tech/#mcp

Licencia

MIT