MCPPlan Ilimitado

Servidor MCP

Conecta Consultas Non Stop a Claude, Cursor o cualquier cliente compatible con el Model Context Protocol. El asistente consulta el buró, resuelve el NIP y entrega el reporte sin salir del chat, con las mismas reglas de saldo, certificación y consentimiento que la API.

Qué es

El servidor MCP expone las operaciones de Consultas Non Stop como herramientas que tu asistente puede llamar: consultar el saldo, iniciar una consulta de crédito, resolver el NIP del consultado, descargar el reporte y comprar paquetes. El transporte es HTTP (Streamable) sobre JSON-RPC 2.0.

El flujo del NIP se resuelve dentro del chat: el asistente le muestra al operador la liga de términos y condiciones y las leyendas legales, y el operador captura el código que recibió el consultado. No hace falta escribir código.

Requiere plan Ilimitado

El servidor MCP está incluido únicamente en el plan Ilimitado. Con cualquier otro plan responde 403 mcp_no_disponible. Compara los planes en Precios.

Endpoint

POSThttps://sandbox.dashboard.consultasnonstop.com/mcp

Un solo endpoint atiende todo el protocolo. Acepta dos formas de autenticarse, según cómo lo conectes:

AuthParaCómo
OAuth 2.1Claude en claude.ai (Conector personalizado)Inicias sesión con tu cuenta y autorizas el conector. No necesitas API key.
x-api-keyClaude Code, Claude Desktop, CursorMandas tu API key en el header, igual que en la API REST.

Entornos

Aplica el mismo criterio que la API REST: el entorno de la key debe coincidir con el host. Una key de sandbox solo funciona contra el host con prefijo sandbox.

EntornoURL del servidor MCP
SANDBOXhttps://sandbox.dashboard.consultasnonstop.com/mcp
PRODUCCIÓNhttps://dashboard.consultasnonstop.com/mcp

listar_consultas es la excepción: lista las consultas de los dos entornos, para que el asistente vea el histórico completo de la cuenta.

Claude (claude.ai)

En claude.ai entra a Conectores → Agregar conector personalizado, pega la URL del servidor MCP y deja vacíos los campos de OAuth. Se abrirá una pantalla para iniciar sesión con tu cuenta de Consultas Non Stop y autorizar el conector. Aquí no necesitas API key.

url
https://dashboard.consultasnonstop.com/mcp

El conector OAuth corre en sandbox

Por seguridad, las consultas hechas a través del conector personalizado de claude.ai corren siempre en modo sandbox: nunca llegan al buró real ni consumen saldo. Para consultar con datos reales, conecta el servidor con una API key certificada de producción.

Claude Code

Registra el servidor desde la terminal con tu API key. Sustituye TU_API_KEY por una key de API y MCP en el dashboard.

bash
claude mcp add --transport http consultas-non-stop \
  https://sandbox.dashboard.consultasnonstop.com/mcp \
  --header "x-api-key: TU_API_KEY"

Claude Desktop / Cursor

Agrega el servidor al bloque mcpServers de la configuración de tu cliente y reinícialo para que lo cargue.

json
{
  "mcpServers": {
    "consultas-non-stop": {
      "type": "http",
      "url": "https://sandbox.dashboard.consultasnonstop.com/mcp",
      "headers": { "x-api-key": "TU_API_KEY" }
    }
  }
}

Tip

Si usas una key de sandbox, la URL debe llevar el prefijo sandbox. en el host. Con una key de producción, usa el host sin prefijo. Si no coinciden, el servidor responde 401.

Herramientas

HerramientaArgumentosQué hace
consultar_saldo—Devuelve el saldo de consultas disponible por tipo de reporte (ordinario y especial).
listar_consultas—Lista las consultas de la cuenta con su id, tipo, estado y fecha. Incluye los dos entornos: producción y sandbox.
campos_sujetotipo, canalDevuelve qué datos del consultado se requieren según el tipo y el canal, para saber qué pedirle al operador antes de iniciar la consulta.
consultar_reportetipo, canal, sujetoInicia la consulta de crédito. Devuelve el id, la fase del NIP, la leyenda de aceptación y la URL de términos y condiciones que hay que mostrarle al operador.
enviar_nipconsulta_idEnvía el NIP al consultado por SMS, correo o WhatsApp. Se llama solo después de que el operador confirma que el consultado aceptó.
validar_nipconsulta_id, nipValida el código que dio el consultado. Se llama dos veces con el mismo NIP; la segunda devuelve la leyenda de autorización y cierra la consulta con el reporte_id.
obtener_reporteconsulta_idDevuelve una liga temporal de 30 minutos para descargar el PDF del reporte de una consulta COMPLETADA.
comprar_paquetetipo, cantidadCompra un paquete de consultas adicionales para recargar el saldo de la cuenta.

tipo es ORDINARIO o ESPECIAL; canal es SMS, EMAIL o WHATSAPP. El asistente pregunta el canal en vez de asumirlo: es el medio por el que el consultado recibe el NIP.

Respuestas de ejemplo

JSON
ok
{ "ordinario": 12, "especial": 3 }

Flujo de una consulta

Así se ve una consulta completa resuelta desde el chat, de principio a fin:

1Pregunta qué datos hace falta capturar — campos_sujeto devuelve la lista exacta de campos según el tipo de reporte y el canal, para que el asistente le pida al operador solo lo necesario.
2Inicia la consulta — consultar_reporte con el tipo, el canal y los datos del consultado. Devuelve la liga de términos y condiciones y la leyenda de aceptación que el asistente le presenta al operador.
3El consultado acepta — El operador confirma en el chat que el consultado acepta los términos, el uso del NIP y la creación de su cuenta. Sin esa confirmación no se envía el NIP.
4Envía el NIP — enviar_nip con el consulta_id. El consultado lo recibe por el canal elegido.
5Captura el NIP — validar_nip con el código. La fase pasa a VALIDATE_2 y la respuesta trae la leyenda de autorización del buró que hay que mostrarle al operador.
6Confirma el mismo NIP — validar_nip otra vez con el mismo código. Esta llamada cierra la consulta y devuelve el reporte_id.
7Entrega el reporte — obtener_reporte devuelve una liga temporal de 30 minutos para descargar el PDF. Si expira, se vuelve a pedir.

Un solo NIP, dos capturas

El buró pide el mismo código dos veces: una para ingresarlo y otra para confirmarlo. No es un segundo código distinto, así que el asistente no debe pedirle al operador un NIP nuevo en la segunda vuelta.

Consentimiento del consultado

El consultado tiene que autorizar la consulta de su historial crediticio, y el MCP lleva esa autorización al chat en dos momentos:

CuándoQué devuelve
consultar_reporteterminos_url con la liga de términos y condiciones y leyenda_aceptacion con el texto que el consultado debe aceptar: términos y condiciones, uso del NIP como medio electrónico de autenticación y creación de su cuenta.
validar_nip (2.ª)autorizacion con el título y la leyenda legal del buró, que varía según el tipo de reporte: Reporte de Crédito Especial para ESPECIAL y Buró de Crédito para ORDINARIO.

El asistente le presenta ambos textos al operador y solo continúa si el operador confirma que el consultado los aceptó.

Errores

Cuando una herramienta falla, la respuesta llega marcada como error con un mensaje que el asistente le muestra al operador. Los casos más comunes:

SituaciónQué pasa
El plan no incluye MCPEl endpoint responde 403 mcp_no_disponible antes de ejecutar cualquier herramienta.
NIP incorrecto o expiradovalidar_nip devuelve error y pide el código vigente para reintentar.
El reporte no está listoobtener_reporte exige que la consulta esté COMPLETADA.
Reporte fuera de la ventana del planobtener_reporte no entrega la liga: Acceso 7 días, Equipo 30, Ilimitado sin límite.
Cuenta con pago pendientecomprar_paquete se bloquea hasta regularizar el método de pago.
Paquete inexistentecomprar_paquete rechaza combinaciones de tipo y cantidad fuera del catálogo vigente.

Plan sin MCP

JSON
403 Forbidden
{
  "error": {
    "type": "mcp_no_disponible",
    "message": "Tu plan no incluye MCP (solo Ilimitado)."
  }
}
Crea tu cuenta →