Skip to main content
Glama

근로복지공단 개인별 부과고지보험료 상세

comwel__info__individual_billed_premium__detail

먼저 호출할 도구: comwel__auth__npki_session__login (같은 account_link_id). 고른 근로자 한 명의 근로복지공단 개인별 부과고지 보험료 상세를 조회합니다. 파일: 엑셀(xlsx) · 이 작업의 결과로 만든 문서 - output_formats 로 청할 때만 만듭니다. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가 만료되면 결과의 job_id 로 xdata__job__result 를 다시 불러 새 링크를 받습니다. 로그인 없이 받은 결과는 함께 온 recovery_receipt 를 따로 보관했다가, 처음의 job_id 나 pack_run_id 와 함께 xdata__job__result 에 보내세요. 증표로는 그 결과 하나만, 원래 파일 보관 기간이 끝날 때까지 열 수 있습니다. 증표는 공개하지 마세요. 잃어버리면 가입해도 되찾을 수 없습니다. 나중에 로그인해도 증표는 그대로 쓰이고, 다른 결과는 열지 못합니다. 증표가 없으면 처음 계정과 같은 환경(데모 · 정식)에서만 결과를 읽을 수 있습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관 업무에 따로 있는 idempotency_key 칸은 다른 칸이니 그대로 두세요. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "insurance_year": "<insurance_year>",
      "worker_resident_no": "<worker_resident_no>",
      "worker_record_no": "<worker_record_no>",
      "labor_provider_yn": "<labor_provider_yn>"
    },
    "name": "comwel__info__individual_billed_premium__detail"
  }
}

Input Schema

NameRequiredDescriptionDefault
insurance_yearYes보험연도 YYYY.
output_formatsNo선택 입력입니다. 결과를 엑셀(xlsx) 파일로도 받으려면 입력해 주세요. 파일은 결과의 artifacts[] 에 실립니다. 비워 두면 데이터만 받습니다.
account_link_idNo연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다.
insurance_monthNo보험월(MM). 기관 요청에 실려 가지만 응답을 그 달로 줄이지 않습니다. 응답은 그 보험연도의 월별 내역 전체이고, 특정 달은 그 안에서 고릅니다.
worker_record_noYes근로자 관리번호. 근로자 검색(worker_select) 결과에서 받습니다.
labor_provider_ynYes노무제공자 여부 Y 또는 N. 근로자 검색(worker_select) 결과에서 받습니다.
worker_resident_noYes근로자 주민등록번호. 근로자 검색(worker_select) 결과에서 받습니다.
refund_reflection_ynNo환수 처리 반영 여부. 입력하지 않아도 됩니다. 입력한 값은 검사하지 않고 기관 요청에 그대로 실립니다.
business_management_noNo사업장관리번호.
request_idempotency_keyNo로그인한 호출에서 응답을 못 받은 같은 요청을 되찾을 때 쓰는 선택 값입니다. 쓰는 법은 도구 설명에 있습니다.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / request_idempotency_key / description
      Previous value: -"Optional same-request recovery key for authenticated calls; see the tool description."New value: +"로그인한 호출에서 응답을 못 받은 같은 요청을 되찾을 때 쓰는 선택 값입니다. 쓰는 법은 도구 설명에 있습니다."
  2. Changed6 schema fields changed
    • changedInput schema / properties / business_management_no / description
      Previous value: -"Business management number"New value: +"사업장관리번호."
    • changedInput schema / properties / insurance_year / description
      Previous value: -"Insurance year YYYY"New value: +"보험연도 YYYY."
    • changedInput schema / properties / labor_provider_yn / description
      Previous value: -"Labor provider flag Y/N (from worker_select)"New value: +"노무제공자 여부 Y 또는 N. 근로자 검색(worker_select) 결과에서 받습니다."
    • changedInput schema / properties / refund_reflection_yn / description
      Previous value: -"Refund reflection flag Y/N"New value: +"환수 처리 반영 여부. 입력하지 않아도 됩니다. 입력한 값은 검사하지 않고 기관 요청에 그대로 실립니다."
    • changedInput schema / properties / worker_record_no / description
      Previous value: -"Worker record number returned by worker_select"New value: +"근로자 관리번호. 근로자 검색(worker_select) 결과에서 받습니다."
    • changedInput schema / properties / worker_resident_no / description
      Previous value: -"Worker resident number returned by worker_select"New value: +"근로자 주민등록번호. 근로자 검색(worker_select) 결과에서 받습니다."
  3. First observed

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare readOnlyHint=false, and the description explains why in substantive terms: each call consumes a token, creates an XBOSS job and stores a result, so it is not a pure read even when the source agency lookup is read-only. It also discloses artifact lifecycle (download_url valid 15 minutes, file retained 7 days), the recovery_receipt rules, and idempotency-key replay semantics — real behavioral context beyond the annotations. It stops short of describing pagination/rate limits, and the recovery-receipt passage is repetitive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The prerequisite leads and the purpose follows, which is good ordering, but the body sprawls into long dense passages on recovery receipts and demo/production environments that revisit the same point several times. Most sentences carry information, yet the definition is noticeably longer than needed for a 10-parameter read-style lookup.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

It covers prerequisites, file output, link expiry, job_id-based re-fetch, and idempotency, which is a lot for a 10-parameter tool with no output schema. However, with no output schema present, it gives no indication of what the premium-detail payload itself contains (months, amounts, notice fields), and it never states whether account_link_id or business_management_no are practically required.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline would be 3, but the description adds meaning the schema defers on: the schema entry for request_idempotency_key explicitly points to the tool description, which then explains generating, saving, and re-sending the value on retries versus fresh calls. It also clarifies that output_formats is what triggers file creation and that account-less trial calls cannot use that field.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The second sentence states a specific verb and resource with scope: look up the individual billed-premium detail for one selected worker at comwel. That scope (single worker vs. workplace-level notice) separates it from siblings such as comwel__info__premium_billing_notice__detail, but the description never says so explicitly, so differentiation is inferred rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The prerequisite is front-loaded and unambiguous ('먼저 호출할 도구: comwel__auth__npki_session__login (같은 account_link_id)'), and the output_formats condition for producing a file is spelled out. There is no when-not guidance and no explicit routing back to worker_select or to premium_billing_notice__detail, which keeps it below a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources