Korea Business Verify MCP Server

@wujinkim

リポジトリ

基本情報

ライセンス

MIT

トランスポート

stdio

作者

wujinkim

投稿者

김우진

Korea Business Verify MCP Server について

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.

Korea Business Verify MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

Korea Business Verify MCP Server のツール

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

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

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

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

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

概要

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

よくある質問

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.

マーケットプレイスの他のコンテンツ

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.

PLUR

plur-ai

AI agents start every session with amnesia — you re-explain the project, repeat your preferences, and correct the same mistakes over and over. PLUR gives them a memory that persists. Your agent's corrections, preference

226

Free SEO Audit for Claude

houtini.com

Free SEO Audit MCP server for Claude - captures and stores all the raw data you need for a complete technical SEO audit. Google Search Console + a first-party crawl + DataForSEO + Majestic SEO merged into one prioritised

Instagram MCP Server

HasData

Read public Instagram profiles and post feeds by handle in Claude, Cursor, and other MCP clients. Get follower counts, captions, hashtags, mentions, and engagement counts as structured JSON.

Gologin MCP Server

gologinapp

MCP server for managing Gologin browser profiles, proxies, fingerprints and cloud browser sessions through AI conversations