Korea Ground-Truth (KGT) · Korean Official Data MCP · Korea Verification API

AI 에이전트가 한국에서 행동하기 전에 확인하는 API

Official Korean data for AI agents. One API. One MCP.

사업자 · 법인 · 주소 · 부동산 실거래 · 법령

국세청·DART·행안부·국토부·법제처 API를 다섯 번 붙이지 마세요. Korea Ground-Truth 하나만 에이전트에게 주세요. 가입에 사람이 필요 없고, 첫 키에 무료 50 credits가 들어 있습니다. 이후 호출당 10~30원.

curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/accounts -H 'content-type: application/json' -d '{"email":"you@example.com"}'
claude mcp add --transport http kgt https://kr-groundtruth-mcp.vercel.app/api/mcp --header "Authorization: Bearer kgt_live_..."

에이전트가 실제로 하는 일

프로덕션에서 캡처한 실제 호출 trace입니다.

You: 삼성전자(사업자번호 124-81-00998)랑 계약하려고 하는데 사업자 상태랑 법인정보, 주소 확인해줘.

✅ 사업자 상태: 계속사업자 (부가가치세 일반과세자) — 국세청
✅ 법인: 삼성전자(주), DART 고유번호 00126380, KOSPI 005930
✅ 대표자: 전영현, 노태문 · 법인등록번호 1301110006246 · 설립일 1969-01-13

verify_business_registration → search_corporation → lookup_corporation → search_address · 전체 trace 보기 →

You: 래미안 개포 루체하임 2025년 7월 실거래가 확인해줘.

📍 서울특별시 강남구 개포로110길 50 (일원동) — 법정동코드 11680
🏠 2025-07-11 · 전용 84.97㎡ · 12층 · 33억 원 (중개거래)
출처: 국토교통부 실거래가 (2025-07 강남구 전체 376건 중 해당 단지 1건)

search_address → apartment_trade_prices · 전체 trace 보기 →

You: 주택임대차보호법 지금 시행 중인 기준으로 찾아줘. 시행령도.

📜 주택임대차보호법 (법률) — 국토교통부·법무부 · 시행 2026-01-02
📜 주택임대차보호법 시행령 (대통령령) — 국토교통부·법무부 · 시행 2026-07-01
각 항목에 법제처 상세 링크 포함 — 에이전트가 조문을 열어 인용할 수 있습니다.

search_law · 전체 trace 보기 →

데이터 출처 (provenance)

모든 응답의 meta.source에 출처 기관이 명시됩니다. 가공은 정규화(영문 snake_case + 원문 _raw)뿐입니다.

사업자등록 상태·진위	국세청 (National Tax Service)	`verify_business_registration`
법인 검색·기업개황	금융감독원 DART	`lookup_corporation`
도로명주소·우편번호·법정동코드	행정안전부 도로명주소 (MOIS)	`search_address`
아파트 매매 실거래가	국토교통부 (MOLIT)	`apartment_trade_prices`
현행 법령	법제처 국가법령정보센터 (MOLEG)	`search_law`

에이전트가 고객이라서 다른 점

POST /v1/accounts 한 번이면 키 발급 — 가입 폼·이메일 인증 없음
툴 설명 첫 줄에 Cost: N credits/call — 에이전트가 가격을 읽고 계획
응답마다 meta.cost, meta.balance_remaining — 잔액 부족 시 402 + 충전 URL을 사람에게 전달
업스트림 실패는 자동 환불, 장부는 append-only
llms.txt · openapi.json · pricing.json · 공식 MCP Registry io.github.ChloePark85/kr-groundtruth

Tools

사업자등록번호 조회 API Cost: 2 credits/call (cache hit: 1).
주소 정규화 API Cost: 1 credit/call (cache hit: 1).
법인 검색 API Cost: 1 credit/call (cache hit: 1).
기업정보 조회 API Cost: 2 credits/call (cache hit: 1).
아파트 실거래가 조회 API Cost: 3 credits/call (cache hit: 1).
법령 검색 API Cost: 2 credits/call (cache hit: 1).
잔액 조회 Cost: free.
가격표 조회 Cost: free.

크레딧 충전 · GitHub · MCP endpoint https://kr-groundtruth-mcp.vercel.app/api/mcp