Skip to main content
Glama

Get one recall by agency and slug

get_recall
Read-only

Fetch the full Recall Canary record for a single U.S. federal recall, FSIS public health alert or CPSC safety warning (record_kind), given the agency and slug returned by search_recalls. Includes the hazard description, the affected product list with lot codes and UPCs, the recommended consumer action, distribution, the Recall Canary page URL to link when citing it (url), the agency's own notice (source_url), and the firm slug (firm.slug, with firm.page_url when the firm has a page) for search_recalls' firm filter. Also resolves preliminary agency press releases: an orphan, or a linked one that kept its own URL (its recalls in linked_recalls). Read-only.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "agency": "<agency>",
      "slug": "<slug>"
    },
    "name": "get_recall"
  }
}

Input Schema

NameRequiredDescriptionDefault
slugYesThe record slug from its URL, e.g. "acme-foods-peanut-butter". The 26-character ULID id is also accepted and resolves to what its URL shows (for a matched press release, often its recall).
agencyYesLowercase agency segment from the record URL: a search row's `agency` in lower case (`FDA_IRES` is `fda`). Part of the lookup key, not decoration: a correct slug under the wrong agency is a miss.

Output Schema

NameRequiredDescriptionDefault
idYes
urlYesThe Recall Canary page for this record (absolute, canonical): the plain-language page a reader can use. Link this when you cite the record.
firmNo
lateNoSince api 2.7.0. Null unless the recall is late: it began more than 184 days before listed_at, or it ended on or before the date its listed_at_basis names.
riskNoThe agency rating as the page shows it (for example "High risk" for an FDA Class I recall). Null where the page shows no risk line.
slugNo
datesNo
notesYesCaveats for this record, including the aggregator-lag and not-a-clearance statement.
titleYesAgency-published title. Never model-written. Show `display_title` when it is present; it is the plain title the page prints.
agencyYesKnown values: FDA, FDA_IRES, FSIS, CPSC, NHTSA, ADMIN.
reasonNoThe agency's own stated reason, not model-written.
statusNo
licenseYesAttribution and terms (DATA-LICENSE).
relatedNo
categoryNoKnown values: FOOD, DRUG, BIOLOGIC, DEVICE, COSMETIC, CONSUMER_PRODUCT, VEHICLE, AUTO_EQUIPMENT.
citationNoHow to cite this record: link `page_url` (the Recall Canary page a reader can use) and name `source_url` (the agency's own notice) as the source of record.
html_urlYesAbsolute URL of the human-readable page.
productsNo
severityNoKnown values: CRITICAL, MODERATE, LOW.
timelineNoDated steps of the record, in date order. Each step names who acted on that date. FDA labels: Company began the recall, Announced by the company, Added to FDA's Enforcement Report, Classified by FDA, In FDA's weekly enforcement report; then Listed on Recall Canary, Summary updated, Recall ended, Archived.
canonicalYesAbsolute URL of this representation.
firm_nameNo
listed_atNoSince api 2.6.0. The date the listing shows and sorts by; equals this record's search_recalls row. A recall's listing date is in dates.listed_at.
source_urlNoThe agency's own notice: the source of record. Name it beside `url` when you cite the record.
api_versionYes
descriptionNoFull agency description. FSIS: sanitized HTML; others: plain text. Sanitize or escape before display.
hazard_tagsYes
record_kindNoSince api 2.12.0. What kind of agency notice a recall record is: `recall`, an FSIS `public_health_alert` or a CPSC `safety_warning`; the last two are not recalls and are never rated. Null on a preliminary record. `record_type` is `recall` on all three; no filter selects by kind.
record_typeYes
snapshot_atYesISO-8601 UTC response-generation time, second precision. First key on purpose.
advisory_urlNo
ai_generatedYesProvenance: true where the field holds model-written text. Over-attributes on purpose.
distributionNo
published_atNoDeprecated: the stored pub_date.
display_titleNo
mcp_truncatedNoPresent only when a long list was cut to 25 for this response.
product_countNoThe true event scope, which may exceed products.length.
story_lead_idNoSet on a later record of a recall story; the lead it belongs to.
animal_productNoSince api 2.14.0. Whom an FDA product is for, from FDA's own signals (its veterinary center's V- recall number, or an Animal & Veterinary, Animal Feed or Pet Food product type), never from product names. `category` stays FDA's (pet food is FOOD). Null otherwise. Do not give an animal product human advice.
critical_flagsNoNHTSA-only in practice. An absent key means the agency did not state the flag. null for a withdrawn (RETRACTED) record.
identificationYesPage-derived identification: the products and codes the record names. Not a completeness guarantee; `partial` says when the list is incomplete, including when this response cut `products` to 25 (`mcp_truncated.identification_products`).
linked_recallsNo
press_releasesNo
story_lead_urlNo
units_affectedNo
consumer_actionNoThe "What to do" text. Null on a withdrawn alert. On a CPSC safety warning, CPSC's own Consumer Action (its instructions, not a remedy).
display_summaryNo
source_recall_idNoAgency key; a CPSC one can be stale.
remedy_supersededNoSince api 2.13.0. A later CPSC safety warning says this recall's remedy is no longer being provided: its page and its sentence that says so (verbatim, or null). `consumer_action` is then that warning's Consumer Action unless an operator pinned one. Null otherwise.
content_changed_atYesWhen the published content last changed.
products_truncatedNoTrue when `product_count` exceeds the length of `products`
agency_published_atNo
company_announced_atNo
company_product_listNoThe company's own list of the affected products, when the agency notice points to it instead of naming them. A product missing from `identification` may still be recalled: check this list.
display_summary_shortNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / animal_product
      Added value: +{
      +  "description": "Since api 2.14.0. Whom an FDA product is for, from FDA's own signals (its veterinary center's V- recall number, or an Animal & Veterinary, Animal Feed or Pet Food product type), never from product names. `category` stays FDA's (pet food is FOOD). Null otherwise. Do not give an animal product human advice.",
      +  "enum": [
      +    "pet-food",
      +    "animal-food",
      +    "animal-drug",
      +    "veterinary-device",
      +    null
      +  ],
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  2. Changed5 schema fields changed
    • changedInput schema / properties / agency / description
      Previous value: -"Lowercase agency segment from the record URL. Part of the lookup key, not decoration: a correct slug under the wrong agency is a miss."New value: +"Lowercase agency segment from the record URL: a search row's `agency` in lower case (`FDA_IRES` is `fda`). Part of the lookup key, not decoration: a correct slug under the wrong agency is a miss."
    • addedOutput schema / properties / citation
      Added value: +{
      +  "description": "How to cite this record: link `page_url` (the Recall Canary page a reader can use) and name `source_url` (the agency's own notice) as the source of record.",
      +  "properties": {
      +    "page_url": {
      +      "description": "The Recall Canary page; the same value as `url`.",
      +      "type": "string"
      +    },
      +    "publisher": {
      +      "description": "Who publishes `page_url`: Recall Canary, an aggregator, not the agency.",
      +      "type": "string"
      +    },
      +    "source_of_record": {
      +      "description": "The issuing agency by name. Null for a record no agency issued.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "source_url": {
      +      "description": "The agency's own notice; the same value as the record's `source_url`. Null where the agency gave none.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "page_url",
      +    "source_url",
      +    "publisher",
      +    "source_of_record"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / source_url / description
      Previous value: -"The agency's own notice."New value: +"The agency's own notice: the source of record. Name it beside `url` when you cite the record."
    • changedOutput schema / properties / title / description
      Previous value: -"Agency-published title. Never model-written."New value: +"Agency-published title. Never model-written. Show `display_title` when it is present; it is the plain title the page prints."
    • addedOutput schema / properties / url / description
      Added value: +"The Recall Canary page for this record (absolute, canonical): the plain-language page a reader can use. Link this when you cite the record."
  3. Changed8 schema fields changed
    • changedOutput schema / description
      Previous value: -"One record. `record_type` says which kind: a canonical `recall` (products, timeline, dates, related) or a `preliminary` agency press release (linked_recalls, company and agency dates)."New value: +"One record. `record_type` says which shape: a canonical agency record (products, timeline, dates, related; `record_kind` says whether it is a recall, alert or warning) or a `preliminary` agency press release (linked_recalls, company and agency dates)."
    • changedOutput schema / properties / consumer_action / description
      Previous value: -"The \"What to do\" text. Null on a withdrawn alert."New value: +"The \"What to do\" text. Null on a withdrawn alert. On a CPSC safety warning, CPSC's own Consumer Action (its instructions, not a remedy)."
    • addedOutput schema / properties / products / items / properties / remedy_description / description
      Added value: +"The agency's remedy text; on a CPSC safety warning, CPSC's Consumer Action (instructions, not a remedy)."
    • addedOutput schema / properties / record_kind
      Added value: +{
      +  "description": "Since api 2.12.0. What kind of agency notice a recall record is: `recall`, an FSIS `public_health_alert` or a CPSC `safety_warning`; the last two are not recalls and are never rated. Null on a preliminary record. `record_type` is `recall` on all three; no filter selects by kind.",
      +  "enum": [
      +    "recall",
      +    "public_health_alert",
      +    "safety_warning",
      +    null
      +  ]
      +}
    • addedOutput schema / properties / related / properties / events / items / properties / evidence / properties / quote
      Added value: +{
      +  "description": "Since api 2.13.0, notice_recall: the CPSC safety warning's sentence, verbatim.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / related / properties / events / items / properties / evidence / properties / source
      Added value: +{
      +  "description": "Since api 2.13.0, notice_recall: cpsc_recalls_export, warning_body_link or operator_confirmed.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / related / properties / events / items / properties / kind / description
      Previous value: -"Known values: other_agency, source_recall, ingredient_alert, named_supplier."New value: +"Known values: other_agency, source_recall, ingredient_alert, named_supplier, notice_recall."
    • addedOutput schema / properties / remedy_superseded
      Added value: +{
      +  "description": "Since api 2.13.0. A later CPSC safety warning says this recall's remedy is no longer being provided: its page and its sentence that says so (verbatim, or null). `consumer_action` is then that warning's Consumer Action unless an operator pinned one. Null otherwise.",
      +  "properties": {
      +    "quote": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "warning_url": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "warning_url",
      +    "quote"
      +  ],
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
  4. Changed3 schema fields changed
    • addedOutput schema / properties / identification / properties / products / items / properties / unlisted_since
      Added value: +{
      +  "description": "Present only on a row from a product the agency no longer lists (api 2.11.0).",
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / unlisted_since
      Added value: +{
      +  "description": "Since api 2.11.0. When the agency confirmed it no longer lists this product: the first read without it (ISO). Null while it lists it.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / products / items / required
      Previous value: -[
      -  "name",
      -  "description",
      -  "brand",
      -  "make",
      -  "component",
      -  "product_type",
      -  "product_recall_number",
      -  "quantity",
      -  "lot_codes",
      -  "lot_codes_omitted",
      -  "upc",
      -  "upc_omitted",
      -  "gtin",
      -  "serial_numbers",
      -  "serial_numbers_omitted",
      -  "catalog_numbers",
      -  "sold_at",
      -  "made_in",
      -  "remedy_description",
      -  "remedy_options",
      -  "hazard_description",
      -  "incidents",
      -  "severity",
      -  "status",
      -  "image_url"
      -]New value: +[
      +  "name",
      +  "description",
      +  "brand",
      +  "make",
      +  "component",
      +  "product_type",
      +  "product_recall_number",
      +  "quantity",
      +  "lot_codes",
      +  "lot_codes_omitted",
      +  "upc",
      +  "upc_omitted",
      +  "gtin",
      +  "serial_numbers",
      +  "serial_numbers_omitted",
      +  "catalog_numbers",
      +  "sold_at",
      +  "made_in",
      +  "remedy_description",
      +  "remedy_options",
      +  "hazard_description",
      +  "incidents",
      +  "severity",
      +  "status",
      +  "image_url",
      +  "unlisted_since"
      +]
  5. Changed1 schema field changed
    • addedOutput schema / properties / identification / properties / products / items / properties / fields / items / properties / notes
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "Plain text keyed by one of `values`: a serial or lot decoded from an HIBC label code, with its expiry and the stored code.",
      +  "type": "object"
      +}
  6. Changed22 schema fields changed
    • changedOutput schema / properties / category / description
      Previous value: -"Known values: FOOD, DRUG, DEVICE, COSMETIC, CONSUMER_PRODUCT, VEHICLE, AUTO_EQUIPMENT."New value: +"Known values: FOOD, DRUG, BIOLOGIC, DEVICE, COSMETIC, CONSUMER_PRODUCT, VEHICLE, AUTO_EQUIPMENT."
    • addedOutput schema / properties / dates / properties / announced_at / description
      Added value: +"Deprecated since api 2.7.0: for FDA the firm's start of the recall (began_at), never a public announcement."
    • addedOutput schema / properties / dates / properties / began_at
      Added value: +{
      +  "description": "Since api 2.7.0. The recall's own start: FDA's Date Initiated by Firm; null for FSIS, CPSC and NHTSA.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / dates / properties / fda_posted_at
      Added value: +{
      +  "description": "Since api 2.7.0. FDA only: when FDA first posted the recall to its Enforcement Report.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / dates / required
      Previous value: -[
      -  "listed_at",
      -  "listed_at_basis",
      -  "announced_at",
      -  "ended_at"
      -]New value: +[
      +  "listed_at",
      +  "listed_at_basis",
      +  "announced_at",
      +  "ended_at",
      +  "began_at",
      +  "fda_posted_at"
      +]
    • addedOutput schema / properties / late
      Added value: +{
      +  "description": "Since api 2.7.0. Null unless the recall is late: it began more than 184 days before listed_at, or it ended on or before the date its listed_at_basis names.",
      +  "properties": {
      +    "began_at": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "ended_relation": {
      +      "enum": [
      +        "same_day",
      +        "before",
      +        null
      +      ]
      +    },
      +    "retroactive": {
      +      "description": "The agency's own text says the recall was reported retroactively.",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "began_at",
      +    "ended_relation",
      +    "retroactive"
      +  ],
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / linked_recalls / items / properties / ai_generated
      Added value: +{
      +  "description": "Since api 2.7.0. Which fields of this ref the enrichment pipeline wrote.",
      +  "properties": {
      +    "title": {
      +      "description": "True when title is the stored display_title (enrichment text).",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "title"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / linked_recalls / items / properties / title / description
      Previous value: -"Agency-published title."New value: +"Since api 2.7.0: the title the record's card shows (its judged display_title, model-written when ai_generated.title is true); the cleaned agency title for a record without one."
    • changedOutput schema / properties / linked_recalls / items / required
      Previous value: -[
      -  "id",
      -  "url",
      -  "agency",
      -  "title",
      -  "firm_name",
      -  "severity",
      -  "listed_at",
      -  "product_count",
      -  "reason"
      -]New value: +[
      +  "id",
      +  "url",
      +  "agency",
      +  "title",
      +  "firm_name",
      +  "severity",
      +  "listed_at",
      +  "product_count",
      +  "reason",
      +  "ai_generated"
      +]
    • addedOutput schema / properties / related / properties / by_firm / items / properties / ai_generated
      Added value: +{
      +  "description": "Since api 2.7.0. Which fields of this ref the enrichment pipeline wrote.",
      +  "properties": {
      +    "title": {
      +      "description": "True when title is the stored display_title (enrichment text).",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "title"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / related / properties / by_firm / items / properties / title / description
      Previous value: -"Agency-published title."New value: +"Since api 2.7.0: the title the record's card shows (its judged display_title, model-written when ai_generated.title is true); the cleaned agency title for a record without one."
    • changedOutput schema / properties / related / properties / by_firm / items / required
      Previous value: -[
      -  "id",
      -  "url",
      -  "agency",
      -  "title",
      -  "firm_name",
      -  "severity",
      -  "listed_at",
      -  "product_count",
      -  "reason"
      -]New value: +[
      +  "id",
      +  "url",
      +  "agency",
      +  "title",
      +  "firm_name",
      +  "severity",
      +  "listed_at",
      +  "product_count",
      +  "reason",
      +  "ai_generated"
      +]
    • addedOutput schema / properties / related / properties / events / items / properties / ai_generated
      Added value: +{
      +  "description": "Since api 2.7.0. Which fields of this ref the enrichment pipeline wrote.",
      +  "properties": {
      +    "title": {
      +      "description": "True when title is the stored display_title (enrichment text).",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "title"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / related / properties / events / items / properties / title / description
      Previous value: -"Agency-published title."New value: +"Since api 2.7.0: the title the record's card shows (its judged display_title, model-written when ai_generated.title is true); the cleaned agency title for a record without one."
    • changedOutput schema / properties / related / properties / events / items / required
      Previous value: -[
      -  "id",
      -  "url",
      -  "agency",
      -  "title",
      -  "firm_name",
      -  "severity",
      -  "listed_at",
      -  "product_count",
      -  "reason",
      -  "kind",
      -  "direction",
      -  "evidence"
      -]New value: +[
      +  "id",
      +  "url",
      +  "agency",
      +  "title",
      +  "firm_name",
      +  "severity",
      +  "listed_at",
      +  "product_count",
      +  "reason",
      +  "ai_generated",
      +  "kind",
      +  "direction",
      +  "evidence"
      +]
    • addedOutput schema / properties / related / properties / same_hazard / items / properties / ai_generated
      Added value: +{
      +  "description": "Since api 2.7.0. Which fields of this ref the enrichment pipeline wrote.",
      +  "properties": {
      +    "title": {
      +      "description": "True when title is the stored display_title (enrichment text).",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "title"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / related / properties / same_hazard / items / properties / title / description
      Previous value: -"Agency-published title."New value: +"Since api 2.7.0: the title the record's card shows (its judged display_title, model-written when ai_generated.title is true); the cleaned agency title for a record without one."
    • changedOutput schema / properties / related / properties / same_hazard / items / required
      Previous value: -[
      -  "id",
      -  "url",
      -  "agency",
      -  "title",
      -  "firm_name",
      -  "severity",
      -  "listed_at",
      -  "product_count",
      -  "reason"
      -]New value: +[
      +  "id",
      +  "url",
      +  "agency",
      +  "title",
      +  "firm_name",
      +  "severity",
      +  "listed_at",
      +  "product_count",
      +  "reason",
      +  "ai_generated"
      +]
    • addedOutput schema / properties / related / properties / same_product / items / properties / ai_generated
      Added value: +{
      +  "description": "Since api 2.7.0. Which fields of this ref the enrichment pipeline wrote.",
      +  "properties": {
      +    "title": {
      +      "description": "True when title is the stored display_title (enrichment text).",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "title"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / related / properties / same_product / items / properties / title / description
      Previous value: -"Agency-published title."New value: +"Since api 2.7.0: the title the record's card shows (its judged display_title, model-written when ai_generated.title is true); the cleaned agency title for a record without one."
    • changedOutput schema / properties / related / properties / same_product / items / required
      Previous value: -[
      -  "id",
      -  "url",
      -  "agency",
      -  "title",
      -  "firm_name",
      -  "severity",
      -  "listed_at",
      -  "product_count",
      -  "reason"
      -]New value: +[
      +  "id",
      +  "url",
      +  "agency",
      +  "title",
      +  "firm_name",
      +  "severity",
      +  "listed_at",
      +  "product_count",
      +  "reason",
      +  "ai_generated"
      +]
    • changedOutput schema / properties / timeline / description
      Previous value: -"Dated steps of the record, in date order. Each step names who acted on that date."New value: +"Dated steps of the record, in date order. Each step names who acted on that date. FDA labels: Company began the recall, Announced by the company, Added to FDA's Enforcement Report, Classified by FDA, In FDA's weekly enforcement report; then Listed on Recall Canary, Summary updated, Recall ended, Archived."
  7. Changed1 schema field changed
    • changedOutput schema / properties / identification / description
      Previous value: -"Page-derived identification: the products and codes the record names. Not a completeness guarantee; `partial` says when the list is incomplete."New value: +"Page-derived identification: the products and codes the record names. Not a completeness guarantee; `partial` says when the list is incomplete, including when this response cut `products` to 25 (`mcp_truncated.identification_products`)."
  8. First observed

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and openWorldHint=false, and the description's 'Read-only' merely echoes them. The real value is additive: it discloses what the record contains (hazard, product list with lot codes and UPCs, consumer action, distribution, urls) and, more importantly, the non-obvious resolution behavior for preliminary agency press releases whose linked_recalls point elsewhere.

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 is front-loaded in the first clause and every element that follows carries information (fields returned, citation URLs, press-release resolution). The prose is packed into two long, clause-heavy sentences, which makes it denser than it needs to be, but nothing is genuinely wasteful.

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?

With only two required params, full schema coverage, an output schema, and read-only annotations, the definition covers purpose, workflow origin, return content, and edge cases. The only gap is failure behavior (e.g., what a miss on wrong agency/slug yields), which the schema hints at but the description never states.

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 coverage is 100%, so both parameters are already documented in-schema, giving a baseline of 3. The description does add a cross-tool link (the returned firm.slug feeds search_recalls' firm filter) and stresses that agency is part of the lookup key, but it largely restates schema semantics such as the agency/slug pair being the key.

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?

States a specific verb ('Fetch') and a precisely scoped resource: the full Recall Canary record for a single U.S. federal recall, FSIS alert, or CPSC warning, keyed by agency + slug. It explicitly positions itself as the detail lookup relative to search_recalls, so an agent can tell the two apart without 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 a clear workflow trigger: 'given the agency and slug returned by search_recalls', which tells the agent this is the follow-up call after a search row exists. It also carves out the press-release case (orphans and linked releases that kept their own URL). It does not state explicit when-not-to-use conditions beyond that.

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