Skip to main content
Glama

亞洲公仔扭蛋情報站

search_toys

搜尋亞洲扭蛋、盒玩、公仔、模型(中文或日文,例如 寶可夢、ちいかわ、鋼彈),回傳官方發售時期、價格、狀態(謠傳/官方公布/確定發售/已發售/再販/售完)、限量限定與來源。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
brandNo
limitNo
queryYes
statusNo
categoryNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3/5.0
Behavior3/5

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

With no annotations, the description carries the full behavioral burden. It does disclose meaningful return content (release period, price, status, limited-edition flag, source) and enumerates the status vocabulary, which substitutes for a missing output schema. However, it says nothing about permissions, rate limits, ordering, or what the limit parameter controls.

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?

A single front-loaded sentence pairs the action and scope with the expected return fields, with no filler. It is dense but every clause carries information; the only cost is that the parameter and return details are crammed together rather than separated.

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

Completeness3/5

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

For a read-only search with no output schema and no annotations, the description does describe the returned fields and status vocabulary, which is the most important gap to fill. It remains incomplete because four of five parameters (brand, category, limit, and the enum semantics) get no explanation and there is no note on result limits.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% across 5 parameters, so the description must compensate and largely does not. It hints at query language and enumerates the status values that map to one enum, but the brand enum values, category enum values, and especially the limit parameter's effect/pagination semantics are left entirely unexplained.

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 description opens with a specific verb (搜尋/search) and a concrete resource scope (Asian gashapon, blind boxes, figures, models), and even characterizes the searchable text as Chinese or Japanese. It does not explicitly distinguish itself from siblings like get_toy or latest_toy_news, so it stops short of a 5.

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

Usage Guidelines2/5

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

There is no explicit when-to-use or when-not-to-use guidance, and no sibling is named as an alternative. The only steering is the note that the query may be Chinese or Japanese with example titles (寶可夢, ちいかわ, 鋼彈), which implies content but not selection criteria.

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.

Resources