Radicado Uno — servidor MCP

Servidor MCP remoto (Model Context Protocol) que da a un agente acceso de solo lectura a los datos mercantiles y de contratación pública de Colombia, cruzados por NIT y con la fuente oficial de cada dato.

Endpoint: https://mcp.radicadouno.co/mcp · Transporte: Streamable HTTP · Autenticación: Authorization: Bearer rduno_…

Este repositorio contiene la documentación y el descriptor del servidor. El servidor es remoto y alojado por nosotros: no hay nada que instalar ni desplegar, y el código de ingesta no es público.

Qué datos sirve

Quince fuentes oficiales colombianas, replicadas y cruzadas por NIT. Las cifras son las verificadas el 2026-08-16:

Se añaden el expediente RUES en vivo por NIT (49 campos, vía Confecámaras), compromisos presupuestales SIIF, órdenes de la Tienda Virtual del Estado, estados financieros de Supersociedades, sanciones en contratación, sanciones de la Superintendencia de Industria y Comercio y las listas restrictivas de la OFAC y la ONU.

Cada registro conserva la URL del documento oficial del que sale y la fecha en que se capturó, de modo que cualquier respuesta puede comprobarse de forma independiente.

Herramientas

Las seis primeras son de solo lectura (readOnlyHint) y devuelven outputSchema; necesitan clave. Las cuatro últimas funcionan sin clave: una responde gratis con tope diario y las otras tres sirven para pagar.

radicadouno_senales_empresa no es un score crediticio. La Ley 1266 de 2008 reserva esa actividad a las centrales de riesgo y no somos una: son hechos con su fuente, sin calificación.

Probarlo sin pagar nada

El saludo del protocolo (initialize, ping, tools/list) responde sin clave, así que cualquier cliente puede conectarse y ver qué hay. Y radicadouno_comprobar devuelve datos reales gratis, con un tope de 10 comprobaciones al día: es el mismo trato que en la web —gratis la respuesta que se ve en pantalla, de pago el documento que sirve para enseñárselo a un tercero—.

Pedir un informe: incluido en el plan, o suelto

Con clave de los planes Pro o Business, radicadouno_informe descuenta de los 20 informes incluidos cada mes: no hay caja ni pago, el informe se emite en unos cuarenta segundos y se recoge con la referencia. Un informe que no se pudo emitir no cuenta.

Sin clave, o agotados los del mes, radicadouno_informe con un NIT devuelve una URL de pago (89.900 COP, sin suscripción) y una referencia. Cuando el pago se confirma, radicadouno_estado_contratacion con esa referencia devuelve el enlace de descarga del PDF y el enlace público donde un tercero puede comprobar su huella. El documento se puede descargar las veces que haga falta.

Cómo conseguir una clave (un agente puede hacerlo solo)

Para las seis herramientas de datos sin tope hace falta el plan Business (619.900 COP al mes, los primeros 7 días gratis: se pide tarjeta y, si se cancela antes, no se cobra nada), y el alta no necesita que intervenga nadie por nuestra parte:

1. El cliente llama a radicadouno_contratar — es una de las dos herramientas que funcionan sin clave. Devuelve una URL de pago de Stripe y una referencia.
2. Se completa el pago en esa URL.
3. El cliente llama a radicadouno_estado_contratacion con la referencia. Mientras el pago no esté confirmado responde pendiente; en cuanto lo está, entrega la clave una sola vez y la borra de nuestro lado.

A partir de ahí la clave viaja en Authorization: Bearer rduno_…. Se entrega una vez y no se puede volver a consultar: a partir de la entrega, en la base solo queda su SHA-256. Si se pierde, escribe a hola@radicadouno.co y se reemite. Una contratación pagada y no recogida caduca a las 72 horas.

También se puede contratar a mano en https://radicadouno.co/precios.

Conectar desde Claude Desktop

El servidor es remoto, así que se conecta con mcp-remote. En claude_desktop_config.json:

{
  "mcpServers": {
    "radicadouno": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.radicadouno.co/mcp",
        "--header",
        "Authorization:Bearer ${RADICADOUNO_CLAVE}"
      ],
      "env": { "RADICADOUNO_CLAVE": "rduno_su_clave" }
    }
  }
}

Conectar con curl

curl -s https://mcp.radicadouno.co/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -H "authorization: Bearer $RADICADOUNO_CLAVE" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Una llamada a una herramienta:

curl -s https://mcp.radicadouno.co/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -H "authorization: Bearer $RADICADOUNO_CLAVE" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":2,
       "params":{"name":"radicadouno_buscar_empresa",
                 "arguments":{"texto":"BANCOLOMBIA","limite":5}}}'

Estado del servicio, sin clave: https://mcp.radicadouno.co/health

Límites y condiciones

• El saludo del protocolo es abierto: initialize, ping y tools/list responden sin clave, para que cualquier cliente pueda ver qué hay aquí antes de contratar. Los datos no: tools/call exige clave salvo en las dos herramientas de contratación.
• 120 peticiones por minuto y por IP, antes de comprobar la clave.
• Un límite por clave además del anterior, según el plan.
• Sin clave válida la respuesta es 401 con el motivo; con un plan que no incluye MCP, 403. Al pasarse de vueltas, 429 con Retry-After.
• Modo sin estado: cada petición es independiente (no hay sesiones).
• Solo lectura: ninguna herramienta escribe nada.
• Uso medido por llamada, para facturación y para saber qué se pregunta.

Lo que este servidor no hace

Dicho por delante, para que nadie se lleve una sorpresa:

• No calcula score ni calificación crediticia (Ley 1266 de 2008).
• Los estados financieros no cubren todas las empresas: dependen de lo que reporta Supersociedades. Si una empresa no reporta, no habrá cifras.
• Las personas naturales comerciantes están excluidas a propósito (Ley 1581 de 2012, habeas data), aunque figuren en el RUES.
• Las sanciones de la Superintendencia de Industria y Comercio no traen NIT en la fuente oficial: solo se enlazan cuando el nombre cruza de forma única contra el registro mercantil. Antes un hueco que un falso positivo.
• Las listas restrictivas (OFAC, ONU) se cruzan solo por NIT exacto declarado por la propia lista, nunca por parecido de nombre. La ONU no publica NIT, así que sus entradas nunca aparecen enlazadas a una empresa.
• El dato hereda los errores de su fuente. Si el SECOP registra mal un valor, aquí aparece igual — con el enlace al expediente oficial para poder comprobarlo.
• No hay acuerdo de nivel de servicio en el plan estándar.

Metodología completa, con la cadencia de actualización de cada fuente: https://radicadouno.co/metodologia

Fuentes

Datos abiertos del Estado colombiano publicados en datos.gov.co bajo licencia CC BY-SA 4.0, más la consulta en vivo al RUES de Confecámaras y las listas OFAC y ONU. El acceso público conforme a la Ley 1712 de 2014.

La licencia MIT de este repositorio cubre su documentación y configuración, no los datos servidos, que conservan la licencia de su fuente.

Radicado Uno — MCP server (English summary)

A remote MCP server giving agents read-only access to Colombian company and public-procurement data, cross-referenced by NIT (the national tax ID), with the official source of every field.

• Endpoint: https://mcp.radicadouno.co/mcp (Streamable HTTP)
• Auth: Authorization: Bearer rduno_… — included in the Business plan (https://radicadouno.co/precios)
• Free to try, no key: the MCP handshake is open, and radicadouno_comprobar returns real data for any NIT — registry identity, public contracting, sanctions and restrictive lists — capped at 10 a day.
• Self-service sign-up, no human in the loop: radicadouno_contratar (no key needed) returns a Stripe checkout URL (7-day free trial) and a reference; after sign-up, radicadouno_estado_contratacion hands over the key once and forgets it. radicadouno_informe does the same for a single signed report (89,900 COP, no subscription), returning a download link instead of a key.
• Health: https://mcp.radicadouno.co/health

Data: 5.9M SECOP II public contracts, 8.5M procurement processes, 9.3M RUES commercial-registry records, 385,225 published company profiles, plus live RUES lookups, Supersociedades financial statements, procurement sanctions, and OFAC/UN restrictive lists. Every record keeps its source URL and capture date.

Tools (ten; the six data tools are read-only and need a key): radicadouno_buscar_empresa (search by name or NIT), radicadouno_perfil_empresa (full profile), radicadouno_contratos_empresa (public contracts with official links), radicadouno_senales_empresa (objective signals — not a credit score), radicadouno_red_empresa (two-hop procurement graph), radicadouno_estado_fuentes (source freshness).

Limits: 120 requests/minute per IP before key validation, plus a per-key limit; stateless; no SLA on the standard plan.

Known gaps, stated up front: no credit scoring (Colombian Law 1266/2008); financial statements only for companies that report to Supersociedades; sole-trader records excluded on privacy grounds (Law 1581/2012); SIC sanctions linked only on a unique exact name match; OFAC/UN lists matched only on exact NIT; data inherits its source's errors.

MIT licensed (docs and configuration). The data keeps its own source licence (CC BY-SA 4.0 for datos.gov.co).