Skip to main content
Glama

Race Calendar F1

F1 Race Classification

get_f1_race_classification
Read-onlyIdempotent

Get a published F1DB race, qualifying, or sprint classification by season and a friendly race selector, without requiring meeting or session keys.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
slugNoRace Calendar race slug, such as round-6-miami-grand-prix or miami-grand-prix.
yearYesFormula 1 season year.
roundNoChampionship round number for the season.
raceNameNoHuman-friendly Grand Prix or race name, matched case-insensitively.
meetingKeyNoOpenF1 meeting key for the race weekend.
classificationNoPublished F1DB classification to return. Defaults to the Grand Prix race.race

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
yearYes
roundYes
sourceYes
resultsYes
raceNameYes
availableYes
sourceUrlYes
meetingKeyYes
sessionKeyYes
resultCountYes
canonicalUrlYes
classificationYes

TDQS

A4.3/5.0
Behavior4/5

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 clear. The description adds valuable context beyond these: it specifies the data source (F1DB), that classifications are published, and that selectors are friendly rather than raw keys. This adds meaningful behavioral insight without any contradiction.

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

Conciseness5/5

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

The description is a single, well-structured sentence that front-loads the core purpose (get classification) and follows with essential qualifiers (published F1DB, race/qualifying/sprint, season, friendly selector, no keys). Every word adds meaning, and there is no redundancy.

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?

Given the rich input schema (100% coverage), clear annotations, and the presence of an output schema, the description is adequately complete. It communicates the primary use case, the selector approach, and the data scope. The absence of explicit return-value details is acceptable because the output schema covers that.

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 description coverage is 100%, with detailed explanations for each parameter including the oneOf selector options and the classification enum. The description's phrase 'friendly race selector' provides a high-level unifying concept, but it does not add syntax or formatting details beyond what the schema already offers. Baseline 3 is appropriate.

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?

The description clearly states it retrieves published F1DB race, qualifying, or sprint classifications using a season and a friendly race selector, and explicitly notes it does not require meeting or session keys. This differentiates it from sibling tools like get_f1_session_results by specifying the data source and the selector style.

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?

The description clearly implies when to use it (when you need a published classification and have a season plus a human-friendly race selector) and also explains what it avoids (meeting/session keys). However, it does not explicitly exclude alternative tools or name them, so it lacks explicit when-not-to-use guidance.

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.

TDQS

A4.1/5.0
Disambiguation4/5

Most tools have clearly distinct purposes, but get_f1_race_classification and get_f1_session_results overlap in providing classifications, differing mainly in input method. get_f1_historical_race_result(s) are differentiated by count but could still be confused with race_classification.

Naming Consistency5/5

All tools follow a consistent verb_f1_noun snake_case pattern (get_f1_*, compare_f1_*, search_f1_*). The naming is predictable and uniform, with no mixed conventions or vague verbs.

Tool Count5/5

15 tools is within the ideal range and well-scoped for an F1 data server covering schedules, results, standings, circuits, live sessions, and history. Each tool serves a distinct aspect without bloat.

Completeness4/5

The surface covers core F1 data needs: schedules, race/weekend info, classifications, standings, live status, history search, and comparisons. Minor gaps exist like no direct driver profile tool, but search_f1_history fills this, and multi-race queries are handled via the plural results tool.

Resources