OK Agent

사업자등록번호 조회 — 휴업·폐업 여부 확인하는 법

최종 수정

사업자등록번호의 휴업·폐업 여부와 과세 유형은 국세청 홈택스나 공공데이터포털의 국세청 상태조회 API로 확인합니다. K-MCP의 kr_check_business 도구를 AI에 연결하면 번호만 주고 "이 거래처들 정상이야?"라고 물어도 계속·휴업·폐업 상태, 과세 유형, 폐업일을 최대 100건까지 한 번에 알려 줍니다. 원격 연결로 쓰면 공공데이터 키도 필요 없습니다.

언제 확인하나요

  • 새 거래처 등록·세금계산서 발행 전
  • 폐업한 업체에 대금을 보내기 전
  • 간이과세자인지 확인해 매입세액 공제 여부를 판단할 때

AI에게 이렇게 물어보세요

답하는 도구: kr_check_business (@appmonster/mcp-public-data) 도구 설명

AI에 연결하기 (1분, 무료)

설치 없이 주소 하나만 연결하면 됩니다. 조회 도구가 모두 열려 있고, 하루 100회까지는 가입도 필요 없습니다.

https://okagent.kr/api/mcp
Claude
설정 → 커넥터 → 커스텀 커넥터 추가 → 이름 K-MCP, URL에 위 주소
ChatGPT
설정 → 앱과 커넥터 → 고급 설정에서 개발자 모드 켜기 → 커넥터 만들기 → MCP 서버 URL에 위 주소, 인증 없음
Claude Code
claude mcp add --transport http kmcp https://okagent.kr/api/mcp
Cursor
{"mcpServers":{"kmcp":{"url":"https://okagent.kr/api/mcp"}}}

내 컴퓨터에서만 돌리고 싶으면 로컬 설치도 됩니다 (해당 서비스 키 필요):

claude mcp add public-data -- npx -y @appmonster/mcp-public-data

개발자: API로 바로 호출

같은 기능을 HTTP로도 씁니다. 도구 목록은 GET https://okagent.kr/api/tools, 명세는 openapi.json에 있습니다.

curl -s -X POST https://okagent.kr/api/tools/kr_check_business \
  -H "content-type: application/json" \
  -d '{"numbers":["123-45-67890"]}'

자주 묻는 질문

상호나 대표자 이름도 나오나요?

국세청 상태조회는 상태·과세유형·폐업일만 줍니다. 상호·대표자 일치 확인은 별도의 진위확인 서비스가 필요합니다.

결과가 '등록되지 않은 번호'로 나와요.

번호를 잘못 입력했거나 국세청에 없는 번호입니다. 하이픈은 있어도 되고 10자리 숫자여야 합니다.

함께 보면 좋은 글