Skip to main content
Glama

RecallLens

Vehicle recalls by make, model and year

vehicle_recalls
Read-onlyIdempotent

Lists NHTSA safety recall campaigns for a US-market vehicle by make, model and model year, newest first: campaign number, report date, component, a short defect summary, the safety risk, the remedy, any "do not drive" or "park outside" advisory, and a link to the NHTSA recall page. If the model name does not match NHTSA's naming, it returns the closest NHTSA model names for that make and year. It covers campaigns issued for the model, not whether a specific vehicle has been repaired.

Input Schema

NameRequiredDescriptionDefault
makeYesVehicle make, e.g. "Honda", "Chevrolet", "Ford". Short forms such as "Chevy" and "VW" are accepted.
limitNoMaximum number of campaigns to return (1-50, default 10).
modelYesModel name, e.g. "Accord", "F-150", "Silverado 1500", "Model 3".
detailNo"brief" (default) keeps each result short; "full" adds the complete text fields.brief
model_yearYesFour-digit model year, e.g. 2018.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already declare read-only, idempotent, non-destructive and open-world, so safety is covered. The description adds substantive behavior on top: newest-first ordering, the full return field set, the fuzzy model-name fallback that returns closest NHTSA model names for that make and year, and the explicit coverage limitation regarding repair status.

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?

Three dense sentences, front-loaded with purpose and scope before the edge-case and limitation notes. The enumerations of return fields and advisories are long but justified because no output schema exists; nothing is decorative.

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 five parameters, no output schema and an open-world data source, the description still tells an agent what comes back, how results are ordered, what happens on a model-name miss, and what the tool does not answer. Nothing material for correct invocation is missing.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, but the description earns extra credit by explaining the runtime behavior tied to the model parameter (mismatched names yield nearest NHTSA model suggestions for that make and year) and by noting newest-first ordering, which affects how limit is interpreted. The brief/full detail flag is left to the schema.

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 and resource ("Lists NHTSA safety recall campaigns") scoped by make, model and model year, then enumerates exactly what each result contains. The closing line ("covers campaigns issued for the model, not whether a specific vehicle has been repaired") cleanly separates it from a VIN-level lookup.

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 when-not-to-use boundary by saying results describe campaigns for the model rather than repair status of a particular vehicle, which implicitly routes vehicle-specific questions elsewhere. It never names an alternative tool explicitly, so the guidance is clear but not fully prescriptive.

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