Skip to main content
Glama

부가세 단계 스냅샷 조회

vat__analysis__snapshot__get

자격증명이나 로그인 없이 바로 호출할 수 있습니다. 현재 부가세 분석 단계 결과 하나를 조회합니다. 거래와 문서 같은 큰 목록은 건수와 쪽 수만 돌려주고, 목록 이름과 쪽 번호를 지정하면 그 쪽의 내용을 돌려줍니다. 법인 일반과세자가 자기 회사의 부가가치세를 신고할 때 씁니다. 개인사업자, 간이과세자 신고와 세무대리인 신고는 아직 지원하지 않습니다. 로그인한 호출이면 첫 요청 전에 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": {
      "case_id": "<case_id>",
      "explain_stage": "<explain_stage>"
    },
    "name": "vat__analysis__snapshot__get"
  }
}

Input Schema

NameRequiredDescriptionDefault
case_idYes조회할 부가세 준비 사건의 ID 입니다. 사건 생성(vat.case.create) 결과의 case_id 를 그대로 입력합니다.
page_indexNo읽을 쪽 번호입니다. 1 부터 시작하고 입력하지 않으면 1 쪽입니다. 목록 이름을 입력할 때만 씁니다. 결과의 page_count 보다 크면 거절합니다.
explain_listNo쪽으로 나누어 읽을 목록의 이름입니다. 단계 조회 결과의 paged_lists 에 있는 이름을 그대로 입력합니다. 입력하지 않으면 단계 요약과 목록마다의 건수와 쪽 수를 돌려줍니다.
explain_stageYes조회할 분석 단계입니다. V01 부터 V12 가운데 하나를 입력합니다. 분석이 그 단계까지 실행되지 않았으면 거절합니다.
explain_snapshot_refNo이전에 받은 단계 결과의 snapshot_ref 입니다. 입력하면 단계 결과가 그때와 같을 때만 돌려주고 사건이 다시 분석되어 달라졌으면 거절합니다. 입력하지 않으면 지금 결과를 돌려줍니다.
request_idempotency_keyNo로그인한 호출에서 응답을 못 받은 같은 요청을 되찾을 때 쓰는 선택 값입니다. 쓰는 법은 도구 설명에 있습니다.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.7/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=false and openWorldHint=true, and the description correctly reinforces this by stating the call is not purely read-only and that it creates an XBOSS job and stores a result. It also discloses per-call token cost and the idempotency-retry semantics, which is real added value. However, the cost/job sentences are garbled concatenations ('호출마다 토큰 1소진 요청 처리 시 ...') that are hard for an agent to parse into a concrete rule.

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 opening line spends prime real estate on credential-free access rather than the tool's job, and several sentences are run-on or syntactically fused, which costs clarity. The trailing note about institution data changes following per-tool procedures and existing confirmation workflows is generic filler that does not change how the tool is invoked.

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 six-parameter, no-output-schema tool, the description covers the important gaps: paging protocol, snapshot_ref staleness rejection, stage-not-yet-run rejection, idempotency handling, and per-call cost. It does not sketch the returned structure at all, which leaves the agent reliant on the parameter docs to infer what a stage summary contains.

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 is 3, but the description adds genuine meaning beyond the schema on request_idempotency_key: create it before the first request, resend only to recover an unanswered request, use a fresh value for a new execution, unusable in anonymous trial mode, and distinct from the institution-level idempotency_key field. It also explains the coupling between explain_list and page_index in operational terms.

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 precise verb and resource: retrieve one current VAT analysis stage result, and it goes on to define the paging split between count/page-count summaries and named list pages. It is clearly distinguishable from an analysis-run tool, though it never names a sibling to route against, and the no-credentials sentence is placed ahead of the actual purpose.

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?

It gives an explicit eligible caller (a corporate general taxpayer filing its own VAT) and explicit exclusions (sole proprietors, simplified taxpayers, tax-agent filings are not yet supported), plus the precondition that the stage must already have been executed or the call is rejected. It stops short of naming a concrete alternative tool for the unsupported cases.

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