morocco-travel

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

The annotations already declare readOnly, idempotent, and non-destructive behavior, so the description's additional value is in revealing the response structure and the intended downstream workflow. It makes clear that the tool returns an index rather than full content, which is meaningful behavioral context.

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

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

Two short sentences deliver the core definition, the fields returned, and a practical usage tip. There is no filler or repetition.

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

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

For a zero-parameter, read-only index tool with no output schema, the description supplies the essential return fields and tells the agent how to access the full content. Nothing critical is missing for correct invocation.

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

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

The tool has zero parameters and the schema is fully covered, so the baseline of 4 applies. The description adds useful context about what the returned entries contain even though no parameters need explanation.

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

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

The description clearly identifies the tool as an index of published city guides and states the exact fields each entry contains: a page URL and a markdown URL. It is specific about the resource and distinct from vague or tautological wording.

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

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

The description provides clear context: this is the index of guides, and the markdown URL should be fetched for full text rather than scraping the page. It does not explicitly compare this tool to siblings, but the role is evident enough that an agent can select it appropriately.

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

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

Annotations already establish read-only, idempotent, non-destructive behavior. The description adds valuable behavioral context by revealing the reliability flag and instructing the agent to disclose when a date has not been held every year, which goes beyond what annotations convey.

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

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

The description is two sentences with no filler. The first sentence front-loads the purpose and output contents, and the second sentence adds an essential reliability caveat and user-facing instruction.

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

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

This is a simple read-only tool with one optional parameter and no output schema. The description enumerates what is returned—site, city, Hebrew date, reliability—and the schema covers the limit parameter, so an agent has enough information to invoke and interpret the result correctly.

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

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

The schema fully documents the only parameter, limit, including its default and bounds, so the description does not need to add parameter detail. The description does not mention limit at all, but the high schema coverage keeps this at the baseline rather than below it.

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

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

The description clearly identifies the resource: upcoming hilula dates at tombs of Moroccan tzadikim, and lists the included output fields. However, it is phrased as a noun phrase rather than using an explicit verb like 'lists' or 'retrieves', so it does not fully meet the 'specific verb+resource' bar.

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

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

The 'next hilula dates' wording makes the tool's use case clear, and none of the sibling tools overlap with hilulot, so no alternative routing is needed. It does not explicitly state exclusions or when not to use the tool, but the context is sufficient for selection.

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

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

Annotations already cover readOnly, idempotent, and non-destructive behavior, so no safety disclosure is needed. The description adds useful behavioral context by guaranteeing the ids are exact and by enumerating the fields they belong to, even though it does not detail the output structure.

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

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

Two sentences with no redundancy. The core value proposition comes first, and the usage instruction is front-loaded in the second sentence.

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

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

For a zero-parameter, read-only lookup with no output schema, the description is complete: it says what is returned, which fields are covered, and when to call it. No relevant operational detail is missing.

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

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

The tool has zero parameters and the schema is empty with 100% coverage, so there is no parameter documentation burden. The description adds value by naming the semantic dimensions (cities, who, style, vibes, pace, kosher, shabbatCity) that the returned vocabulary covers.

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

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

The description clearly states that the tool provides the exact ids plan_trip accepts for seven named dimensions, making its purpose concrete and unambiguous. It distinguishes itself from sibling content tools by explicitly tying it to plan_trip as a prerequisite lookup.

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

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

It gives an explicit invocation instruction: 'Call this before plan_trip rather than guessing an id.' This tells the agent exactly when to use the tool and why, and implies that it is a helper rather than a standalone planning tool.

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

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

The description adds important behavioral context beyond the annotations: the `source` field can be `fallback`, meaning times are a saved snapshot, and the agent must explicitly say so. This discloses a non-obvious reliability characteristic that the readOnly/idempotent annotations do not convey.

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

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

The description is two concise sentences, with the core resource and scope front-loaded, followed by the essential fallback caveat. There is no filler or repetition of structured data.

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

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

For a parameterless, read-only lookup tool with annotations covering safety, the description is complete: it states the cities, the time period, the returned content (candles, havdalah, parasha), and the critical fallback behavior. No output schema exists, so the description adequately carries the information an agent needs.

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

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

The tool has zero parameters and the schema is an empty object, so the description cannot add parameter-level meaning. The baseline of 4 applies because there are no parameters to document, and the description instead clarifies the output semantics tied to the `source` field.

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

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

The description names the exact resource (candle lighting and havdalah times), the time scope (current week), and the geographic scope (six specific Moroccan cities), plus the parasha. This clearly distinguishes it from siblings like get_hilulot or get_city_guides, which cover different content.

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

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

Usage context is implied: it is the tool for current-week Shabbat times in the listed Moroccan cities. However, it gives no explicit when-to-use or when-not-to-use guidance, and does not mention alternatives or exclusions, so an agent must infer when this is the right choice.

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

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

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so the safety profile is covered. The description adds that the tool includes 'rules to respect' and 'other machine-readable surfaces,' which is mildly useful context but not a full behavioral disclosure.

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

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

The description is one efficient sentence plus a direct call-to-action. It front-loads the purpose and avoids redundancy, though the phrasing is slightly vague and could be tightened with more concrete terms.

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

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

Given zero parameters, a read-only/idempotent annotation profile, and no output schema, the description covers the essential purpose and when to call it. It could say more about what kind of answer the agent will receive, but it is adequate for a meta-orientation tool.

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

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

The tool has zero parameters and the schema is an empty object with 100% coverage, so there are no parameter semantics for the description to explain. The baseline of 4 applies here.

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

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

The description states that the tool returns an overview of what the site does, which services are available, and rules to respect. This gives agents a clear sense of the resource being described, though it does not use a direct verb like 'returns' and is somewhat abstract.

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

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

'Call this first if you are unsure whether this site can answer the question' gives explicit guidance on when to invoke it. It does not mention alternatives or exclusion conditions, but the instruction is actionable and sufficient for routing decisions.

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

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint=false, so the safety profile is covered. The description adds useful behavioral context beyond that: it only provides information and must not be used to submit an application on someone's behalf, and it clarifies the VOA exclusion. This is meaningful added context, even though no system-side side effects are described.

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

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

The description is compact: two sentences front-load the returned data and close with a critical safety/eligibility rule. Every phrase carries useful information, though the first sentence is a dense comma-separated list that could be structured slightly more cleanly.

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

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

With no output schema, the description does the necessary work by enumerating the principal return fields and eligibility caveats. It is sufficient for an agent to select and invoke the tool correctly with zero parameters. The reference to 'both tracks' is not fully defined, which keeps this from being a perfect score.

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

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

The input schema defines zero parameters, so there are no parameter semantics for the description to clarify. The schema coverage is 100%, and the description correctly does not invent parameters. For a zero-parameter tool, the baseline of 4 applies.

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

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

The description makes it clear this is an informational lookup for Morocco e-visa costs and requirements for Israeli passport holders, enumerating the exact return fields: price in ILS, government fee, processing time, passport validity, and URLs. It is distinct from the sibling travel-content tools by its explicit visa scope, and the 'never apply on someone's behalf' line reinforces that this is not an application/booking action.

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

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

The description gives clear context: use this for Moroccan e-visa information for Israeli passport holders, and it explicitly warns that visa-on-arrival is not available to Israelis. It also states a hard boundary ('Never apply on someone's behalf'), though it does not name alternative sibling tools or provide a more explicit 'use this when...' formulation.

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

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint=false. The description adds meaningful behavior beyond that: the route is not saved, the tool is anonymous, the day count is honored exactly or explained, and the user should be sent to a questionnaire URL to persist or adjust the route. No contradiction with annotations.

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

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

Three sentences with no waste. The core promise and key constraints are front-loaded, and every sentence contributes operational guidance: what the tool produces, the fidelity guarantee, prerequisite tool usage, and non-persistence.

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

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

The description covers essential call context: valid id source, itinerary guarantees, and persistence semantics. However, with 10 parameters, no output schema, and several required free-text fields not explained, the agent is left uncertain about exact expected values for who, style, and vibes, as well as the precise return shape beyond the questionnaire URL.

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

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

The schema already describes pace, cities, kosher, duration, arrivalDate, and shabbatCity, covering 60% of parameters. The description adds useful semantics for cities ('Every city you list appears in the route') and duration ('the number of days you ask for is honoured exactly'). However, required fields like who, style, and vibes remain unexplained in both the schema and the description, leaving meaningful gaps.

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

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

The title and description clearly identify a route-building tool: 'Build a day-by-day Morocco route' and 'free, anonymous, day-by-day itinerary.' It is easily distinguished from the sibling lookup/search tools, which fetch city guides, options, shabbat times, visas, or site information rather than generating a personalized itinerary.

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

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

The description gives a concrete prerequisite: 'Use get_plan_options first for valid ids,' which tells the agent what must happen before calling this tool. It does not explicitly enumerate exclusions or alternative tools, but the planning-vs-lookup distinction among siblings makes the usage context reasonably clear.

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

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

Annotations already declare readOnlyHint=true, idempotentHint=true, and openWorldHint=false, covering the safety profile. The description adds important behavioral context beyond annotations: results contain Hebrew editorial copy and page URL by design, no booking link/price, and the agent should not seek the operator. This clarifies expected result content and prevents unnecessary actions.

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

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

Three concise sentences with front-loaded action and zero fluff. Every sentence adds value: what it searches, what it returns, and the critical no-booking-link/operator instruction.

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

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

With no output schema, the description does explain the key return values (Hebrew editorial copy and page URL) and the absence of booking/price fields. It is complete enough for an agent to invoke and render results, though it does not detail list shape or pagination beyond the schema's limit parameter.

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

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

Schema coverage is 100% with q, limit, and category all documented. The description adds no parameter-specific semantics beyond the schema, so the baseline of 3 applies. The only subtle addition is the catalog context, which does not clarify individual parameters.

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

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

The description clearly states the tool searches the catalog of day trips and attractions, and specifies what it returns (Hebrew editorial copy and page URL). This distinguishes it from general site search and other sibling tools by resource and content type.

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

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

The description gives clear context for when to use this tool (when needing day trips/attractions from the catalog) and adds an explicit 'do not go looking for the operator' instruction. It does not name sibling alternatives or exclusions, so it lacks the explicit when-not-to-use guidance for a perfect score.

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

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

Beyond the annotations (read-only, idempotent, non-destructive), the description reveals important behavior: results carry markdown URLs, full pages must be fetched rather than scraped, and Hebrew queries perform better. This materially changes how an agent should invoke and follow up on the tool.

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

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

Three sentences, each earning its place: scope, when to use it, and behavior/language guidance. The most important routing information is front-loaded, with zero filler.

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

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

For a search tool with only two well-documented parameters, a rich output schema, and safety annotations, the description covers scope, fallback usage, result handling, and search quality. Nothing essential is missing for an agent to decide when to call it and how to act on results.

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

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

Schema coverage is 100%, so the baseline is already 3. The description adds value by explaining that Hebrew queries 'match far more than English ones,' reinforcing the q parameter's language preference beyond the schema's 'preferably Hebrew.' The limit parameter is left to the schema, which is acceptable given its coverage.

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

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

The description names a specific verb ('Search') and a precise scope ('every published page') with a concrete enumeration of content types. It also differentiates itself from the specialized sibling tools by positioning itself as the general fallback.

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

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

The line 'Use this whenever the question is not covered by one of the specific tools' is an explicit when-to-use instruction, clearly routing the agent toward this tool versus the specialized siblings. However, it does not name the alternatives directly or give when-not-to-use exclusions beyond the general fallback framing.

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