Skip to main content
Glama

버스 노선 검색

search_routes

Find bus routes by city code and route number, returning start and end stops plus first and last bus times and a routeId for related route tools.

Instructions

노선 번호로 버스 노선을 검색합니다. 기점·종점과 첫차·막차 시각(HH:MM)을 함께 돌려줍니다. 결과의 routeId는 다른 노선 도구에서 사용됩니다. 같은 번호라도 지역·유형별로 여러 노선이 나올 수 있습니다.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "cityCode": "<cityCode>",
      "routeNo": "<routeNo>"
    },
    "name": "search_routes"
  }
}

Input Schema

NameRequiredDescriptionDefault
routeNoYes노선 번호. 예: '106', 'M1'
cityCodeYeslist_cities로 얻은 도시 코드. 예: 25(대전)

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.4.0

TDQS

A3.8/5.0
Behavior4/5

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

어노테이션이 없어 설명이 행동 규범을 대부분 부담하는데, 반환 필드(기점·종점, 첫차·막차 HH:MM)와 routeId가 다른 도구에서 재사용된다는 연결 정보, 그리고 결과가 여러 건일 수 있다는 특성을 밝혀 충분한 가치를 더한다. 인증 요구나 호출 한도, 결과 개수 제한 같은 운영적 특성은 언급하지 않는다.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

네 문장 모두 정보를 담고 있으며 검색 대상이 첫 문장에 전면 배치되어 있다. 군더더기 없이 반환값, 도구 연결, 결과 중복 가능성 순으로 자연스럽게 이어진다.

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?

출력 스키마가 없음에도 반환 필드를 설명으로 보완했고, 2개 파라미터의 단순 조회 도구라는 복잡도에 비추어 필요한 정보가 대부분 갖춰져 있다. 결과가 없을 때의 동작이나 결과 개수·정렬 규칙은 빠져 있다.

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?

스키마 설명 커버리지가 100%여서 routeNo와 cityCode의 의미는 스키마가 이미 충분히 문서화한다. 설명은 '노선 번호로 검색'과 다중 결과 가능성만 덧붙이며, cityCode가 지역 구분에 어떻게 작용하는지와 같은 추가 해석은 제공하지 않는다.

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?

특정 동사(검색)와 자원(버스 노선)을 노선 번호 기준으로 명확히 밝히고, 반환되는 정보(기점·종점, 첫차·막차)까지 제시해 search_bus_stops 같은 정류소 기반 도구와 구분된다. 다만 get_route_info나 get_route_stops 같은 형제 도구를 직접 지목하지는 않는다.

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?

노선 번호를 알고 있을 때 사용한다는 맥락과, 같은 번호라도 지역·유형별로 여러 노선이 나올 수 있다는 기대치를 제시한다. 그러나 routeId를 얻은 뒤 어떤 도구로 넘어가야 하는지, 또는 get_route_info를 언제 대신 써야 하는지에 대한 명시적 대안 안내는 없다.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.