Skip to main content
Glama

근로복지공단 개인별 부과고지보험료 근로자 검색

comwel__info__individual_billed_premium__worker_select
Read-only

REQUIRES prior comwel__auth__npki_session__login call with same account_link_id. Search and select a worker for COMWEL individual billed-premium inquiry. For an authenticated call, generate and save request_idempotency_key before the first request. Reuse it with the same arguments only to recover that request after a lost response; use a new key for a new execution. Without it, calling again remains a new request. This optional key is not available to anonymous taste calls. Keep any provider-specific idempotency_key unchanged; it is a different field. 호출마다 토큰 1소진

Input Schema

NameRequiredDescriptionDefault
birth_ymdYesWorker birth date YYMMDD
worker_nameYesWorker name
insurance_yearYesInsurance year YYYY
account_link_idNoAccount link ID (UUID v4). Optional — the server auto-resolves from your API key when omitted. Provide explicitly only when you have multiple certificates for the same provider. Each institution has a separate ID (Hometax != NHIS != NPS != FourInsure).
business_management_noNoBusiness management number (optional)
request_idempotency_keyNoOptional same-request recovery key for authenticated calls; see the tool description.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / request_idempotency_key
      Added value: +{
      +  "description": "Optional same-request recovery key for authenticated calls; see the tool description.",
      +  "maxLength": 128,
      +  "minLength": 1,
      +  "pattern": "^[\\x20-\\x7E]+$",
      +  "type": "string"
      +}
  2. First observed

TDQS

B3.4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and destructiveHint=false, yet the description still adds genuinely useful behavior: the auth/session dependency, per-call token consumption ('호출마다 토큰 1소진'), and full idempotency semantics including that an omitted key makes every retry a new request. It stops short of saying what the selection produces or whether it persists state.

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

Conciseness2/5

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

Roughly two-thirds of the text is generic, reusable idempotency boilerplate that applies to every tool in this family, including an aside about 'anonymous taste calls' and a note about provider-specific idempotency_key fields that no parameter here exposes. The one sentence of actual tool-specific purpose is crowded between boilerplate blocks.

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?

For a 6-parameter readOnly tool with full schema coverage and no output schema, the auth and cost context is adequate. What is missing is the outcome of the call — whether it returns a candidate list to choose from or commits a selection used by the detail tool — which matters for a tool literally named select.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents insurance_year, worker_name, birth_ymd, account_link_id and business_management_no; the description adds no format detail beyond that. The only parameter the description elaborates on is request_idempotency_key, and even there the schema already carries the pattern, bounds and a pointer back to the description.

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 sentence 'Search and select a worker for COMWEL individual billed-premium inquiry' gives a specific verb plus resource and scopes it to a lookup step, which distinguishes it from the sibling comwel__info__individual_billed_premium__detail. The purpose is however buried after a prerequisite sentence and before a long generic idempotency block, so it is clear once found but not front-and-center.

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

Usage Guidelines3/5

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

It states a hard prerequisite ('REQUIRES prior comwel__auth__npki_session__login call with same account_link_id') and explains when to reuse vs. regenerate the idempotency key. What it never says is when to pick this tool over the sibling detail tool, or whether worker_select is a mandatory precondition for the detail call — the agent must infer the ordering.

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