Korea Ground-Truth / Tools / get_balance
잔액 조회 — 현재 API 키의 크레딧 (무료)
Get credit balance (free)
Cost: free. ≈ 0원/호출 · 출처: internal · 캐시 없음
어떤 문제를 푸나
에이전트가 남은 크레딧과 충전 방법을 확인합니다.
- 작업 전 잔액 확인
- 402 발생 전 사전 충전 요청
호출 방법
REST
curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/tools/get_balance \
-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_balance 툴로 {} 조회해줘"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": {
"balance": 138,
"credit_price_krw": 10,
"topup": "POST /v1/topups {credits} → checkout_url (hand it to a human operator to pay)"
},
"meta": {
"tool": "get_balance",
"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이 반환됩니다.
함께 쓰는 툴
- 가격표 조회 — 툴별 크레딧 비용 (무료) — Cost: free.