Skip to main content
Glama

소득 증빙서류 통합발급 인증 요청

req_income_cert_bundle

소득 증빙서류 통합발급을 위한 본인 간편인증을 요청합니다. 승인 한 번으로 담긴 증명 2종을 차례로 발급합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_income_cert_bundle에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P]

Input Schema

NameRequiredDescriptionDefault
nameYes본인 이름
yearYes귀속연도 4자리 (최근 5년, 예: 2025)
emailNo수령 이메일 (선택, 생략 시 회원정보)
phoneYes본인 명의 휴대전화 번호 (숫자만)
fax_noNo팩스번호 (delivery=04 일 때 필수)
formatNo응답 형식 (pdf=PDF base64만·json=PDF를 읽은 값만·both=둘 다, 생략 시 both). 대화형 사용은 응답이 작은 json 을 권장
deliveryYes교부방법 (06 프린터·10 화면·04 팩스·12 전자문서지갑). 문서는 응답으로 받으므로 보통 06
quantityNo발급 희망 수량 (1~5, 생략 시 1)
birthDateYes생년월일 8자리 (YYYYMMDD)
submit_toYes제출처 코드 2자리 (예: 99 기타)
use_purposeYes사용용도 코드 2자리 (예: 99 기타)
authProviderYes휴대폰에서 승인할 간편인증 방식
resno_open_ynNo주민등록번호 공개 여부 (Y/N)
amount_open_ynNo소득금액증명 금액 공개 여부 (Y/N)
wallet_addressNo전자문서지갑 주소 (delivery=12 일 때 필수)
address_open_ynNo주소 공개 여부 (Y/N)
income_source_open_ynNo소득금액증명 소득발생처 공개 여부 (Y/N)
withholding_all_print_ynNo소득금액증명 원천징수의무자 전체 표시 (Y/N)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.5/5.0
Behavior5/5

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

Goes well beyond the annotations by disclosing cost side effects (휴대폰 알림 발송, 접수 과금, 인증 발송 성공 시 20P), the required user-consent gating, and the retry hazard during pending approval. Annotations only say non-readonly, non-idempotent, open-world; the description supplies the operational consequences an agent actually needs.

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?

Front-loaded with the core action and the follow-up path packed into the first two sentences, then constraints. The billing note in brackets at the end is slightly tacked-on, but every sentence carries operational weight for an 18-parameter, billable mutation.

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?

No output schema, but the description compensates by naming the returns (transactionId, status) and the pending-approval state. The main remaining gap is that the 'two certificates' are never named (e.g. 소득금액증명), which matters for a bundled issuance tool.

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% with all 18 parameters documented inline, including enums and conditional requirements, so the description adds no per-parameter meaning. Baseline 3 applies; nothing in the description explains field semantics 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?

States a specific verb (요청) and resource (소득 증빙서류 통합발급 본인 간편인증) and makes the scope concrete: one approval issues two bundled certificates. It also explicitly points to the sibling get_income_cert_bundle as the follow-up step, so an agent can separate the request phase from the retrieval phase without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit preconditions (사용자 확인 후 호출), explicit prohibitions (승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요), and the exact handoff rule (승인 후 get_income_cert_bundle에 transactionId를 전달하세요). The when-to-use and when-not-to-use conditions are both spelled out.

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.