Skip to main content
Glama

mlb_statcast_first_base_receiving_details

Read-only

Fetch individual First Base Receiving play records for a player id, including game/play ids, receiving OAA, throw outcome, base state, timing, and coordinates. The 3D skeletal visualization is not included.

Input Schema

NameRequiredDescriptionDefault
sortNoOptional local sort field from mlb_discovery.
typeNoOptional board group: fielder_3, throw_fielder_id, pitching-team, batting-team, or league.
limitNoOptional rows per page, 1-500; defaults to 100.
teamsNoOptional MLB team ids from mlb_discovery.
offsetNoOptional zero-based row offset.
splitsNoOptional group rows by throw_height_code, throw_location_code_full, or runners_on_cd.
minimumNoOptional minimum opportunities: q, 1, 5, 10, 25, 50, 75, 100, 200, 300, 400, 500, 750, or 1000.
seasonsNoOptional season values from mlb_discovery; defaults to the current season.
date_endNoOptional inclusive YYYY-MM-DD end date.
field_outNoOptional field-out filter: 0 or 1.
player_idYesRequired player id from a first-base receiving row.
time_binsNoOptional receiving-time bins: -1 through 5.
date_startNoOptional inclusive YYYY-MM-DD start date.
game_typesNoOptional game types R, F, D, L, or W.
split_yearNoOptional include year split: 0 or 1.
fielder_handNoOptional first baseman batting hand: L or R.
minimum_splitNoOptional grouped-split minimum from mlb_discovery.
runner_statesNoOptional base occupancy codes 0 through 7.
throw_heightsNoOptional throw heights: 1_Low, 2_Mid, 3_High.
sort_directionNoOptional local sort direction: asc or desc.
throw_locationsNoOptional throw outcomes from mlb_discovery.
throw_positionsNoOptional throwing position ids: 4, 5, or 6.
minimum_height_inchesNoOptional minimum fielder height in inches, 70 through 80.

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. Changed9 schema fields changed
    • addedInput schema / properties / game_types / items / description
      Added value: +"Documented values: R, F, D, L, W."
    • addedInput schema / properties / runner_states / items / description
      Added value: +"Documented values: 0, 1, 2, 3, 4, 5, 6, 7."
    • addedInput schema / properties / seasons / items / description
      Added value: +"Documented values: 2021, 2022, 2023, 2024, 2025, 2026."
    • addedInput schema / properties / splits / items / description
      Added value: +"Documented values: throw_height_code, throw_location_code_full, runners_on_cd."
    • addedInput schema / properties / teams / items / description
      Added value: +"Documented values: 108, 117, 133, 141, 144, 158, 138, 112, 109, 119, 137, 114, 136, 146, 121, 120, 110, 135, 143, 134, 140, 139, 111, 113, 115, 118, 116, 142, 145, 147."
    • addedInput schema / properties / throw_heights / items / description
      Added value: +"Documented values: 1_Low, 2_Mid, 3_High."
    • addedInput schema / properties / throw_locations / items / description
      Added value: +"Documented values: A. On Target, B. Scoop, C. Bounce, D. Low, E. Wide, F. High."
    • addedInput schema / properties / throw_positions / items / description
      Added value: +"Documented values: 4, 5, 6."
    • addedInput schema / properties / time_bins / items / description
      Added value: +"Documented values: -1, 0, 1, 2, 3, 4, 5."
  2. First observed

TDQS

A3.6/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 genuinely useful boundary context by disclosing a scope limitation ('The 3D skeletal visualization is not included'), which prevents an agent from assuming that data is returned. It does not touch pagination or rate limits, keeping it out of the top score.

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?

Two tightly written sentences with the primary purpose front-loaded and the exclusion clause placed second. Nothing is redundant against the name or schema.

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 an output schema present and 100% parameter coverage, the description does not need to explain return fields or param syntax. It orients the agent adequately for a 23-param drill-down tool, though it leaves the relationship to its aggregate sibling implicit.

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%, so the 23 parameters are already fully documented in the schema; baseline 3 applies. The description's field list actually describes return values rather than adding meaning to any input parameter, so it neither compensates for nor improves on the schema.

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?

States a specific verb ('Fetch') and resource ('individual First Base Receiving play records'), and enumerates the payload (game/play ids, receiving OAA, throw outcome, base state, timing, coordinates). It implicitly reads as the drill-down counterpart to mlb_statcast_first_base_receiving via the 'details' suffix, but never names or contrasts that sibling explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

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

The description gives no explicit when-to-use guidance, no prerequisite that the player_id should come from mlb_statcast_first_base_receiving, and no exclusions. The dependency on a prior discovery call is only hinted at in the schema parameter text, not in the description.

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.