`get_schedule`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_schedule for the schema, then POST the same URL with its arguments for the data.

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