Skip to main content
Glama

카드 검토파일 반입 및 기관반영

vat__card__review__import_and_apply
Destructive

자격증명이나 로그인 없이 바로 호출할 수 있습니다. 회계사 카드 공제 검토 파일을 반입하고 기관 반영을 요청하며, 반영 결과는 같은 case_id 로 사건 조회(vat__case__get)를 불러 확인합니다. 호출마다 토큰 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>",
      "expected_revision": "<expected_revision>",
      "accountant_review_file": "<accountant_review_file>"
    },
    "name": "vat__card__review__import_and_apply"
  }
}

Input Schema

NameRequiredDescriptionDefault
case_idYes검토 파일을 반입할 부가세 준비 사건의 ID 입니다. 사건 생성(vat.case.create) 결과의 case_id 를 그대로 입력합니다.
confirmNo검토 결과를 기관에 반영하는 데 대한 사용자의 확인입니다. 사용자에게 반영할 내용을 확인받은 뒤 true 로 입력합니다. true 가 아니면 반영하지 않고 거절합니다.
expected_revisionYes사건의 지금 revision 입니다. 직전 작업 결과의 case_revision 을 그대로 입력합니다(새로 만든 사건은 1). 그 사이 사건이 바뀌었으면 거절하므로 사건을 다시 조회한 뒤 요청합니다.
human_binding_refNo검토 권한을 받은 구성원이 직접 요청할 때는 입력하지 않습니다. 이 사건의 검토 권한을 받은 구성원이 이 요청을 승인하고 받은 참조가 있을 때만 입력합니다. 승인한 요청 내용과 다르거나 유효기간이 지났으면 거절합니다.
accountant_review_fileYes회계사가 검토를 마친 카드 공제 검토 파일을 담은 객체입니다. format(REVIEW_XLSX 또는 OFFICIAL_XLS), filename, content_base64, sha256, source_original_sha256, review_scope(CARD_DEDUCTION), review_completed(true), basis_refs(근거 하나 이상), reason 을 입력합니다. REVIEW_XLSX 는 검토 파일을 내보낸 작업의 original_review_job_id 도 입력합니다.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare destructiveHint=true and readOnlyHint=false, and the description reinforces this ('순수 읽기 전용이 아닙니다'). Beyond that it adds real operational facts the annotations cannot convey: one token consumed per call, an XBOSS job created on processing, and the result being persisted and re-readable via the case. It is somewhat vague on what exactly gets overwritten at the institution ('도구별 실행 내용과 기존 확인 절차를 따릅니다'), which keeps it from a 5.

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 lead sentence about credential-free invocation is useful but front-loads a secondary fact ahead of the primary action. The trailing sentences about institutional data changes following per-tool execution content and existing confirmation procedures are boilerplate that adds little actionable information.

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, open-world tool with five parameters and no output schema, the description covers the essentials: cost, side effects, async job creation, and where to read the outcome. The remaining gap is that the exact effect on institutional data is deferred to vague per-tool procedures rather than described.

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%, and each parameter already carries a detailed Korean description including confirm gating, expected_revision staleness rejection, and human_binding_ref approval semantics. The prose adds little parameter-level meaning beyond restating that a review file is supplied, so the baseline 3 applies.

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 names a specific verb pair and resource: import an accountant's card-deduction review file (반입) and request institutional reflection (기관 반영). It also names the sibling used for verification (vat__case__get with the same case_id), so an agent can distinguish the write path from the read-back path without opening either schema.

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 a clear operational context — callable directly without credentials or login — and directs result verification to vat__case__get. It does not state explicit when-not-to-use conditions or contrast with any alternative import route, so it stops short of full routing guidance.

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