Skip to main content
Glama

TopFood

by app.topfood

Report a problem with TopFood

report_problem

Sends a bug report or product feedback about TopFood to the maintainers. Use it when a tool call fails unexpectedly, when the published menu is wrong or incomplete, or when the restaurant owner tells you something is broken or missing. Do NOT use it for input that a tool already rejected with a clear explanation — fix the input and retry instead. Describe what was attempted, what happened, and what was expected. Reports are read by people and there is no reply channel: tell the user the report was sent, and that they should include an email address in the message if they want an answer.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
messageYesWhat happened, what was expected, and what the user was doing. Write it for a developer who cannot see this conversation. Include the user's own words when they reported it.
categoryYesbug = something is broken; missing_feature = something the user needs does not exist; confusing = it works but was unclear; pricing = about plans or cost; other = anything else.
claim_urlNoThe claim link returned by create_restaurant_menu, when the report is about a menu that was created in this conversation. It attaches the report to that restaurant.

TDQS

A4.8/5.0
Behavior5/5

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

Annotations are all false and minimal, so the description carries the burden. It discloses that reports are read by people, there is no reply channel, and the user should be told the report was sent. It even advises including an email address for a response. This is rich behavioral context beyond annotations.

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?

The description is three sentences, each earning its place: first defines purpose, second gives usage rules, third explains human-read behavior and follow-up steps. It is front-loaded and free of fluff.

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 3-parameter tool with no output schema and sparse annotations, the description covers purpose, usage, behavioral notes, and user-facing instructions. It doesn't explicitly state the return value, but the instruction to tell the user the report was sent implies the outcome. Minor gap: no mention of idempotency or retry behavior, but not essential here.

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 description coverage is 100%, so baseline is 3. The description adds value by instructing what to include in the message ('what was attempted, what happened, what was expected') and advising to include an email address, which enriches the meaning of the message parameter without repeating schema details.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Sends a bug report or product feedback about TopFood to the maintainers.' It clearly distinguishes from the sibling tool create_restaurant_menu, which is about creating menus rather than reporting issues.

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

Usage Guidelines5/5

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

Explicit when-to-use scenarios are listed ('when a tool call fails unexpectedly', 'published menu is wrong', etc.) and a direct exclusion is given: 'Do NOT use it for input that a tool already rejected with a clear explanation — fix the input and retry instead.' This provides strong decision guidance.

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

All TopFood toolsInspect
Try in Browser
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.4/5.0
Disambiguation5/5

The two tools have clearly separate purposes: one creates a restaurant menu and the other reports platform issues. There is no overlap or ambiguity in choosing between them.

Naming Consistency5/5

Both tool names use the same snake_case verb_noun pattern: create_restaurant_menu and report_problem. Naming is consistent and predictable.

Tool Count3/5

With only two tools, the server feels very thin, but each tool serves a distinct role: one primary domain operation and one generic feedback channel. It is borderline but not unreasonable for such a narrow purpose.

Completeness2/5

The domain surface only supports creating a menu; there are no tools to list, update, retrieve, or delete menus. Common lifecycle actions would cause obvious agent failures, and the report_problem tool is only a manual fallback rather than a real management operation.

Resources