Skip to main content
Glama

증명서 PDF 다운로드

fourinsure__b1__certificate__history__pdf_download
Destructive

먼저 호출할 도구: fourinsure__session__login (같은 account_link_id). 기본으로는 출력할 수 있는 증명서 신청 건(접수번호, 상태, 날짜)을 미리 보여 주며 PDF 는 싣지 않습니다. 실제 PDF 를 결과 artifacts 로 받으려면 dry_run=false 와 confirm_download=true 를 함께 보내세요. 파일: PDF · 기관이 발급한 원본. 결과의 artifacts[] 에 실리고, 내려받기 링크(download_url)는 15분 동안 열리며 파일은 7일 동안 보관됩니다. 링크가 만료되면 결과의 job_id 로 xdata__job__result 를 다시 불러 새 링크를 받습니다. 로그인 없이 받은 결과는 함께 온 recovery_receipt 를 따로 보관했다가, 처음의 job_id 나 pack_run_id 와 함께 xdata__job__result 에 보내세요. 증표로는 그 결과 하나만, 원래 파일 보관 기간이 끝날 때까지 열 수 있습니다. 증표는 공개하지 마세요. 잃어버리면 가입해도 되찾을 수 없습니다. 나중에 로그인해도 증표는 그대로 쓰이고, 다른 결과는 열지 못합니다. 증표가 없으면 처음 계정과 같은 환경(데모 · 정식)에서만 결과를 읽을 수 있습니다. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "fourinsure__b1__certificate__history__pdf_download"
  }
}

Input Schema

NameRequiredDescriptionDefault
cvrc_noNo대상 증명서 신청 건을 고르는 접수번호.
dry_runNo기본 true(미리보기). 접수번호, 상태, 날짜만 돌려줍니다. 실제 PDF 를 결과 artifacts 로 받으려면 false 로 하고 confirm_download=true 를 함께 입력해 주세요.
account_link_idNo연동 ID(UUID v4). 선택 입력입니다. 비워 두면 서버가 API 키로 연동을 찾아 씁니다. 같은 기관에 인증서를 여러 개 연동했을 때만 직접 입력해 주세요. 기관마다 ID 가 다릅니다.
confirm_downloadNo기본 false. dry_run 을 false 로, 이 값을 true 로 함께 입력해야 실제 PDF 를 받습니다. 그렇지 않으면 미리보기만 합니다. 실제 PDF 를 받으면 발급 이력에 출력 처리 표시가 남습니다.
download_all_availableNo기본 false. true 이면 cvrc_no 하나가 아니라 출력할 수 있는 신청 건 전체를 대상으로 합니다.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / cvrc_no / description
      Previous value: -"Receipt number (접수번호) selecting which certificate application to act on."New value: +"대상 증명서 신청 건을 고르는 접수번호."
    • changedInput schema / properties / download_all_available / description
      Previous value: -"Default false. When true, acts on all printable applications instead of a single cvrc_no."New value: +"기본 false. true 이면 cvrc_no 하나가 아니라 출력할 수 있는 신청 건 전체를 대상으로 합니다."
    • changedInput schema / properties / dry_run / description
      Previous value: -"Default true (preview): returns the receipt number, status and dates only. Set false together with confirm_download=true to receive the actual PDF in the result artifacts."New value: +"기본 true(미리보기). 접수번호, 상태, 날짜만 돌려줍니다. 실제 PDF 를 결과 artifacts 로 받으려면 false 로 하고 confirm_download=true 를 함께 입력해 주세요."
  2. First observed

TDQS

A4.1/5.0
Behavior5/5

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

Annotations flag readOnlyHint=false and destructiveHint=true, and the description corroborates with detail beyond them: one token consumed per call, an XBOSS job is created and stored, the call is explicitly 'not purely read-only' even when the institution original is not queried. It further discloses link lifetime (15 minutes), file retention (7 days), recovery_receipt semantics for unauthenticated results, and an issuance-history print mark — far more than the annotations provide.

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 most actionable content (login prerequisite, preview default, how to get the PDF) is front-loaded, but the description then spends many sentences on recovery_receipt edge cases that apply only to unauthenticated callers and are partly repetitive ('logging in later still uses the same receipt'). The closing lines about XBOSS jobs and per-tool confirmation procedures are vague filler that dilutes the useful payload.

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?

There is no output schema, so the description correctly covers the return side: artifacts[] placement, download_url with 15-minute expiry, 7-day retention, and job_id-based re-fetch. Given the tool's complexity (auth, token cost, receipts), it is nearly complete, though it never states the shape of the default preview payload beyond naming three fields.

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; the description adds value by explaining the coupled semantics of dry_run and confirm_download (both must be set together or only a preview is returned) and the all-applications scope of download_all_available. It reinforces rather than merely repeats the schema, though it does not clarify cvrc_no selection rules when download_all_available=true.

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 definition names a specific verb and resource (certificate application PDF download) and states that the default behavior is a preview of receipt number, status, and date rather than a PDF. It is unambiguous about what the tool produces, though the core purpose is embedded under a prerequisite line about session login rather than being the opening statement.

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 concrete usage guidance: log in first with the same account_link_id, send dry_run=false plus confirm_download=true to get a real PDF, use download_all_available to target all printable applications, and re-call xdata__job__result with job_id when a link expires. It lacks explicit when-not-to-use guidance relative to sibling history tools (detail/list), but the operational conditions are clear.

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