Skip to main content
Glama

APICK Business

부동산 등기 열람·발급

registry_realestate_jobs_create
Idempotent

View and issue a real estate registry certificate in one call. 검색 결과의 대상을 지정하면 결제와 PDF 확보를 같은 호출에서 끝내고 PDF 를 돌려줍니다. 최대 180초까지 걸릴 수 있습니다. 열람(view) 850P, 발급(issue) 1250P(PDF 전송 포함). 실패하면 포인트는 차감되지 않습니다. 이미 발급한 PDF는 응답 헤더 X-Apick-Job-Id 를 job_id 로 POST /rest/registry_jobs/:job_id/download 에 보내 다시 받을 수 있습니다(건당 30P, 횟수 제한 없음). [호출당 850포인트]

Input Schema

NameRequiredDescriptionDefault
pinNo부동산고유번호 14자리(선택)
indexNo검색 결과 행 번호(1부터), 기본 1
queryNo검색에 사용한 주소 또는 부동산고유번호
usageNo열람(view)·발급(issue) 등, 기본 view
record_scopeNo전부(all)·일부(part), 기본 all
idempotency_keyNo중복 결제 방지 키. 같은 키로 다시 호출하면 기존 작업의 PDF를 받습니다
include_cancelledNo말소사항 포함 여부, 기본 true
publish_resident_noNo주민등록번호 공개 여부, 기본 false

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / idempotency_key / description
      Previous value: -"중복 접수·과금 방지 키"New value: +"중복 결제 방지 키. 같은 키로 다시 호출하면 기존 작업의 PDF를 받습니다"
  2. Added

TDQS

A4.3/5.0
Behavior5/5

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

Beyond the annotations, it discloses key behavior: calls can take up to 180 seconds, pricing differs for view and issue, failures do not deduct points, PDFs are returned, and previously issued PDFs can be re-downloaded via job_id for 30P. This adds substantial operational context without contradicting the 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?

The purpose and key constraints are front-loaded, and most sentences carry useful operational detail. There is some redundancy, especially the final '[호출당 850포인트]' alongside the separate view/issue pricing, but the structure remains efficient overall.

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 complex paid job-creation tool with no output schema, it explains the return value (PDF), timing, pricing, failure billing behavior, idempotency, and re-download path. It does not explicitly document sibling routing or error shapes, but it is largely complete for correct invocation.

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 coverage is 100%, so the schema already explains all eight parameters including usage, index, and idempotency_key. The description adds pricing meaning for the view/issue usage values, but does not add parameter-level guidance for most inputs beyond what the schema provides.

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 states a specific action and resource: viewing/issuing a real estate registry certificate in one call. It also distinguishes the workflow by indicating the target comes from search results, separating it from the search sibling.

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 clearly establishes when to use the tool: after selecting a target from search results, to perform view or issue and obtain a PDF. It does not explicitly name sibling alternatives or exclusions such as corporate registry jobs, but the context is strong enough to guide selection.

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.