This server verifies Korean business registration information (국세청 사업자등록 진위확인·상태 조회) via three read-only tools.
validate_business — Validate a single business registration against supplied details (business number, opening date, representative name, plus optional corp number, business name, address, type/sector); returns match/mismatch (01/02), a message, and status if matched.
check_business_status — Look up registration status for up to 100 comma-separated business numbers; returns request/match counts and per-business status codes (01 continuing, 02 suspended, 03 closed), with guidance text for unregistered numbers.
batch_validate_businesses — Validate up to 100 registrations at once from a JSON array string (required fields b_no, start_dt, p_nm; optional p_nm2, b_nm, corp_no, b_sector, b_type, b_adr); returns counts and per-item results.
All tools are read-only, call external NTS data, accept hyphenated business numbers, and report failures as MCP error results.
Provides tools for accessing Korea's DART electronic disclosure system (Financial Supervisory Service / OpenDART), enabling lookups of corporate codes and company profiles, listing disclosure filings and retrieving their original documents, and fetching key financial accounts and full financial statements.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@nts-business-verification 사업자등록번호 120-88-00767 상태 조회해줘"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
한국어 · English
한국 공공데이터 API 를 MCP(Model Context Protocol) 서버로 제공한다. Claude Desktop, Claude Code 등 MCP 클라이언트에서 국민연금 사업장과 고용·산재보험 현황, 사업자등록 상태, 나라장터 입찰, 기업 재무제표·법인번호·주식시세, DART 전자공시·재무제표, 한국은행 경제통계, 부동산 실거래가, 대통령 연설문, MSDS 화학물질 정보를 바로 조회할 수 있다.
Koomook/data-go-mcp-servers(Apache-2.0, 2025-09 이후 정지)를 기반으로 mcp SDK 2.x 에 맞춰 재정비한 것이다. 툴 이름과 파라미터는 원저장소와 호환된다.
서버 | 기관 / 데이터 | 툴 |
국민연금공단 — 사업장 가입·탈퇴 내역 (+ 법정동코드 조회, 고용·산재보험 현황) |
| |
국세청 — 사업자등록 진위확인·상태 |
| |
조달청 — 나라장터 입찰·낙찰·계약, 조달업체 정보·부정당제재 |
| |
금융위원회 — 기업 재무제표 (+ 법인번호 조회·기업 개요·주식시세·지수·ETF) |
| |
대통령기록관 — 연설문 |
| |
안전보건공단 — MSDS |
| |
금융감독원 — DART 전자공시 (기업 개황, 공시 목록·원문, 재무제표) |
| |
국토교통부 — 부동산 실거래가 (아파트·오피스텔·연립다세대·단독다가구·상업업무용·공장창고·토지, 매매/전월세) + 건축물대장 |
| |
공정거래위원회 — 통신판매사업자 신고 내역 (온라인 판매) |
| |
고용24(옛 워크넷) — 채용공고 (사업자번호로 조회, 기업 규모·자격요건) |
| |
한국은행 — 경제통계시스템 ECOS (기준금리·환율·물가, 100대 지표) |
|
서버 11개, 툴 54개, 공공 API 31종. 모든 툴은 조회 전용이며, 실패는 MCP 오류 결과(isError)로 전달된다. 한 서버가 API 여러 개를 쓰는 경우(molit 12, fsc 5, nps 4, pps 3)는 각각 활용신청이 필요하다 — 표는 api-keys.md. dart-disclosure(OpenDART)·bok-ecos(한국은행 ECOS)·work24-jobs(고용24)는 data.go.kr 이 아닌 각자의 키를 쓴다.
Related MCP server: korea-business-verify
한국 공공데이터 MCP 서버는 대개 API 하나를 감싼다. 이 저장소는 기관을 가로질러 잇는다 — 사업자등록번호 하나가 국세청·공정거래위원회·금융위·근로복지공단·조달청·고용24·DART 를 지나간다:
위는 scripts/demo_due_diligence.py 를 실제로 돌린 화면이다 (실호출 결과, 연출 없음).
직접 돌려볼 수 있다 (실제 API 를 호출하므로 결과는 그때그때 다르다):
uv run python scripts/demo_due_diligence.py 214-87-12538같은 방식의 데모가 셋 더 있다 — 업체별 낙찰 이력(demo_bid_winners.py), 지역 아파트 실거래(demo_realestate.py), 회사 채용 현황(demo_jobs.py).
처음이라면 → 시작하기 (코드·터미널 없이 10분).
요약: data.go.kr 인증키 발급·활용신청 → data-go-mcp-desktop.mcpb 를 Claude Desktop 설정 → 확장 프로그램에 끌어다 놓고 키 입력 → 질문.
서버를 골라 쓰거나 설정 파일로 등록하려면:
uv 설치
data.go.kr 인증키(Decoding) 발급 후 쓰려는 API 에 활용신청 → docs/guide/api-keys.md
Claude Desktop 설정(claude_desktop_config.json)에 추가:
{
"mcpServers": {
"nts-business-verification": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/hichang4u/data-go-mcp-servers#subdirectory=src/nts-business-verification",
"data-go-mcp.nts-business-verification"
],
"env": { "API_KEY": "<data.go.kr 인증키>" }
}
}
}다른 서버는 nts-business-verification 을 서버명으로 바꾸면 된다. dart-disclosure 만 "env": { "DART_DISCLOSURE_API_KEY": "<OpenDART 인증키>" } (data.go.kr 키와 별개, api-keys.md 4절). 전부를 한 프로세스로 띄우는 all-servers, Claude Code, Cline, Smithery(smithery mcp add hichang4u/data-go-mcp), clone 해서 쓰는 방법은 docs/guide/installation.md.
> 사업자등록번호 120-88-00767 상태 조회해줘
계속사업자, 부가가치세 일반과세자 …사용 | 시작하기 · 설치·클라이언트 설정 · API 키·활용신청 · 문제 해결 · 서버별 툴 레퍼런스 |
개발 | CONTRIBUTING · 아키텍처 · 새 서버 추가 · 테스트 · 릴리스 |
이력 |
git clone https://github.com/hichang4u/data-go-mcp-servers && cd data-go-mcp-servers
uv sync --dev --all-packages
cp .env.example .env # API_KEY, DART_DISCLOSURE_API_KEY, BOK_ECOS_API_KEY 채우기 — 실호출 테스트용
uv run pytest # 482 tests; 실호출은 -m integration
uv run ruff check src scripts tests && uv run pyright src scripts tests
uv run python scripts/check_apis.py # 주요 API 생존·권한 확인Python 3.10+, mcp>=2.2. CI 는 ubuntu/windows × 3.10/3.13 에서 pytest, ruff, pyright 를 필수로 돌린다.
Apache-2.0. 원저작물 저작권 표시는 NOTICE 와 각 패키지의 LICENSE 에 유지한다. 이 프로젝트는 data.go.kr 및 각 기관과 무관하며, 데이터 이용은 각 API 의 이용약관을 따른다.
여러 사업자등록정보를 한 번에 진위확인합니다. Batch validate business registrations.
Returns request_count, valid_count, results[] (business_number, valid, valid_msg, status).
Inputs: businesses_json (required). Returns: object
사업자등록 상태를 조회합니다. Check business registration status.
Returns request_count, match_count, businesses[] (status_code 01: 계속사업자, 02: 휴업자, 03: 폐업자; 미등록 번호는 tax_type 에 안내 문구가 온다).
Inputs: business_numbers (required). Returns: object
사업자등록정보 진위확인을 수행합니다. Validate business registration information.
Returns business_number, valid (01: 일치, 02: 불일치), valid_msg, status (일치 시 상태 정보).
Inputs: start_date (required), business_number (required), representative_name (required), corp_number, +5 more. Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 3 tools
validate_business and batch_validate_businesses are clearly distinguished by single vs. batch operation, and check_business_status focuses on status lookup. Some minor overlap exists because validate_business also returns status information, but the purposes are distinct enough for an agent to select correctly.
All tool names follow a consistent verb_noun snake_case pattern. validate_business, check_business_status, and batch_validate_businesses use clear, predictable naming with appropriate verb choices for each action.
Three tools is well-scoped for the business verification domain. Each tool covers a distinct need: single validation, status lookup, and batch validation, with no redundant or superfluous entries.
The domain of business registration verification is fully covered: individual validation, batch validation, and status checks. No obvious missing operations or dead ends exist for the stated purpose.
Verify Korean companies by BRN/사업자등록번호: official NTS status, VAT type, English profile, financials
Verify Korean business registration numbers (National Tax Service) — KYB for Korean counterparties …
Korean ID document verification and PII masking APIs
~960k Korean corporations, not only listed: official IDs linked, live NTS status, English names
