Korea Business Verify (KBV) — MCP 서버

KBV는 한국 사업자를 실시간으로 검증하는 호스팅형 MCP 서버로, 파일럿 기간 동안 무료입니다. 사업자등록번호(10자리)를 입력하면 등록 상태(active / suspended / closed), 과세 유형, 그리고 선택적으로 해당 번호가 대표자 이름 및 개업일과 일치하는지 여부를 반환합니다. 데이터는 국세청(Korea National Tax Service, NTS)에서 실시간으로 제공받으며, 영어로 정규화된 깔끔한 JSON으로 반환됩니다.

계정도, API 키도, 설치도 필요 없습니다 — MCP를 지원하는 모든 에이전트를 하나의 URL에 연결하세요:

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

한국 기업에 대한 KYB / 실사(due diligence)를 수행하는 AI 에이전트와 개발자를 위해 제작되었습니다: 조달, 계약, 결제, 마켓플레이스 온보딩.

빠른 정보

Related MCP server: korea-invoice-mcp

에이전트 연결

Claude (claude.ai)

1. 설정 → 커넥터 → 사용자 지정 커넥터 추가

2. URL: https://kbv-server-f7vfitmlkq-fab.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. 설정 → 커넥터 (커넥터 / 개발자 모드 지원 플랜 필요)

2. URL https://kbv-server-f7vfitmlkq-fab.a.run.app/mcp로 사용자 지정 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 전송을 사용하세요. 클라이언트는 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: NTS API가 일시적으로 사용 불가하여 캐시된(최대 24시간 이전) 결과를 제공한 경우에만 true이며, 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는 NTS가 해당 번호와 대표자 이름, 개업일이 모두 자체 기록과 일치함을 확인한 경우에만 true입니다.

오류

오류는 기계가 읽을 수 있는 JSON 본문을 포함한 MCP 도구 오류로 반환됩니다:

데이터 소스 및 라이선스

• 모든 데이터는 국세청 전산시스템(NTS) 에서 공식 정부 오픈데이터 API(data.go.kr: 사업자등록정보 진위확인 및 상태조회 서비스)를 통해 제공되며 요청마다 실시간 조회됩니다 — KBV는 자체 사업자 데이터베이스를 보관하지 않습니다.

• 해당 기본 데이터는 한국 정부의 공공데이터 정책에 따라 이용 제한 없음(이용허락범위: 제한 없음) L2. 라이선스로 배포되므로 응답 내용을 상업적으로 자유롭게 이용·인용할 수 있습니다.

• KBV는 한국어·코드로 된 NTS 응답을 위에 문서화된 안정적인 영어 JSON 스키마로 정규화하며, 원본 NTS 데이터는 절대로 그대로 전달하지 않습니다.

• 신선도: 쿼리는 NTS와 직접 연결하여 즉시 응답을 받습니다. 다만 신규 등록 사업자으니 NTS 시스템에 반영될 때까지 영업일 기준 1~2일이 소요될 수 있습니다.

개인정보 보호

• 쿼리 내용은 절대 로깅되지 않습니다. 사업자등록번호, 대표자명, 주소는 어느 서버 로그에도 남지 않으며, 쿼리에 응답하는 공식 국세청 API 이외의 곳으로는 전송되지 않습니다.

• 서버 로그에는 요청 수, 처리 결과, 지연 시간 메트릭만 기록됩니다.

• 일시적인 인메모리 캐시(최대 24시간, 키는 해시 처리)는 NTS 장애 중에도 서비스가 응답할 수 있도록 하기 위해서만 존재하며, 공유되거나 외부로 반출되지 않습니다.

요금

• 현재 무료입니다(KBV가 파일럿 단계 동안에는 계정이나 키가 필요 없음).

• 이후 단계에서는 호출당 과금(약 \~$0.02–$0.05 범위, 에이전트가 x402로 결제 가능)모나 계획되어 있으며, 가벼운 사용에 대한 무료 티어는 유지될 예정입니다.

• 공정 사용: 업스트림의 NTS 할당량은 공유됩니다. Umm — 따라서 대량의 자동화 트래픽은 유료 티어 출시 전에 rate limit의 대상이 될 수 있습니다.

FAQ

한국 사업자등록번호란 무엇인가요?

10자리 식별번호(사업자등록번호, 자주 123-45-67890으로 표기)로서 대한민국 국세청이 모든 사업자에게 부여하는 고유 번호입니다.

한국 기업이 여전히 운영 중인지 확인할 수 있나요?

네, check_korean_business_status를 호출하세요. "status": "active"(활성)는 해당 사업이 현재 등록·운영 중임을 뜻하고, "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.