Skip to main content
Glama

Suggest callable places

suggest_places

Return candidate US businesses to phone for a natural-language request (for example, booking a restaurant or asking a shop a question). Each result carries the venue name, a dialable phone number, why it fits, and a ready-to-send brief. Reads place data only; places no call. An answered request is billed against the same credit balance calls use; a request that returns no candidates or is refused is not. Three fields qualify the answer itself: degraded says it is weaker than a full one and degradation_reason names how, from a set that grows over time — among them a part of the request that cannot be true of any business, dropped before searching, so that the candidates answer what is left of it. short_list_reason answers a different question, why fewer candidates came back than were asked for: thin_pool when too few places qualified, curated when enough did and the ranking step kept only the best matches.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoThe most candidates to return, from 1 to 6. Omitted, up to 4 come back, or up to 6 for a niche request.
queryYesThe request in plain language: what is wanted, where and when, for example a quiet Italian restaurant in Chicago for four on Saturday at 8pm. 1 to 500 characters.
location_hintNoA neighbourhood, city or ZIP code to search in, up to 200 characters. A place named in the query takes precedence over this hint. A request for somewhere nearby that names no place in either is refused.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / properties / limit / description
      Added value: +"The most candidates to return, from 1 to 6. Omitted, up to 4 come back, or up to 6 for a niche request."
    • addedInput schema / properties / location_hint / description
      Added value: +"A neighbourhood, city or ZIP code to search in, up to 200 characters. A place named in the query takes precedence over this hint. A request for somewhere nearby that names no place in either is refused."
    • addedInput schema / properties / query / description
      Added value: +"The request in plain language: what is wanted, where and when, for example a quiet Italian restaurant in Chicago for four on Saturday at 8pm. 1 to 500 characters."
  2. First observed

TDQS

A4.4/5.0
Behavior5/5

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

Adds substantial context beyond the annotations: it discloses that successful answers are billed against the same credit balance calls use while empty or refused requests are free, and it explains the degraded/degradation_reason/short_list_reason output semantics with concrete enum-like values. readOnlyHint=false is consistent with the stated billing side effect rather than contradicted by 'reads place data only'.

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?

Purpose and the read-only/no-call constraint are front-loaded in the first two clauses, and every sentence carries information. The final sentence is dense and meandering ('a set that grows over time — among them a part of the request that cannot be true of any business'), which costs some clarity.

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

Completeness5/5

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

With no output schema, the description correctly takes on the burden of describing the return payload (venue name, dialable number, fit rationale, ready-to-send brief) plus billing and degraded/short-list semantics. An agent has everything needed to call it and interpret the response.

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 limit, query, and location_hint including precedence rules and character limits. The description adds no parameter-level detail beyond that, so the baseline 3 applies.

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?

Names a specific verb and resource ('Return candidate US businesses to phone') and immediately clarifies it is a discovery step, not a calling step: 'Reads place data only; places no call.' That last clause cleanly separates it from the sibling place_call without the reader opening either schema.

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

Usage Guidelines4/5

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

Gives concrete triggering examples ('booking a restaurant or asking a shop a question') and implies this precedes an actual call, which routes the agent away from place_call. It never explicitly names place_call or states when-not to use this tool, so it stops short of full alternative routing.

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.