Korea Business Verify (KBV) — Servidor MCP

KBV es un servidor MCP alojado que verifica empresas coreanas en tiempo real — gratis durante la fase piloto. Dale un número de registro de empresa coreano de 10 dígitos (사업자등록번호) y devuelve el estado del registro (activo / suspendido / cerrado), el tipo impositivo y — opcionalmente — si el número coincide con un nombre de representante y una fecha de apertura. Los datos llegan en vivo desde el Korea National Tax Service (NTS) y se devuelven como JSON limpio y normalizado al inglés.

No se requiere cuenta, ni clave de API, ni instalación: conecta cualquier agente compatible con MCP a una única URL:

https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

Pensado para agentes de IA y desarrolladores que hacen KYB / diligencia debida de empresas coreanas: compras, contratación, pagos, incorporación en marketplaces.

Datos rápidos

Related MCP server: korea-invoice-mcp

Conecta tu agente

Claude (claude.ai)

1. Ajustes → Conectores → Añadir conector personalizado

2. URL: https://kbv-server.f7vqt2mlkq.fa.run.app/mcp

3. Habilita el conector en un chat y pregunta: "Comprueba el estado de la empresa coreana 124-81-00998."

Claude Code (CLI)

claude mcp add --transport http kbv https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

ChatGPT

1. Ajustes → Conectores (requiere un plan con soporte para conectores / modo desarrollador)

2. Añade un conector MCP personalizado con la URL https://kbv-server.f7vqt2mlkq.fa.run.app/mcp

3. Actívalo en una conversación y pregunta por un número de empresa coreana.

Cursor

Añade a .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "korea-business-verify": {
      "url": "https://kbv-server-f7vfitmlkq-du.a.run.app/mcp"
    }
  }
}

Cualquier otro cliente MCP

Usa el transporte Streamable HTTP con el endpoint anterior. Los clientes deben enviar Accept: application/json, text/event-stream (los clientes MCP estándar lo hacen automáticamente). Abrir /mcp en un navegador devuelve Method not allowed a propósito: los navegadores envían GET, MCP usa POST. Usa /health para una comprobación visual de que el servicio sigue activo.

Herramientas

check_korean_business_status

Comprueba el estado de registro de una empresa coreana mediante su número de registro de empresa de 10 dígitos.

Entrada — se permiten guiones/espacios; se normaliza internamente:

{ "business_number": "124-81-00998" }

Salida (ejemplo real — Samsung Electronics):

{
  "business_number": "1248100998",
  "status": "active",
  "status_code_raw": "01",
  "tax_type": "general",
  "closed_date": null,
  "checked_at": "2026-08-24T10:08:20.082Z",
  "source": "Korea National Tax Service (NTS)",
  "cache": false
}

Referencia de campos:

• status: active | suspended | closed | not_registered

• tax_type: general | simplified | exempt | non_profit | unknown

• closed_date: fecha ISO ("2023-01-31"), solo para empresas cerradas; en caso contrario, null

• checked_at: marca de tiempo ISO 8601 UTC de la consulta al NTS

• cache: true solo cuando la API del NTS estaba temporalmente no disponible y se sirvió un resultado en caché (como máximo de 24 h); en ese caso, checked_at refleja el momento original de la consulta

Un número bien formado pero no registrado en el NTS devuelve "status": "not_registered" (no es un error).

verify_korean_business

Verifica que un número de registro de empresa coincida con el nombre del representante y la fecha de apertura indicados (comprobación de identidad KYB), y obtén el estado actual en la misma llamada.

Entrada:

{
  "business_number": "124-81-00998",
  "representative_name": "홍길동",
  "opening_date": "1969-01-13",
  "address": "경기도 수원시"
}

• representative_name y opening_date (YYYY-MM-DD) son obligatorios.

• address es opcional y mejora la precisión de la coincidencia.

• Los nombres y las direcciones deben indicarse tal y como están registrados en el NTS (en caracteres tailandeses).

Salida — mismo esquema que el anterior más identity_match:

{
  "business_number": "1248100998",
  "status": "active",
  "status_code_raw": "01",
  "tax_type": "general",
  "closed_date": null,
  "checked_at": "2026-08-24T10:08:23.483Z",
  "source": "Korea National Tax Service (NTS)",
  "cache": false,
  "identity_match": false
}

identity_match es true solo cuando el NTS confirma que el número, el nombre del representante y la fecha de apertura coinciden todos con sus registros.

Errores

Los errores se devuelven como errores de las herramientas MCP con un cuerpo JSON legible por máquina:

Fuente de datos y licencia

• Todos los datos provienen del Korea National Tax Service (국세청) a través de la API oficial de datos abiertos del Gobierno coreano (data.go.kr: 사업자등록정보 진위확인 및 estado de consulta de serial), consultados en directo en cada solicitud — KBV no almacena ninguna base de datos de empresas.

• El conjunto de datos subyacente se publica bajo la política de datos abiertos del Gobierno coreano con sin restricciones de uso (이용허락범위: 제한 없음), por lo que las respuestas pueden usarse comercialmente y citarse libremente.

• KBV normaliza las respuestas del NTS en coreano y basadas en códigos al esquema JSON estable y normalizado al inglés documentado aquí; los datos NTS brutos nunca se muestran.

• Frescura: las consultas se realizan directamente en el registro del NTS. Las empresas de nueva creación pueden tardar entre 1 y 2 días hábiles en aparecer en el propio NTS.

Privacidad

• El contenido de las consultas nunca se registra. Los números de empresa, los nombres de los representantes y las direcciones no aparecen en ningún registro del servidor y no se envían a ninguna parte excepto a la API oficial del NTS que responde a la consulta.

• Los registros del servidor contienen solo recuentos de solicitudes, resultados y métricas de latencia.

• Existe una caché en memoria de corto plazo (máx. 24 h, claves con hash) únicamente para que el servicio pueda responder durante cortes del NTS; nunca se comparte ni se exporta.

Precios

• Actualmente gratis mientras KBV esté en la fase piloto. No se cuenta, ni cuenta final ni clave.

• El pago por llamada (en el rango de ~$0.02–$0.05 por llamada, pagadero por el agente a través de x402) está previsto para una fase posterior; el nivel gratuito para uso ligero se dejará de mantener.

• Uso razonable: la cuota del NTS es compartida. El tráfico automatizado intensivo puede ser limitado antes de que se lancen los niveles de pago.

Preguntas frecuentes

¿Qué es un número de registro mercantil coreano? Un identificador de 10 dígitos (사업자등록번호, normalmente escrito 123-45-67890) que emite el Korea National Tax Service a toda empresa registrada en Corea del Sur.

¿Puedo comprobar si una empresa coreana sigue operativa? Sí — llama al comando check_korean_business_status; "status": "active" significa que la empresa está actualmente registrada y operativa, y "closed" incluye la fecha de cierre.

¿Puedo verificar la identidad de una empresa coreana antes de una transacción (KYB)? Sí — llama a verify_korean_business con el número, el nombre del representante y la fecha de apertura; identity_match: true significa que el NTS confirma el triple coincidencia.

¿Necesito una clave de API? No. Conéctate a la URL de MCP y utiliza todas las herramientas.

Autoalojamiento / desarrollo

El servidor está abierto para el desarrollo local (Node.js ≥ 22, TypeScript, Express + kit oficial MCP):

cp .env.example .env       # put your own data.go.kr DECODING key in NTS_SERVICE_KEY
npm install
npm run dev                # → http://localhost:8080  (MCP at /mcp)
npm test                   # vitest, upstream fully mocked — no network

Guía de despliegue (Google Cloud Run): consulta DEPLOY.md. Arquitectura y especificación de diseño: DESIGN.md.