Korea Business Verify (KBV)
Find and verify Korean businesses by name or number. 10 free calls/day, then pay-per-call (x402).
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"kbv-server": {
"url": "https://kbv-server-f7vfitmlkq-du.a.run.app/mcp"
}
}
}원격 엔드포인트
https://kbv-server-f7vfitmlkq-du.a.run.app/mcpstreamable-http할 수 있는 일
도구 목록
도구 (4)
🟢check_korean_business_status(business_number)
Check the registration status of a Korean business by its 10-digit business registration number (사업자등록번호). Returns whether the business is active, suspended, or closed, plus tax type. Data source: Korea National Tax Service, real-time.
입력 스키마
{
"type": "object",
"properties": {
"business_number": {
"type": "string",
"description": "10-digit Korean business registration number; hyphens/spaces allowed, e.g. \"123-45-67890\""
}
},
"required": [
"business_number"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"business_number": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"active",
"suspended",
"closed",
"not_registered"
]
},
"status_code_raw": {
"type": "string"
},
"tax_type": {
"type": "string",
"enum": [
"general",
"simplified",
"exempt",
"non_profit",
"unknown"
]
},
"closed_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checked_at": {
"type": "string"
},
"source": {
"type": "string",
"const": "Korea National Tax Service (NTS)"
},
"cache": {
"type": "boolean"
}
},
"required": [
"business_number",
"status",
"status_code_raw",
"tax_type",
"closed_date",
"checked_at",
"source",
"cache"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢check_korean_business_batch(business_numbers)
Check the registration status of up to 100 Korean businesses in a single call by their 10-digit business registration numbers (사업자등록번호). Returns one status entry per input number (order preserved) plus a summary count. Use this instead of repeated single checks when screening supplier or customer lists. Recently checked numbers may be answered from a cache up to 24 hours old (marked "cache": true). Data source: Korea National Tax Service.
입력 스키마
{
"type": "object",
"properties": {
"business_numbers": {
"minItems": 1,
"type": "array",
"items": {
"type": "string"
},
"description": "1-100 Korean business registration numbers; hyphens/spaces allowed"
}
},
"required": [
"business_numbers"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"business_number": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"active",
"suspended",
"closed",
"not_registered"
]
},
"status_code_raw": {
"type": "string"
},
"tax_type": {
"type": "string",
"enum": [
"general",
"simplified",
"exempt",
"non_profit",
"unknown"
]
},
"closed_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checked_at": {
"type": "string"
},
"source": {
"type": "string",
"const": "Korea National Tax Service (NTS)"
},
"cache": {
"type": "boolean"
}
},
"required": [
"business_number",
"status",
"status_code_raw",
"tax_type",
"closed_date",
"checked_at",
"source",
"cache"
],
"additionalProperties": false
}
},
"summary": {
"type": "object",
"properties": {
"total": {
"type": "number"
},
"active": {
"type": "number"
},
"suspended": {
"type": "number"
},
"closed": {
"type": "number"
},
"not_registered": {
"type": "number"
}
},
"required": [
"total",
"active",
"suspended",
"closed",
"not_registered"
],
"additionalProperties": false
}
},
"required": [
"results",
"summary"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢find_korean_business(name, limit)
Find a Korean company by name (English or Korean) when you do not know its 10-digit business registration number — the number every other tool here needs. Returns ranked candidates with a confidence score and discriminating evidence (registration status, tax type, region), because a name can match several distinct companies: "Samsung Electronics" matches four. Sources: DART (disclosure filers, English names) and the Public Procurement Service registry (small businesses).
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Company name in English or Korean, e.g. \"Samsung Electronics\" or \"삼성전자\""
},
"limit": {
"description": "Maximum candidates to return (default 5)",
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"name"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢verify_korean_business(business_number, representative_name, opening_date, address)
Verify that a Korean business registration number matches the provided representative name and opening date. Use for KYB / due-diligence before transacting with a Korean company. Returns match result plus current status.
입력 스키마
{
"type": "object",
"properties": {
"business_number": {
"type": "string",
"description": "10-digit Korean business registration number; hyphens/spaces allowed"
},
"representative_name": {
"type": "string",
"minLength": 1,
"description": "Representative (CEO) name as registered, e.g. \"홍길동\""
},
"opening_date": {
"type": "string",
"description": "Business opening date in YYYY-MM-DD format, e.g. \"2015-03-02\""
},
"address": {
"description": "Optional business address to include in the match (maps to NTS b_adr)",
"type": "string"
}
},
"required": [
"business_number",
"representative_name",
"opening_date"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"business_number": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"active",
"suspended",
"closed",
"not_registered"
]
},
"status_code_raw": {
"type": "string"
},
"tax_type": {
"type": "string",
"enum": [
"general",
"simplified",
"exempt",
"non_profit",
"unknown"
]
},
"closed_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checked_at": {
"type": "string"
},
"source": {
"type": "string",
"const": "Korea National Tax Service (NTS)"
},
"cache": {
"type": "boolean"
},
"identity_match": {
"type": "boolean"
}
},
"required": [
"business_number",
"status",
"status_code_raw",
"tax_type",
"closed_date",
"checked_at",
"source",
"cache",
"identity_match"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}커뮤니티
증거