概览
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.
