Skip to main content
Glama

formula1_driver

Read-only

Get one Formula 1 driver profile and return the driver's name, team, country, number, current season and season, career and profile statistics. driver_slug comes from formula1_driver_standings, formula1_season_results or a season page, for example max-verstappen; an unknown slug is a 404. Use formula1_driver_standings for the championship table instead.

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": {
      "driver_slug": "<driver_slug>"
    },
    "name": "formula1_driver"
  }
}

Input Schema

NameRequiredDescriptionDefault
driver_slugYesRequired driver profile slug from formula1-season-results, formula1-driver-standings or a season page, such as kimi-antonelli.

Output Schema

NameRequiredDescriptionDefault
dataYesThe tool result payload (shape varies per tool; see each tool's docs resource).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and openWorldHint=true, so safety is covered. The description adds real behavioral context beyond them: an unknown slug returns a 404, and the response contents are enumerated. It stops short of describing anything about data freshness or rate limits, which keeps it from a 5.

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, front-loaded with the action and return payload before the routing note. It is efficient, though the slug-provenance sentence restates what the input schema already says, which is the only wasted wording.

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 single-parameter read tool with an output schema and read-only annotations, nothing an agent needs is missing: the identifier's source, the error case, the return contents, and the sibling alternative are all covered. Return-value details are correctly left to the output schema.

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% and the schema property already documents the slug's provenance and gives the example kimi-antonelli, so the description's slug sentence largely duplicates structured data. The only added semantic value is the 404-on-unknown-slug outcome, so baseline 3 applies.

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 ("Get one Formula 1 driver profile") and enumerates exactly what is returned: name, team, country, number, season, career and profile statistics. It also distinguishes itself from formula1_driver_standings by naming that sibling and its different scope, so an agent can route correctly 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 Guidelines5/5

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

Explicitly says where the required identifier comes from (formula1_driver_standings, formula1_season_results, or a season page) and explicitly redirects championship-table lookups to formula1_driver_standings instead. Both the when-to-use and the when-to-use-something-else conditions are present.

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.