Korea Business Verify (KBV) — MCP Server

KBV — это размещённый MCP-сервер, который проверяет корейские компании в реальном времени — бесплатно на время пилотного этапа. Передайте ему 10-значный номер регистрации корейского бизнеса (사업자등록번호), и он вернёт статус регистрации (active / suspended / closed), тип налогообложения и — опционально — совпадает ли номер с именем представителя и датой регистрации. Данные поступают в реальном времени из Национальной налоговой службы Кореи (NTS) и возвращаются в виде чистого JSON, нормализованного на английский язык.

Без аккаунта, без API-ключа, без установки — подключите любого MCP-совместимого агента к одному URL:

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

Создан для ИИ-агентов и разработчиков, которые проводят KYB / due-diligence корейских компаний: закупки, заключение контрактов, платежи, онбординг на маркетплейсах.

Краткие факты

Related MCP server: korea-invoice-mcp

Подключение вашего агента

Claude (claude.ai)

1. Settings → Connectors → Add custom connector

2. URL: https://kbv-server-f7vfiudlq-duk.a.run.app/mcp

3. Включите коннектор в чате и спросите: «Проверьте статус корейской компании 124-81-00998.»

Claude Code (CLI)

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

ChatGPT

1. Settings → Connectors (требуется тариф с поддержкой коннекторов / демо-режима)

2. Добавьте собственный MCP-коннектор, указав URL https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

3. Включите его в разговоре и задайте вопрос о номере корейской компании.

Cursor

Добавьте настройку в .cursor/mcp.json (для проекта) или ~/.cursor/mcp.json (глобально):

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

Любой другой MCP-клиент

Используйте транспорт Streamable HTTP с указанной выше конечной точкой (engine). Клиенты должны отправлять заголовок Accept: application/json, text/event-stream (стандартные MCP-клиенты делают это автоматически). Открытие /mcp в браузере намеренно возвращает Method not allowed — браузеры отправляют GET, а MCP использует POST. Для наглядной проверки доступности используйте /health.

Инструменты

check_korean_business_status

Проверяет статус регистрации корейской компании по её 10-значному номеру регистрации бизнеса.

Входные данные — дефисы и пробелы допустимы; внутри они нормализуются:

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

Результат (реальный пример — 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
}

Справочник полей:

• status: active | suspended | closed | not_registered

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

• closed_date: дата в формате ISO ("2023-01-31"), только для закрытых компаний, иначе null

• checked_at: отметка времени запроса к NTS в формате ISO 8601 UTC

• cache: равно true только в том случае, если NTS API временно был недоступен и был выдан результат из кэша (не старше 24 часов); в этом случае checked_at отражает время исходного запроса

Корректно сформированный, но не зарегистрированный в NTS номер возвращает "status": "not_registered" (а не ошибку).

verify_korean_business

Проверяет, что номер регистрации бизнеса совпадает с указанными именем представителя и датой открытия (идентификация в рамках KYB), и одновременно возвращает текущий статус.

Входные данные:

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

• representative_name и opening_date (YYYY-MM-DD) обязательны.

• address необязательно и повышает точность совпадения.

• Имена и адреса должны быть указаны так, как они зарегистрированы в NTS (корейским письмом).

Результат — та же схема, что и выше, плюс 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 равно true только в том случае, если NTS подтверждает, что номер, имя представителя и дата opening_date соответствуют её записям.

Ошибки

Ошибки возвращаются как ошибки инструментов MCP с машиночитаемым телом в формате JSON:

Источник данных и лицензия

• Все данные поступают из Национальной налоговой службы Кореи (국세청) через официальный API открытых данных правительства Кореи (data.go.kr: 사업자등록정보 진위확인 및 상태조회 서비스), и запрос выполняется в реальном времени при каждом обращении — KBV не хранит базу данных о компаниях.

• Исходный набор данных опубликован по политике открытых данных правительства Кореи с отсутствием ограничений на использование (이용허락범위: 제한 없음), поэтому ответы можно свободно использовать в коммерческих целях и цитировать.

• KBV нормализует корейскоязычные, кодовые ответы NTS в стабильную англоязычную JSON-схему, описанную выше; сырые (raw) данные NTS никогда не передаются без обработки.

• Актуальность: запросы обращаются к реестру NTS напрямую. Новые зарегистрированные компании могут появиться в самой системе NTS через 1–2 рабочих дня.

Конфиденциальность

• Содержимое запросов никогда не записывается в журналы. Номера регистрации, имена представителей и адреса не появляются ни в одном журнале сервера и не отправляются никуда, кроме официального API NTS, который отвечает на запрос.

• Серверные журналы содержат только количество запросов, результаты и метрики задержки.

• Недолговременный кэш в оперативной памяти (до 24 часа, с хешированными ключами) существует только для того, чтобы сервис мог отвечать во время сбоев NTS; он никогда не открывается и не экспортируется.

Тарифы

• Сейчас бесплатно, пока KBV находится на пилотном этапе. Никакой аккаунт и ключ не требуется.

• По-вызовная оплата (примерно $0,02–$0,05 за вызов, с оплатой через x402) запланирована на более поздний этап; при этом бесплатный тариф для низкой нагрузки, как ожидается, сохранится.

• Разумное использование: квота API NTS — общая. Интенсивный автоматизированный трафик может быть ограничен по частоте до запуска платных тарифов.

Вопросы и ответы

Что такое номер регистрации корейского бизнеса? Это 10-значный идентификатор (사업자등록번호, часто записывается как 123-45-67890), который Национальная налоговая служба Кореи выдаёт всем зарегистрированным предприятиям в Республике Корея.

Можно ли проверить, действует ли компания до сих пор? Да — вызовите check_korean_business_status; "status": "active" означает, что компания в настоящее время зарегистрирована и работает, а "status": "closed" включает дату закрытия.

Можно ли проверить идентичность корейской компании перед сделкой (KYB)? Да — вызовите verify_korean_business с номером, именем представителя и датой открытия; identity_match: true означает, что все три параметра, по данным NTS, совпадают.

Нужен ли API-ключ? Нет. Подключитесь к MCP URL и вызывайте инструменты.

Собственный хостинг / разработка

Сервер открыт для локальной разработки (Node.js ≥ 22, TypeScript, Express + официальный MCP SDK):

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

Руководство по развёртыванию (Google Cloud Run): см. DEPLOY.md. Проектирование и дизайн-спецификация: DESIGN.md.