Skip to main content
Glama

홈택스 원천세 정기신고 초안 초기화

hometax__tax__withholding__regular_report__init
Destructive

REQUIRES prior hometax__session__login call with same account_link_id. Initialize a Hometax regular-withholding draft. 호출마다 토큰 1소진

Input Schema

NameRequiredDescriptionDefault
periodsYessubmitYm, attrYm, pymnYm period object
draft_modeNo작성 방식. new(기본값)는 새 신고서로 작성하며, 이미 작성 중인 신고서가 있으면 그것을 지우고 시작합니다. resume 은 작성 중인 신고서를 이어서 씁니다. init 과 basic_save 에 같은 값을 보내 주세요.
fixture_keyNoOptional local fixture key
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).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.6/5.0
Behavior3/5

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

Annotations already declare destructiveHint=true and readOnlyHint=false, so the destructive nature is known. The description adds two useful facts beyond the annotations: the login prerequisite and the per-call token cost ('호출마다 토큰 1소진'). However, it does not say what state gets destroyed or what is returned, so the behavioral profile is only partly fleshed out.

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

Conciseness4/5

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

Three short clauses with the prerequisite front-loaded and no padding. The mixed Korean/English token note is terse but still readable, keeping the description compact.

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?

The tool has no output schema, so the description ought to say what a successful init returns (for example, a draft handle or period key that later *_save calls depend on). It also does not state the observable effect of draft_mode=new wiping existing drafts. The prerequisite and token cost are useful, but the lifecycle context is still incomplete.

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 periods, draft_mode, fixture_key and account_link_id are all documented in the schema itself, including the new-vs-resume semantics. The description adds nothing about parameters, so the baseline 3 applies.

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?

States a specific verb and resource ('Initialize a Hometax regular-withholding draft'), which lets an agent separate it from the sibling *_save/*_submit/*_preview tools in the same family. It does not explicitly name which sibling to use next, so it falls short of a 5.

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?

Gives a concrete prerequisite: a prior hometax__session__login call with the same account_link_id. It does not discuss when to choose init versus resume (the schema enum carries that) nor how it relates to basic_save/detail_save, so a 4 rather than 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