Korea Ground-Truth / Tools / get_pricing
가격표 조회 — 툴별 크레딧 비용 (무료)
Get pricing (free)
Cost: free. ≈ 0원/호출 · 출처: internal · 캐시 없음
어떤 문제를 푸나
툴별 비용, 크레딧 단가, 충전 패키지를 기계가독 형식으로 반환합니다.
- 비용 추정
- 툴 선택 전 가격 비교
호출 방법
REST
curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/tools/get_pricing \
-H "Authorization: Bearer kgt_live_..." \
-H "content-type: application/json" \
-d '{}'MCP (Claude Code / Cursor / any MCP client)
claude mcp add --transport http kgt https://kr-groundtruth-mcp.vercel.app/api/mcp --header "Authorization: Bearer kgt_live_..."
# then ask: "get_pricing 툴로 {} 조회해줘"API 키 발급 (사람 불필요, 무료 50 credits)
curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/accounts -H "content-type: application/json" -d '{"email":"you@example.com"}'입력
| field | type | required | description |
|---|
응답 예시 (실제 응답, 2026-08-26)
{
"ok": true,
"data": {
"currency": "KRW",
"credit_price_krw": 10,
"signup_bonus_credits": 50,
"tools": [
{
"name": "verify_business_registration",
"credits": 2,
"cache_hit_credits": 1,
"cache_ttl_sec": 3600,
"source": "국세청 (data.go.kr)",
"description": "국세청 사업자등록번호 상태(계속사업자/휴업/폐업/미등록)와 과세유형을 조회합니다. 대표자명(representative_name)과 개업일(opened_date, YYYYMMDD)을 함께 주면 등록정보 진위확인까지 수행합니다. 한 번에 최대 100건. 결과 status: active | suspended | closed | not_registered."
},
{
"name": "search_address",
"credits": 1,
"cache_hit_credits": 1,
"cache_ttl_sec": 2592000,
"source": "행정안전부 (juso.go.kr)",
"description": "도로명주소·지번주소·건물명 키워드로 공식 주소를 검색해 정규화합니다. 우편번호(postal_code), 행정구역코드(adm_code), 아파트 실거래가 조회용 법정동코드 5자리(lawd_code), 영문주소를 반환합니다. 예: '세종대로 209', '역삼동 736-1', '삼성전자 본사'."
},
{
"name": "search_corporation",
"credits": 1,
"cache_hit_credits": 1,
"cache_ttl_sec": 604800,
"source": "DART corpCode",
"description": "법인명으로 금융감독원 DART 등록 법인을 검색해 corp_code(8자리 고유번호)를 찾습니다. 상장사는 stock_code가 함께 반환됩니다. lookup_corporation의 corp_code 입력으로 사용하세요."
},
{
"name": "lookup_corporation",
"credits": 2,
"cache_hit_credits": 1,
"cache_ttl_sec": 604800,
"source": "DART (opendart.fss.or.kr)",
"description": "DART corp_code로 기업개황을 조회합니다: 정식 법인명, 대표자, 법인등록번호, 사업자등록번호, 주소, 업종코드, 설립일, 상장시장. corp_code를 모르면 먼저 search_corporation을 호출하세요."
},
{
"name": "apartment_trade_prices",
"credits": 3,
"cache_hit_credits": 1,
"cache_ttl_sec": 86400,
"source": "국토교통부 (data.go.kr)",
"description": "국토교통부 아파트 매매 실거래가를 시군구(법정동코드 5자리) + 계약월(YYYYMM) 단위로 조회합니다. lawd_code는 search_address 결과의 lawd_code를 사용하세요 (예: 강남구 11680). deal_amount_krw는 원 단위 정수입니다."
},
{
"name": "search_law",
"credits": 2,
"cache_hit_credits": 1,
"cache_ttl_sec": 86400,
"source": "법제처 (law.go.kr)",
"description": "법제처 국가법령정보센터에서 현행 법령(법률·시행령·시행규칙)을 검색합니다. 법령ID, 소관부처, 공포/시행일, 상세 링크를 반환합니다. 예: '개인정보 보호법', '주택임대차보호법'."
},
{
"name": "get_balance",
"credits": 0,
"cache_hit_credits": 0,
"cache_ttl_sec": 0,
"source": "internal",
"description": "현재 API 키 계정의 크레딧 잔액과 충전 URL 안내를 반환합니다."
},
{
"name": "get_pricing",
"credits": 0,
"cache_hit_credits": 0,
"cache_ttl_sec": 0,
"source": "internal",
"description": "툴별 크레딧 비용, 크레딧 단가(KRW), 충전 방법을 반환합니다."
}
],
"topup_packages": [
{
"credits": 100,
"amount_krw": 1000
},
{
"credits": 500,
"amount_krw": 5000
},
{
"credits": 2000,
"amount_krw": 20000
},
{
"credits": 10000,
"amount_krw": 100000
}
],
"topup": {
"how": "POST /v1/topups {credits} with your API key → returns checkout_url. A human operator pays via card (Toss Payments); credits are added on confirmation.",
"min_credits": 100
},
"mcp_url": "https://kr-groundtruth-mcp.vercel.app/api/mcp",
"openapi_url": "https://kr-groundtruth-mcp.vercel.app/openapi.json"
},
"meta": {
"tool": "get_pricing",
"cost": 0,
"balance_remaining": 48,
"cache_hit": false,
"source": "internal",
"fetched_at": "2026-08-26T14:00:00.000Z",
"usage_event_id": "usg_…"
}
}모든 응답은 meta.cost, meta.balance_remaining를 포함합니다. 업스트림 오류 시 자동 환불되며, 잔액 부족 시 402 INSUFFICIENT_CREDITS와 함께 충전 URL이 반환됩니다.
함께 쓰는 툴
- 잔액 조회 — 현재 API 키의 크레딧 (무료) — Cost: free.