Skip to main content
Glama

APICK Business

건축물대장 조회

bldrgst
Read-only

Look up a Korean building register by parcel number or lot address. PNU 또는 시군구·법정동·번지로 표제부·총괄표제부·기본개요·층별개요·전유부·전유공용면적·주택가격·오수정화시설·부속지번·지역지구구역을 조회합니다. PNU(19자리) 또는 sigunguCd·bjdongCd 중 하나가 필요합니다. [호출당 30포인트]

Input Schema

NameRequiredDescriptionDefault
jiNo부번 (기본 0000)
bunNo본번. 숫자만 보내면 4자리로 채웁니다.
pnuNo필지고유번호 19자리. 주면 번지 항목은 무시합니다.
hoNmNo호 이름. floor·expos·area·price 전용
typeNo대장 종류 (기본 title)
flrNoNo층 번호. area 전용. 지하는 음수
dongNmNo동 이름. floor·expos·area·price 전용
pageNoNo쪽 번호 (기본 1)
endDateNo대장 생성일 범위 끝. title·recap 전용. 연·월만 보내면 그 달 마지막 날로 맞춥니다.
bjdongCdNo법정동코드 5자리 (pnu 가 없을 때)
platGbCdNo0 대지(기본), 1 산. 대지·산·임야 표기도 받습니다.
numOfRowsNo한 쪽 건수 (기본 20, 최대 100)
sigunguCdNo시군구코드 5자리 (pnu 가 없을 때)
startDateNo대장 생성일 범위 시작. title·recap 전용. 2024 / 2024-06 / 20240101

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnlyHint and openWorldHint, so the safety profile is covered. The description adds two things annotations cannot: a per-call cost of 30 points and the precedence rule that supplying PNU causes bunji fields to be ignored. Those are material behavioral facts for planning a call.

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?

Three short sentences, front-loaded with the purpose and then the input requirement and cost. No filler or repetition, though the enumeration of ten register types is dense and could arguably be left to the enum.

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 14-parameter lookup with no output schema and read-only annotations, the description covers purpose, required inputs, type-scoping, and cost. It stops short of describing the shape of the returned register records, but the type enumeration and annotations make it usable as-is.

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%, so the schema already documents all 14 parameters including type-specific fields. The description restates the PNU (19-digit) vs sigunguCd·bjdongCd requirement but adds no format or syntax detail beyond what the schema provides, so baseline 3 applies.

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?

States a specific verb (look up) and resource (Korean building register) and enumerates the ten register types matching the `type` enum, so the agent knows exactly what is returned. It does not name any sibling to contrast with, but the resource is distinct enough from tools like registry_realestate_search or land_rt_price to avoid confusion.

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?

The description gives the required input combination (PNU or sigunguCd·bjdongCd) and the address-based path, which is genuine usage context. However, it never says when to prefer this over alternatives such as registry_realestate_search or land_rt_price, so selection guidance is only implied.

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.