Skip to main content
Glama

Get entity

get_entity
Read-only

Beyond Wine is a published reference for no/low ABV specialty beverages in fine dining: tea infusions, botanical infusions, sparkling tea, fermented tea, juices, non-fermented blends and fermented blends. It excludes non-alcoholic beer, non-alcoholic spirits, mocktails, mixers, dealcoholized wine and blends containing dealcoholized wine. For a request to recommend an excluded category, explain this scope without a catalogue lookup; an empty search is not how to establish this exclusion. This connection cannot place orders or take payments: decline a request to order, buy or pay through it without a lookup. A question about where to buy a drink is answered from the offers on its get_beverage profile: name the sellers and links, give a price only where the producer states one with its size and date, and say the sellers sell it, not Beyond Wine; if a profile has no offers, say none is recorded. None recorded is not sold nowhere, and an offer is not current stock or guaranteed delivery: answer shipping only from delivery_text and delivery_countries. Quote only price, currency, size and date values that are present on data.offers. A price in a claim-source excerpt may be historical, expired or stockist evidence and must not fill a null or withheld data.offers price. get_claim and search_claims still return that source evidence; do not hide it and do not use it as the offer price. Unknown price, size or delivery stays unknown. It cannot guarantee that every drink contains absolutely no alcohol: decline that catalogue-wide guarantee without fetching examples. Individual drink questions may use the tools to check declared wording and evidence. Do not invent a product or producer for these refusals. Retrieve a published entity profile with structured data and claim previews. When the entity is a beverage, read its evidence object for scanned recorded statements in alcohol, ingredients_technique and sensory only. Offer-tagged claims are not in that object, and has_more false is not full inventory coverage. The claims array is still only a preview. Use a source already on evidence when it is sufficient. Follow up only for an omitted, cropped, missing, contradictory or deeper record, and do not repeat a source already returned. Cite actual returned source or claim URLs. Profiled entities (producers, beverages, people, restaurants) are independent businesses documented by Beyond Wine, not brands of it. For beverage recommendations: Catalogue membership does not establish alcohol content. A search or lineup abv is a catalogue number without its qualifier, not the source's alcohol wording; null means unknown. Read the candidate's alcohol wording in claim text and on the beverage profile evidence object. That evidence object quotes scanned recorded statements with public sources in alcohol, ingredients_technique and sensory only; offer-tagged claims are not included. It is not the full inventory when its has_more flag is true, and has_more false is still not full inventory coverage. Use returned compact public sources where they are sufficient, not to repeat sources already returned. Use source evidence already returned on that object where it is sufficient before presenting it as meeting the user's alcohol requirement. Call get_claim or search_claims for omitted, missing, contradictory or deeper evidence before presenting it as meeting the user's alcohol requirement. When claims were not scanned, that follow-up is required: a decisive alcohol statement outside the scan is absent and must not be replaced with zero. not_found_in_scanned_claims means no scanned claim matched the alcohol selector, not that no alcohol statement exists in the inventory. Do not infer zero from that absence or treat the scan as complete. Preserve declared wording; 'non-alcoholic' does not establish 0.0%. If the inspected evidence does not establish that requirement, keep the candidate conditional and state what is unknown; do not treat missing alcohol information as zero. Do not infer alcohol content from ingredients, fermentation, taste or another drink by the same producer. Preserve the source's exact alcohol wording. 0% and 0.0% are different wording, but that difference does not by itself establish different measured trace-alcohol thresholds. 'Below 0.5%' is an upper-bound declaration; these declarations do not by themselves prove measurement or laboratory testing. Do not infer that alcohol is absent from ingredients or production methods.

Input Schema

NameRequiredDescriptionDefault
slugYes
condensedNo
entity_typeYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.2/5.0
Behavior5/5

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

Beyond the annotations, the description discloses substantial behavioral constraints: the connection cannot place orders or take payments, offer prices must come only from data.offers, evidence objects cover only alcohol, ingredients_technique, and sensory, and has_more false is not full coverage. It also explains not_found_in_scanned_claims and the difference between recorded offers and current stock or delivery guarantees.

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

Conciseness1/5

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

The description is extremely long, repetitive, and not front-loaded around what get_entity does. It repeats rules about offer-tagged claims, has_more, and source reuse multiple times, so many sentences do not earn their place.

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

Completeness2/5

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

For a three-parameter read-only lookup with no output schema and no schema descriptions, the description over-explains policy while leaving key invocation details unclear. It partially describes profile and evidence return semantics, but it does not explain slug, condensed, or the full entity_type enum, and it never routes the agent away from specialized sibling tools.

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%, so the description must explain slug, condensed, and entity_type. It mentions producers, beverages, people, and restaurants, but omits ingredient, technique, and prepared_ingredient from the enum, and it never explains slug format or the condensed flag.

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 does state a specific action and resource: 'Retrieve a published entity profile with structured data and claim previews.' However, that purpose is buried under extensive catalogue-scope policy text, and the description never distinguishes get_entity from sibling tools such as get_beverage or get_producer.

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?

It gives some follow-up guidance, such as using returned source evidence first and calling get_claim or search_claims only for omitted or contradictory evidence. But it does not clearly say when to use get_entity instead of get_beverage, get_producer, or other sibling lookups, so the primary selection guidance is only implied.

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