Korea Ground-Truth / Examples / company-verification

거래처 검증 — 계약 전에 사업자·법인·주소를 한 번에

Verify a Korean company before you sign

사용자 → 에이전트

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

국세청·DART·행안부 세 기관의 데이터를 각각 붙이지 않아도 됩니다. 에이전트가 툴 4개를 순서대로 호출하고 교차 검증합니다. 총 비용 6 credits(60원).

호출 체인

verify_business_registration → search_corporation → lookup_corporation → search_address

실제 호출 trace (2026-08-27, 프로덕션)

1. verify_business_registration Cost: 2 credits/call (cache hit: 1).

→ tools/call verify_business_registration {"business_numbers":["124-81-00998"]}
{
  "ok": true,
  "data": {
    "source": "국세청 사업자등록정보 (data.go.kr)",
    "results": [
      {
        "status": "active",
        "tax_type": "부가가치세 일반과세자",
        "registered": true,
        "status_raw": "계속사업자",
        "closed_date": null,
        "tax_type_code": "01",
        "unit_taxpayer": false,
        "business_number": "1248100998",
        "e_invoice_apply_date": null,
        "tax_type_changed_date": null
      }
    ]
  },
  "meta": {
    "tool": "verify_business_registration",
    "cost": 1,
    "balance_remaining": 127,
    "cache_hit": true,
    "source": "국세청 (data.go.kr)",
    "fetched_at": "2026-08-27T09:00:00.000Z",
    "usage_event_id": "usg_…"
  }
}

2. search_corporation Cost: 1 credit/call (cache hit: 1).

→ tools/call search_corporation {"name":"삼성전자","limit":3}
{
  "ok": true,
  "data": {
    "source": "금융감독원 DART (opendart.fss.or.kr) corpCode 목록 (로컬 캐시)",
    "results": [
      {
        "listed": true,
        "corp_code": "00126380",
        "corp_name": "삼성전자",
        "stock_code": "005930",
        "modified_date": "20251201"
      },
      {
        "listed": false,
        "corp_code": "01345812",
        "corp_name": "삼성전자서비스씨에스",
        "stock_code": null,
        "modified_date": "20230125"
      },
      {
        "listed": false,
        "corp_code": "00252074",
        "corp_name": "삼성전자판매",
        "stock_code": null,
        "modified_date": "20240124"
      }
    ]
  },
  "meta": {
    "tool": "search_corporation",
    "cost": 1,
    "balance_remaining": 126,
    "cache_hit": true,
    "source": "DART corpCode",
    "fetched_at": "2026-08-27T09:00:00.000Z",
    "usage_event_id": "usg_…"
  }
}

3. lookup_corporation Cost: 2 credits/call (cache hit: 1).

→ tools/call lookup_corporation {"corp_code":"00126380"}
{
  "ok": true,
  "data": {
    "fax": "031-200-7538",
    "phone": "02-2255-0114",
    "ir_url": null,
    "market": "KOSPI",
    "source": "금융감독원 DART (opendart.fss.or.kr)",
    "address": "경기도 수원시 영통구  삼성로 129 (매탄동)",
    "ceo_name": "전영현, 노태문",
    "homepage": "www.samsung.com/sec",
    "corp_code": "00126380",
    "corp_name": "삼성전자(주)",
    "market_raw": "Y",
    "stock_code": "005930",
    "stock_name": "삼성전자",
    "corp_name_en": "SAMSUNG ELECTRONICS CO,.LTD",
    "industry_code": "264",
    "established_date": "19690113",
    "fiscal_year_end_month": "12",
    "business_registration_number": "1248100998",
    "corporate_registration_number": "1301110006246"
  },
  "meta": {
    "tool": "lookup_corporation",
    "cost": 1,
    "balance_remaining": 125,
    "cache_hit": true,
    "source": "DART (opendart.fss.or.kr)",
    "fetched_at": "2026-08-27T09:00:00.000Z",
    "usage_event_id": "usg_…"
  }
}

4. search_address Cost: 1 credit/call (cache hit: 1).

→ tools/call search_address {"keyword":"경기도 수원시 영통구 삼성로 129","per_page":1}
{
  "ok": true,
  "data": {
    "page": 1,
    "total": 5,
    "source": "행정안전부 도로명주소 (juso.go.kr)",
    "results": [
      {
        "ri": null,
        "sido": "경기도",
        "sigungu": "수원시 영통구",
        "adm_code": "4111710100",
        "lawd_code": "41117",
        "road_name": "삼성로",
        "lot_sub_no": "0",
        "lot_main_no": "416",
        "postal_code": "16677",
        "eupmyeondong": "매탄동",
        "road_address": "경기도 수원시 영통구 삼성로 129 (매탄동)",
        "road_mgmt_no": "411173177009",
        "building_name": "삼성전자 1공장",
        "jibun_address": "경기도 수원시 영통구 매탄동 416 삼성전자 1공장",
        "is_underground": false,
        "building_sub_no": "0",
        "english_address": "129 Samsung-ro, Yeongtong-gu, Suwon-si, Gyeonggi-do",
        "is_mountain_lot": false,
        "building_main_no": "129",
        "building_mgmt_no": "4111710100104160000055916",
        "road_address_main": "경기도 수원시 영통구 삼성로 129",
        "road_address_detail": " (매탄동)"
      }
    ]
  },
  "meta": {
    "tool": "search_address",
    "cost": 1,
    "balance_remaining": 124,
    "cache_hit": true,
    "source": "행정안전부 (juso.go.kr)",
    "fetched_at": "2026-08-27T09:00:00.000Z",
    "usage_event_id": "usg_…"
  }
}

직접 실행하기

# 1) 키 발급 (무료 50 credits)
curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/accounts -H "content-type: application/json" -d '{"email":"you@example.com"}'
# 2) MCP 연결
claude mcp add --transport http kgt https://kr-groundtruth-mcp.vercel.app/api/mcp --header "Authorization: Bearer kgt_live_..."
# 3) Claude에게 그대로 말하기
"삼성전자(사업자번호 124-81-00998)랑 계약하려고 하는데 사업자 상태랑 법인정보, 주소 확인해줘."

다른 예시