`get_schedule`

Pack: f1 · Endpoint: https://gateway.pipeworx.io/f1/mcp

Get the F1 season race calendar. Provide year (e.g., 2024). Returns all rounds with race name, circuit, location, and date.

Parameters

Name	Type	Required	Description
`season`	string	yes	Season year (e.g., “2025”)

Example call

Arguments

{
  "season": "2025"
}

curl

curl -X POST https://gateway.pipeworx.io/f1/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_schedule","arguments":{"season":"2025"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_schedule', {
  "season": "2025"
});

More examples

{
  "season": "2024"
}

Response shape

Always returns: season, total, schedule

Field	Type	Description
`season`	string	F1 season year
`total`	integer	Total number of races in season
`schedule`	array	List of races

Full JSON Schema

{
  "type": "object",
  "properties": {
    "season": {
      "type": "string",
      "description": "F1 season year"
    },
    "total": {
      "type": "integer",
      "description": "Total number of races in season"
    },
    "schedule": {
      "type": "array",
      "description": "List of races",
      "items": {
        "type": "object",
        "properties": {
          "season": {
            "type": "string",
            "description": "F1 season year"
          },
          "round": {
            "type": "integer",
            "description": "Round number"
          },
          "name": {
            "type": "string",
            "description": "Race name"
          },
          "circuit_id": {
            "type": "string",
            "description": "Ergast circuit ID"
          },
          "circuit_name": {
            "type": "string",
            "description": "Circuit name"
          },
          "locality": {
            "type": [
              "string",
              "null"
            ],
            "description": "City/locality of circuit"
          },
          "country": {
            "type": [
              "string",
              "null"
            ],
            "description": "Country of circuit"
          },
          "date": {
            "type": "string",
            "description": "Race date (ISO format)"
          },
          "time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Race start time"
          }
        },
        "required": [
          "season",
          "round",
          "name",
          "circuit_id",
          "circuit_name",
          "locality",
          "country",
          "date",
          "time"
        ]
      }
    }
  },
  "required": [
    "season",
    "total",
    "schedule"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "f1": {
      "url": "https://gateway.pipeworx.io/f1/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_schedule