Korea Business Verify MCP server

by wujinkim·io.github.wujinkim/korea-business-verify·v0.1.1

No reviews yet

한국 사업자 검증 액션 MCP 서버 — 진위확인·휴폐업·과세유형·세금계산서 발행 가능 여부 (국세청 공공데이터 기반)

B78/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B78/100

full report

Adoption

New

0 stars35 downloads/wk

Reviews

Write one

Nobody has reviewed Korea Business Verify yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Korea Business Verify tools (5)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

batch_check_status
최대 100건 사업자 상태 일괄 조회. 경비처리·정산 자동화용.
check_business_status
사업자 휴폐업 상태·과세유형·폐업일자 조회. 호출 빈도가 가장 높은 도구.
check_invoice_eligibility
과세유형·휴폐업 상태를 종합해 세금계산서 수취 가능 여부 판정 + 근거. 순수 래퍼 대비 차별화 도구.
explain_kr_tax_type
한국 과세유형(일반/간이/면세/비과세)의 실무 의미 해설. API 호출 없음.
verify_business
한국 사업자등록정보 진위확인. 국세청 등록정보와 입력(사업자번호·대표자명·개업일자)의 일치 여부. 대표자명은 검증 즉시 폐기되며 저장되지 않습니다.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings

Code scan17 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 80 days ago12/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Korea Business Verify compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 78/100; higher than 57% of 48,255 servers
Tools: 5; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 35; more than 25% of 12,191 servers with a package

What its tools let an agent do: 5 read

Install Korea Business Verify in Claude Code, Cursor or VS Code

Runs npx -y korea-business-verify on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add korea-business-verify -- npx -y korea-business-verify

Add to Cursor

What the publisher says

From the Korea Business Verify repository's README, as published. We do not edit it. Read it on GitHub

korea-business-verify

한국 사업자 검증 MCP 서버 — 진위확인·휴폐업·과세유형·세금계산서 발행 가능 여부를 AI 에이전트에게 도구로 제공합니다. 국세청 공공데이터포털 API 기반.

⚠️ 면책: 국세청 공공데이터 기준의 참고 결과이며 세무 자문이 아닙니다. 법적 효력이 있는 증명은 홈택스 발급 문서를 참조하세요.

도구 5종

빠른 시작 — DEMO (서비스키 불필요)

npx -y korea-business-verify   # 서비스키 없으면 자동 DEMO 모드 (가상 사업자번호로 5종 도구 체험)

소스 빌드(개발자용): npm install && npm run build && DEMO_MODE=1 node dist/index.js

DEMO 가상 사업자번호 (체크섬은 유효하나 실제 존재하지 않는 번호):

라이브 모드 (실제 국세청 API)

서비스키 발급: docs/get-api-key.md (진위·상태 두 서비스 각각 신청 필요)
.env 파일:

NTS_SERVICE_KEY=발급받은_서비스키

실행: node dist/index.js (키가 있으면 자동으로 라이브 모드)

Claude Desktop / Cursor 연동

claudedesktopconfig.json (npx 권장):

{
  "mcpServers": {
    "korea-business-verify": {
      "command": "npx",
      "args": ["-y", "korea-business-verify"],
      "env": { "NTS_SERVICE_KEY": "발급받은_키" }
    }
  }
}

대안: 로컬 빌드 경로로 연동

{
  "mcpServers": {
    "korea-business-verify": {
      "command": "node",
      "args": ["/절대경로/korea-business-verify/dist/index.js"],
      "env": { "NTS_SERVICE_KEY": "발급받은_키" }
    }
  }
}

개인정보 보호 (무저장 원칙)

서비스키는 사용자 로컬 .env에만 존재합니다. 본 서버는 이를 저장하거나 로그에 남기지 않으며, 국세청 API 인증을 위해서만 사용합니다.
대표자명 등 진위확인 입력값은 요청 즉시 폐기됩니다. 진위확인을 위해 국세청 API로 전송되나, 응답 수신과 함께 어떤 로그·캐시·저장소에도 남기지 않습니다.
캐시되는 것은 사업자번호와 상태조회 결과(24h)뿐입니다. 진위확인은 캐시하지 않습니다.
사업자번호는 국세청 호출 전 체크섬 형식 검증으로 사전 필터링합니다.

신뢰성

API 장애(5xx·타임아웃·네트워크) 시 자동 재시도(지수 백오프, 3회). 인증/형식 에러는 즉시 명확한 에러 코드로 응답.
모든 판정 결과에 basis(근거) 필드 동봉.

개발

npm run build     # tsc
npm test          # vitest (커버리지 96%)
npm run lint      # eslint

라이선스

MIT

Nothing above is checked by us. What we check is on the safety report.

Korea Business Verify: common questions

Is Korea Business Verify MCP server safe?: Mostly: it is graded B (78/100). Read the Korea Business Verify safety report
How do I install Korea Business Verify?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Korea Business Verify need an API key?: Yes. The registry entry asks for YOUR_API_KEY.
Is Korea Business Verify maintained?: The last commit was 119 days ago (2026-07-08). The latest release is v0.1.1.
How does Korea Business Verify compare with other MCP servers?: safety score 78/100 (higher than 57% of 48,255 servers); tools 5 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.