Skip to main content
Glama

AlgoTrips

Destination facts

destination_facts
Read-onlyIdempotent

Facts about a travel destination (a city or region) from the AlgoTrips destination guides: country, a short overview, what the full guide covers, and links to the guide and to plan a trip there when available. If the place is not found, it names close matches to try instead.

Input Schema

NameRequiredDescriptionDefault
placeYesA city or region, for example "Kyoto" or "Bali".

Output Schema

NameRequiredDescriptionDefault
nameNo
foundYes
guideNo
linksNo
countryNo
summaryNo
hasGuideNo
suggestionsNo
guideSectionsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description adds genuinely new context beyond that: the data source (AlgoTrips destination guides), the shape of the payload, and the not-found behavior of returning close matches — a non-obvious trait an agent would otherwise have to discover by failing.

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?

Two sentences with no filler; the resource and payload are front-loaded and the fallback caveat comes second, which is the right order. Slight density in the middle clause ('what the full guide covers') costs a little crispness but nothing is wasteful.

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?

For a one-parameter lookup with an output schema, this is complete: source, contents, availability qualifier ('when available'), and failure behavior are all stated. An agent can call it correctly, and interpret a miss, without reading anything else.

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?

With a single parameter at 100% schema coverage, the schema already documents 'place' with examples. The description restates the same domain ('a city or region') and implies the parameter can miss via the close-matches fallback, but adds no syntax, format, or matching-rule detail beyond the schema, so the baseline 3 applies.

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 names a specific resource ('Facts about a travel destination (a city or region)') and enumerates what is returned (country, overview, guide coverage, links), which is far more specific than the bare title. It does not explicitly contrast itself with siblings like plan_trip or my_trips, though the read-only lookup framing makes the distinction inferable.

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?

Usage is only implied: an agent can infer this is the lookup to call when it needs destination background before or instead of planning. There is no explicit 'use this when…' statement and no named alternative; the only routing guidance is the not-found fallback ('it names close matches to try instead'), which is helpful but concerns retry, not tool selection.

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