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.
K
Korea Business Verify MCP Server
@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 工具
5한국 사업자등록정보 진위확인. 국세청 등록정보와 입력(사업자번호·대표자명·개업일자)의 일치 여부. 대표자명은 검증 즉시 폐기되며 저장되지 않습니다.
사업자 휴폐업 상태·과세유형·폐업일자 조회. 호출 빈도가 가장 높은 도구.
최대 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
常见问题
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.
更多 MCP 服务器
Full Self Browsing
Lakshman TurlapatiDOM-first AI browser automation for Chrome and MCP clients.
194
Medplum
medplumMedplum is a healthcare platform that helps you quickly develop high-quality compliant applications.
2.5K
F
fhirHydrant
faulkjOpen-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
Termany
thinkany-aiAgent-Native Terminal
174
Cronwatch
cronwatchdevCronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.
31
评论