Skip to main content
Glama

XBOSS

표준재무제표증명 신청

hometax__certificate__apply__financial_statement
Destructive

REQUIRES prior hometax__session__login call with same account_link_id. Apply for Standard Financial Statement Certificate. IRREVERSIBLE: this files an application with the NTS and a receipt record (cvaId + rcatNo) is created; there is no cancel action. Call without confirm first to get a preview, show it to the user, then retry with confirm=true. Never set confirm=true on your own.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
bsnoNo대상 사업자등록번호(숫자 10자리) (서식이 요구하는 값)
txyrNo과세년도(개인, YYYY) (구분에 따라 서식이 요구하는 값)
qrtTrtNo개인/법인 구분 코드(02 개인, 03 법인) (서식이 요구하는 값)
adrOpYnNoShow address on the certificate: 'Y' or 'N'
amtOpYnNoShow amount: 'Y' or 'N'
confirmNoSet true ONLY after showing the preview to the user and receiving their explicit approval. Omit it on the first call to obtain the preview.
incClCdNo소득구분(개인) (구분에 따라 서식이 요구하는 값)
bsyrEndYmNo사업연도 종료연월(법인, YYYYMM) (구분에 따라 서식이 요구하는 값)
resnoOpYnNoShow resident number: 'Y' or 'N' (forced 'N' for corporations)
cerpIsnRqsQtyNoNumber of copies to issue (발급 매수)
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).
cvaDcumGranMthdCdNoDelivery method code (교부방법 코드)
cvaDcumSbmsOrgnClCdNoSubmission target code (제출처 구분코드)

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.3/5.0
Behavior5/5

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

Annotations already flag destructiveHint=true, and the description substantially enriches this by disclosing the concrete consequences: an application is filed with the NTS, a receipt record (cvaId + rcatNo) is created, and no cancel action exists. It also discloses the auth dependency and the confirm safety rule — exactly the context annotations alone cannot convey. No contradiction with annotations.

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?

Four dense sentences, each earning its place: prerequisite, action, irreversibility with concrete effects, and the preview/confirm safety rule. Critical warnings are front-loaded ahead of the workflow instructions, though the block could be structurally clearer; it remains efficient with no filler.

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

Completeness4/5

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

For a destructive two-phase tool with 13 parameters and no output schema, the description covers the prerequisite, the correct call sequence, irreversibility, and hints at the response shape (cvaId + rcatNo). It would benefit from describing the preview response contents and the follow-up download step, but nothing needed to call it safely is missing.

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 baseline of 3 applies; all 13 parameters are documented in the schema. The description adds only flow-level context for confirm and account_link_id (the preview/confirm sequence and the same-ID-as-login requirement), which is helpful but does not add per-parameter meaning beyond the schema.

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

Purpose5/5

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

The description uses a specific verb-object pair — 'Apply for Standard Financial Statement Certificate' — that matches the Korean title and precisely identifies the resource. With many hometax__certificate__apply__* siblings (business_registration, tax_payment_record, vat_standard, etc.), naming the exact certificate type is sufficient differentiation.

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 description states a hard prerequisite ('REQUIRES prior hometax__session__login call with same account_link_id') and a mandatory two-phase workflow: preview first, retry with confirm=true, plus the rule 'Never set confirm=true on your own.' It does not explicitly name alternatives or when-not-to-use conditions relative to sibling apply tools, so it falls short of a full 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