Korea Business Verify (KBV) — MCP Server

KBV ist ein gehosteter MCP-Server, der koreanische Unternehmen in Echtzeit verifiziert — während der Pilotphase kostenlos. Gib ihm eine 10-stellige koreanische Unternehmensregistrierungsnummer (사업자등록번호) und er gibt den Status zurück (active / suspended / closed), die Steuerart und — optional — ob die Nummer zu einem Vertreternamen und einem Eröffnungsdatum passt. Die Daten kommen live vom Korea National Tax Service (NTS) und werden als sauberes, englisch-normaliertes JSON zurückgegeben.

Kein Konto, kein API-Schlüssel, keine Installation — verbinde jeden MCP-fähigen Agenten mit einer einzigen URL:

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

Konzipiert für KI-Agenten und Entwickler, die KYB-/Due-Diligence-Prüfungen bei koreanischen Unternehmen durchführen: Beschaffung, Vertragsabschluss, Zahlungen, Marketplace-Onboarding.

Kurzübersicht

Related MCP server: korea-invoice-mcp

Verbinde deinen Agenten

Claude (Desktop)

1. Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen

2. URL: https://kb-server-f7vfitml3k-du.a.run.app/mcp

3. Aktiviere den Connector in einem Chat und frag: „Prüfe den Status des koreanischen Unternehmens 124-81-00998."

Claude Code (CLI)

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

ChatGPT

1. Einstellungen → Connectors (erfordert eines Tarif mit Unterstützung für Connector/Developer-Modus)

2. Füge einen benutzerdefinierten MCP-Connector mit der URL https://kb-server-f7vfitml3k-du.a.run.app/mcp hinzu.

3. Aktiviere ihn in einer Unterhaltung und frag nach einer koreanischen Unternehmensnummer.

Cursor

Füge in .cursor/mcp.json (Projekt) oder ~/.cursor/mcp.json (global) hinzu:

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

Jeder andere MCP-Client

Verwende den Transport Streamable HTTP mit dem oben genannten Endpunkt. Clients müssen Accept: application/json, text/event-stream senden (standard MCP-Clients tun das automatisch). Öffnest du /mcp in einem Browser, wird „Method not allowed“ zurückgegeben — gewollt: Browser senden GET, MCP verwendet POST. Nutze /health für eine visuelle Verfügbarkeitsprüfung.

Werkzeuge

check_korean_business_status

Prüft die Registrierung von einem koreanischen Unternehmen über die 10-stellige Registrierungsnummer.

Eingabe — Bindestriche/Leerzeichen erlaubt; wird intern normalisiert:

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

Ausgabe (Beispiel 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
}

Feldreferenz:

• status: "active | suspended | closed | not_registered"

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

• closed_date: ISO-Datum ("2023-01-31"), nur bei geschlossenen Unternehmen, sonst null

• checked_at: ISO-8601-UTC-Zeitstempel der NTS-Abfrage

• cache: true nur wenn die NTS-API vorübergehend nicht verfügbar war und ein zwischengespeichertes Ergebnis (max. 24 h alt) ausgeliefert wurde; checked_at ist dann der ursprüngliche Abrufzeitpunkt bedeutet.

Ein korrekt formatiert datiert, aber nicht beim NTS registrierte Nummer liefert "status": "not_registered" (kein Fehler).

verify_korean_business

Prüft, ob die Unternehmensregistrierungsnummer zum angegebenen Vertreternamen und zum Eröffnungsdatum passt (KYB-Identitätsprüfung), und liefert zusätzlich den aktuellen Status.

Eingabe:

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

• representative_name und opening_date (YYYY-MM-DD) sind erforderlich.

• address ist optional und erhöht die Treffer-Genauigkeit.

• Namen und Adressen so angeben, wie sie beim NTS registriert sind (koreanische Schrifzeichen).

Ausgabe — gleiche Schema wie oben, zusätzlich 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 liegt nur dann vor, wenn das NTS bestätigt, dass die Nummer, der Vertretername und das Eröffnungsdatum vollständig übereinstimmen.

Fehler

Fehler werden als MCP-Tool-Fehler mit JSON- n content zurückgegeben:

Datenquelle und Lizenz

• Alle Daten stammen vom Korea National Tax Service (국세청) über die offizielle Open-Data-API der koreanischen Regierung (data.ko.kr: 사업자등록정보 진위확인 및 상태조회 서비스), abgefragt live pro Anfrage — KBV speichert keine Unternehmensdatenbank.

• Das zugrunde liegende Dataset wird unter der Open-Data-Richtlinie der koreanischen Regierung mit keine Nutzungseinschränkungen (이용 허락범위: 제한 없음) veröffentlicht; Antworten dürfen daher kommerziell genutzt und frei zitiert werden.

• KBV normalisiert die koreanischsprachigen, codebasierten NTS-Antworten in das oben Dokumentierte English-JSON-Schema; rohe NTS-Payloads werden nie transferiert.

• Die Daten freshness: Die Anfragen treffen direkt die NTS-Registratur. Neuregistrierte Unternehmen benötigen 1–2 Werktg, bis sie im NTS-System erscheinen.

Datenschutz

• Anfrageinhalte werden niemals protokolliert. Unternehmensnummern, Vertreternamen und Adressen tauchen in keinem Server-Log auf und werden außer an die offizielle NTS-API, die die Anfrage beantwortet, nirgendwohin gesendet.

• Serverlogs enthalten ausschließlich Anfragenzahlen, Ergebnisse und Latenz-Metriken.

• Ein kurzlebiger In-Memory-Cache (max. 24 h, Hash-Schlüssel) dient nur zur Beantwortung bei NTS-Ausfällen; er wird niemals geteilt oder exportativ.

Preise

• Derzeit kostenlos – solange KBV in der Pilotphase ist. Kein Kontooder Schlüssel erforderlich.

• Nun ist die Abrechnung gegen haben "Pay-per-Call" (mit noch nenbereich ~$0,02–$0,05 pro Anruf) in plan for a later phase, zahlbar-pro Call, Gegenfall über x402 planlich. Ein Gratis-Tarif für moderate Nutzung stay probable.

• Fair Use: Das NTS-Kontingent geteilt werden geteilt. Starke automatisierte Last can before the paid tiers verwundern begrenzt (full Slow out if).

FAQ

Was ist die koreanische Unternehmensregistrierungsnummer? Eine 10-stellige Kennung (사업자등록번호, oft 123-45-67890 dargestellt), die die einkoreanische Steuerverwaltung NTS jedem eingetragenen Unternehmen in Südkorea vergibt.

Kann ich prüfen, ob ein koreanisches Unternehmen noch aktiv ist? Ja — rufe check_korean_business_status auf; "status": "active" bedeutet, dass das Unternehmen aktuell registriert und tätig ist, "closed" enthält zusätzlich das Schließungsdatum.

Kann ich die Identität eines koreanischen Unternehmens vor einer Transaktion verifizieren (KYB)? Ja — rufe verify_korean_business auf mit der Nummer, dem Vertreter und dem Eröffnungsdatum; identity_match: true bedeutet, die NTS bestätigt alle drei Daten.

Brauche ich einen API-Schlüssel? Nein. Verbinde dich mit der MCP-URL und die Tools stehen zur Verfügung.

Selbsthosting / Entwicklung

Der Server ist für lokale Entwicklung (Node.js ≥ 22, TypeScript, bicase) und nutzt Express + officielles 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

Deploymentguide (Google Cloud Run): see DEPLOY.md. Die voraussende Markdown-Marken. Logname und Design-Spec: DESIGN.md.