MCP.so
Sign In
K

Korea Business Verify

@wujinkim

Repository

About Korea Business Verify

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.

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

5

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

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

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

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

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

Overview

What is Korea Business Verify?

Korea Business Verify is an MCP (Model Context Protocol) server that provides AI agents with tools to verify Korean business registration information—authenticity, open/closed status, tax types, and invoice eligibility—using the National Tax Service (NTS) public data API. It is designed for developers and AI assistants working with Korean business data.

How to use Korea Business Verify?

Run without a service key for demo mode: npx -y korea-business-verify (uses virtual business numbers). For live data, obtain API keys (see docs/get-api-key.md), set NTS_SERVICE_KEY in .env, then run node dist/index.js. Integrate with Claude Desktop or Cursor via claude_desktop_config.json using npx or a local build.

Key features of Korea Business Verify

  • 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

Use cases of Korea Business Verify

  • Verify business registration authenticity (number, representative, opening date)
  • Check if a business is open, closed, or suspended plus tax type
  • Batch‑check contractor statuses for expense processing or settlement
  • Determine whether a business can issue tax invoices (with reasoning)
  • Explain Korean tax types (general, simplified, exempt) in practical terms

FAQ from Korea Business Verify

What happens if I don't have a NTS service key?

The server automatically runs in demo mode using virtual business numbers (e.g., 1111111119), allowing you to test all five tools without a real API key.

How do I get live API keys?

Follow the guide at docs/get-api-key.md. You must apply separately for the authenticity verification service and the status check service.

Does this server store any of my data?

No. Service keys exist only in your local .env file. Input values (e.g., representative names) are sent to NTS and immediately discarded. Only business numbers and status results are cached (for 24h) to improve performance.

Is the verification result legally binding?

No. The results are based on NTS public data and are for reference only. For legally binding documents, consult official Hometax issued certificates.

How is the server authenticated and what transport does it use?

Authentication is via an environment variable (NTS_SERVICE_KEY). The server communicates over stdio (MCP standard transport). No network‑based authentication is needed beyond the API key.

Frequently asked questions

What happens if I don't have a NTS service key?

The server automatically runs in demo mode using virtual business numbers (e.g., `1111111119`), allowing you to test all five tools without a real API key.

How do I get live API keys?

Follow the guide at `docs/get-api-key.md`. You must apply separately for the authenticity verification service and the status check service.

Does this server store any of my data?

No. Service keys exist only in your local `.env` file. Input values (e.g., representative names) are sent to NTS and immediately discarded. Only business numbers and status results are cached (for 24h) to improve performance.

Is the verification result legally binding?

No. The results are based on NTS public data and are for reference only. For legally binding documents, consult official Hometax issued certificates.

How is the server authenticated and what transport does it use?

Authentication is via an environment variable (`NTS_SERVICE_KEY`). The server communicates over stdio (MCP standard transport). No network‑based authentication is needed beyond the API key.

Comments

Basic information

License

MIT

Transports

stdio

Author

wujinkim

Submitted by

김우진

More MCP servers

LocalCan

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

82

Termany

thinkany-ai

Agent-Native Terminal

174

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

1

OpenLore

aakarim

Serve your docs to AI agents over SSH and MCP. Agents use ls, cat, grep, find, and pipes against a virtual filesystem backed by your documentation. Identity-scoped access, governed writing with human approval, and portab

66
F

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

14