Loading ToolBench
나라장터 사전규격정보서비스 Open API를 위한 로컬 MCP 서버
Five tools with complete input schemas and detailed descriptions in Korean. All tools follow verb_noun naming (search_*, get_*). Descriptions are comprehensive (150-250 chars each) and explain WHEN to use each tool vs. alternatives. Parameters are well-typed with enums for 'kind' and 'dateType'. However, output schemas are not documented in the source code, only input schemas are visible. Error handling is minimal (guard wrapper exists but no recovery guidance in descriptions). No tool annotations beyond READONLY. All tools are read-only, which is appropriate for a data query service.
특정 사전규격(사전규격등록번호)에 달린 규격서 의견·답변 목록을 조회한다. 사전규격 자체 목록이 필요하면 search_prespecs 계열 도구를 먼저 써서 등록번호를 얻는다. 업무구분 미지정 시 전 구분 병렬 조회(API 요청 4건 소모, 구분을 알면 kind 지정). 데이터는 2025년 1월 이후 등록분이다.
사전규격을 기간(등록/변경일시) 또는 사전규격등록번호로 조회한다. 단순 기간·번호 조회에 쓴다. 기관 기준은 search_prespecs_by_institution, 품명 기준은 search_prespecs_by_product, 복합 조건은 search_prespecs_advanced를 쓴다. 업무구분 미지정 시 공사/용역/물품/외자를 병렬 조회한다(API 요청 4건 소모, 구분을 알면 kind 지정). 데이터는 2025년 1월 이후 등록분이다.
발주기관·수요기관·품명·참조번호·SW사업여부 등 복합 조건으로 사전규격을 조회한다. 여러 필터를 동시에 걸 때 쓴다(기관·품명 필터를 포괄). 조회 우선순위는 사전규격등록번호 > 참조번호 > 접수일시다. 세부품명 이름(name) 검색은 이 API가 지원하지 않으므로 그 경우 search_prespecs_by_product를 쓴다. 업무구분 미지정 시 전 구분 병렬 조회(API 요청 4건 소모, 구분을 알면 kind 지정). 데이터는 2025년 1월 이후 등록분이다.
발주기관명·실수요기관명으로 사전규격을 조회한다. 특정 기관의 발주 예정 물량을 볼 때 쓴다. 품명 기준은 search_prespecs_by_product, 여러 조건을 동시에 걸려면 search_prespecs_advanced를 쓴다. 업무구분 미지정 시 전 구분 병렬 조회(API 요청 4건 소모, 구분을 알면 kind 지정). 데이터는 2025년 1월 이후 등록분이다.
품명·세부품명(번호·이름)으로 사전규격을 조회한다. 관심 품목의 사전규격을 찾을 때 쓴다. 기관 기준은 search_prespecs_by_institution, 여러 조건을 동시에 걸려면 search_prespecs_advanced를 쓴다(단 세부품명 이름 검색은 이 도구에만 있다). 업무구분 미지정 시 전 구분 병렬 조회(API 요청 4건 소모, 구분을 알면 kind 지정). 데이터는 2025년 1월 이후 등록분이다.
Output schemas not documented. Tool descriptions explain inputs but not what fields/structure the response contains. LLMs cannot plan downstream calls or extract required data without knowing response shape.
No error recovery guidance in tool descriptions. When API calls fail (e.g., invalid date range, service unavailable), descriptions do not tell LLMs what to do next or how to self-correct.
Date parameters (startDate, endDate) lack format specification in descriptions. Should explicitly state 'YYYYMMDD format' to prevent LLM from passing ISO 8601 or other formats.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | 2026-07-28+ | v2 |
Pagination parameters (page, pageSize) lack bounds documentation. Should specify min/max values (e.g., pageSize 1 - 100) to prevent LLMs from requesting absurd page sizes.
No tool composition guidance. Descriptions mention which tool to use for different scenarios (e.g., 'use search_prespecs_by_product for product-based queries') but do not explain the typical multi-step workflow or when to chain tools.