get_meeting_info

Instructions

Implementation Reference

• tools/live/meetings.py:41-107 (handler)

  Main tool handler: Fetches meeting info and sessions using OpenF1 API, converts to Pydantic models.

  def get_meeting_info(
      year: int,
      country: str
  ) -> MeetingResponse:
      """
      Get meeting and session schedule information from OpenF1.
  
      Provides precise start times, session keys, and circuit details.
  
      Args:
          year: Season year (2023+, OpenF1 data availability)
          country: Country name (e.g., "Monaco", "Italy", "United States")
  
      Returns:
          MeetingResponse with meeting info and all sessions
  
      Example:
          get_meeting_info(2024, "Monaco") → Monaco GP weekend schedule
          get_meeting_info(2024, "Italy") → Italian GP at Monza
      """
      # Get meeting info
      meetings = openf1_client.get_meetings(year=year, country_name=country)
      if not meetings:
          return MeetingResponse(
              meeting=None,
              sessions=[],
              total_sessions=0
          )
  
      meeting_data = meetings[0]
  
      # Convert to Pydantic model
      meeting = MeetingInfo(
          meeting_key=meeting_data['meeting_key'],
          meeting_name=meeting_data['meeting_name'],
          meeting_official_name=meeting_data['meeting_official_name'],
          location=meeting_data['location'],
          country_name=meeting_data['country_name'],
          circuit_key=meeting_data['circuit_key'],
          circuit_short_name=meeting_data['circuit_short_name'],
          date_start=meeting_data['date_start'],
          year=meeting_data['year']
      )
  
      # Get sessions for this meeting
      sessions_data = openf1_client.get_sessions(year=year, country_name=country)
  
      # Convert sessions to Pydantic models
      sessions = [
          SessionInfo(
              session_key=session['session_key'],
              session_name=session['session_name'],
              session_type=session['session_type'],
              date_start=session['date_start'],
              date_end=session['date_end'],
              gmt_offset=session['gmt_offset'],
              circuit_key=session['circuit_key'],
              circuit_short_name=session['circuit_short_name']
          )
          for session in sessions_data
      ]
  
      return MeetingResponse(
          meeting=meeting,
          sessions=sessions,
          total_sessions=len(sessions)
      )

• tools/live/meetings.py:9-39 (schema)

  Pydantic schemas: SessionInfo, MeetingInfo, MeetingResponse for structured input/output validation.

  class SessionInfo(BaseModel):
      """Session information."""
      session_key: int = Field(..., description="Unique session identifier")
      session_name: str = Field(..., description="Session name (e.g., 'Race', 'Qualifying')")
      session_type: str = Field(..., description="Session type")
      date_start: str = Field(..., description="Session start datetime")
      date_end: str = Field(..., description="Session end datetime")
      gmt_offset: str = Field(..., description="GMT offset")
      circuit_key: int = Field(..., description="Circuit identifier")
      circuit_short_name: str = Field(..., description="Circuit short name")
  
  
  class MeetingInfo(BaseModel):
      """Meeting (race weekend) information."""
      meeting_key: int = Field(..., description="Unique meeting identifier")
      meeting_name: str = Field(..., description="Official meeting name")
      meeting_official_name: str = Field(..., description="Full official name")
      location: str = Field(..., description="Location/city")
      country_name: str = Field(..., description="Country name")
      circuit_key: int = Field(..., description="Circuit identifier")
      circuit_short_name: str = Field(..., description="Circuit short name")
      date_start: str = Field(..., description="Meeting start date")
      year: int = Field(..., description="Year")
  
  
  class MeetingResponse(BaseModel):
      """Response for meeting and session information."""
      meeting: Optional[MeetingInfo] = Field(None, description="Meeting information")
      sessions: list[SessionInfo] = Field(..., description="List of sessions in meeting")
      total_sessions: int = Field(..., description="Total number of sessions")

• server.py:171-171 (registration)

  MCP server tool registration.

  mcp.tool()(get_meeting_info)

• tools/live/__init__.py:5-5 (registration)

  Package-level import registration in tools/live.

  from .meetings import get_meeting_info

• tools/__init__.py:43-43 (registration)

  Root tools package import registration.

  from .live import get_driver_radio, get_live_pit_stops, get_live_intervals, get_meeting_info, get_stints_live