Korea Business Verify

by wujinkim

215 downloads
Not rated
GitHub

About

Verify Korean business registration numbers via the official NTS API — validity, active/closed status, tax type, and tax-invoice eligibility judgment with cited basis. Zero-key DEMO mode included, one-command install via npx.

Details

Author
wujinkim
Downloads
215

- Five specialized tools for business verification and tax inquiries
- Demo mode with virtual business numbers (no API key required)
- Batch status check for up to 100 businesses
- Automatic retry with exponential backoff (3 attempts) on API failures
- No storage of API keys or sensitive input data; status cached for 24h
- Checksum validation before calling NTS API

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Korea Business Verify
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

verify_business

한국 사업자등록정보 진위확인. 국세청 등록정보와 입력(사업자번호·대표자명·개업일자)의 일치 여부. 대표자명은 검증 즉시 폐기되며 저장되지 않습니다.

check_business_status

사업자 휴폐업 상태·과세유형·폐업일자 조회. 호출 빈도가 가장 높은 도구.

batch_check_status

최대 100건 사업자 상태 일괄 조회. 경비처리·정산 자동화용.

check_invoice_eligibility

과세유형·휴폐업 상태를 종합해 세금계산서 수취 가능 여부 판정 + 근거. 순수 래퍼 대비 차별화 도구.

explain_kr_tax_type

한국 과세유형(일반/간이/면세/비과세)의 실무 의미 해설. API 호출 없음.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "korea business verify": {
            "korea-business-verify": {
                "command": "npx",
                "args": [
                    "-y",
                    "korea-business-verify"
                ],
                "env": {
                    "NTS_SERVICE_KEY": "YOUR_DATA_GO_KR_SERVICE_KEY"
                }
            }
        }
    }
}

McpServers

{
    "korea-business-verify": {
        "command": "npx",
        "args": [
            "-y",
            "korea-business-verify"
        ],
        "env": {
            "NTS_SERVICE_KEY": "YOUR_DATA_GO_KR_SERVICE_KEY"
        }
    }
}

Verify Korean business registration numbers via the official NTS API — validity, active/closed status, tax type, and tax-invoice eligibility judgment with cited basis. Zero-key DEMO mode included, one-command install via npx.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.