Skip to main content
Glama

법인 등기 열람·발급

registry_corporate_jobs_create
Idempotent

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

Input Schema

NameRequiredDescriptionDefault
indexNo검색 결과 행 번호(1부터), 기본 1
usageNo열람(view)·발급(issue), 기본 view
biz_noNo사업자등록번호 10자리(corp_reg_no가 없을 때)
corp_reg_noNo법인등록번호 13자리
idempotency_keyNo중복 결제 방지 키. 같은 키로 다시 호출하면 기존 작업의 PDF를 받습니다

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.1/5.0
Behavior5/5

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

The description goes well beyond the annotations: it warns the call can take up to 180 seconds, that each job costs 850P including PDF delivery, that no charge is applied if the call fails before payment, and that a previously issued PDF can be re-fetched at 30P via the X-Apick-Job-Id header against the download endpoint. These are exactly the cost, latency and retry facts an agent needs before spending money on a purchase-like operation.

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 is front-loaded in the first sentence and the operational facts follow in a compact sequence. The trailing bracketed '[호출당 850포인트]' repeats the 850P already stated earlier, and the mixed English/Korean phrasing adds minor noise, but nothing else is wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a paid, potentially 180-second operation with no output schema, the description supplies the pricing, failure-charge policy, latency ceiling and the recovery path for retrieving an already-paid PDF. Combined with the fully documented schema, an agent has everything needed to call it correctly and to decide whether the cost is justified.

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 already 100%, so the baseline is 3, but the description adds real meaning: it frames the tool as keyed on 법인등록번호 and states that reusing the same call returns the existing job's PDF, which explains the idempotency semantics of idempotency_key more concretely than the schema does. `usage` (view vs issue) and `index` are left to the schema.

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 first sentence names a concrete verb pair (view/issue) and the resource (corporate registry certificate), and explains that everything is done in one call with a PDF returned. It never names or distinguishes the obvious sibling, registry_corporate_search, which is the workflow step that probably produces the `index` input, so an agent gets no explicit guidance on how it relates to that tool.

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

Usage Guidelines3/5

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

Usage is implied rather than stated: corp_reg_no is the primary identifier and biz_no is the fallback, and `index` picks a row from a prior search. There is no explicit statement of when to use this instead of registry_corporate_search or registry_realestate_jobs_create, and no exclusions or prerequisites, so an agent must infer the search-then-issue workflow.

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.