get_mlb_game_scoring_plays

Retrieve scoring plays and specific events from MLB games using game_id, with optional filters for event type, timecode, and fields. Ideal for accessing detailed baseball game data.

Instructions

Get plays for a specific game by game_id, with optional filtering by eventType.

Args: game_id (int): The game ID. eventType (Optional[str]): Filter plays by this event type (e.g., 'scoring_play', 'home_run'). timecode (Optional[str]): Specific timecode for the play-by-play snapshot. fields (Optional[str]): Comma-separated list of fields to include.

Returns: dict: Game plays, optionally filtered by eventType.

Input Schema

Name	Required	Description	Default
`eventType`	No
`fields`	No
`game_id`	Yes
`timecode`	No

Input Schema (JSON Schema)

{
  "properties": {
    "eventType": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Eventtype"
    },
    "fields": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Fields"
    },
    "game_id": {
      "title": "Game Id",
      "type": "integer"
    },
    "timecode": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Timecode"
    }
  },
  "required": [
    "game_id"
  ],
  "type": "object"
}

mlb-api-mcp