Get Series Hub

Canonical tool name: get_series_hub Family: Hybrid Bundle Tools

What this tool is best at

Return one compact series bundle with series seasons, bounded event rows, leaderboard refs, and phase refs for tours and motorsports.

Choose this tool when

the product needs one tour or series surface instead of stitching schedule, rankings, and phase discovery together.
Source ownership: GSD Lookup primary

Use something smaller or different when

the host only needs a single schedule list, one leaderboard, or one phase/session result slice.

Inputs you need

Plain-English prerequisites

This tool does not require a prerequisite ID beyond the scoped inputs shown below.

Required inputs in the public contract

None.

Optional inputs in the public contract

Input	What it means
`seriesId`	Series ref for the broader tour scope such as Formula 1, ATP, PGA Tour, or LPGA Tour.
`seriesSeasonId`	Series-season ref when the experience is anchored to one tour season.
`timeFrom`	Optional bounded window start for series schedule items. When omitted, the hub applies a live-facing default browse window instead of unbounded schedule fanout.
`timeTo`	Optional bounded window end for series schedule items. Pair it with `timeFrom` when the product needs an explicit browse horizon.
`includeSections`	Optional section allow-list such as `seasons`, `schedule`, `rankings`, or `phases`.
`rowLimit`	Optional cap for repeated rows such as schedule items or ranking preview rows.
`language`	Optional BCP 47 language hint such as `en-US`. Use it when the host needs translated provider output.

Notes on optional inputs

If timeFrom and timeTo are omitted, the hub applies a bounded default schedule window of roughly 6 hours lookback and 7 days lookahead. It does not perform an unbounded series crawl.
If one time edge is provided, provide both.

Sequencing guidance

Needed ID or scope	Call this first	Then use
scope	Tool Catalog	Start from the smallest tool that can safely anchor the workflow, then deepen only if the user asks for more.

Response highlights

Return one compact series bundle with series seasons, bounded event rows, leaderboard refs, and phase refs for tours and motorsports.

Response shape

Field	What it means
`data.seasons[]`	Merged season candidates for the selected series.
`data.items[]`	Bounded schedule preview rows for the default or caller-provided window.
`data.overallRefs[] / data.classificationRefs[] / data.phaseRefs[]`	Actionable refs for rankings and phase/session deepening.
`data.rankingPreview[]`	Preview leaderboard rows from the selected best ranking view.
`data.rankingPreviewRefId / data.rankingPreviewRefType / data.rankingPreviewRowsSourcePath`	Selection metadata for the preview ranking block.

Reuse next

Reuse provider refs returned by this tool to avoid resolving the same entity again.
Read meta.agentHints.recommendedNextTools and meta.agentHints.disambiguationOptions as non-binding host hints.

Example requests

Recommended request
Expanded request

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "get_series_hub",
    "arguments": {
      "seriesId": "SERIES_ID",
      "timeFrom": "2026-04-08T00:00:00Z",
      "timeTo": "2026-04-15T00:00:00Z"
    }
  }
}

curl "https://sports-mcp-server.etonecarg.com/" \
  -X POST \
  -H "Authorization: Bearer $SPORTS_MCP_API_KEY" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -H "mcp-protocol-version: 2025-03-26" \
  -d '{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "get_series_hub",
    "arguments": {
      "seriesId": "SERIES_ID",
      "timeFrom": "2026-04-08T00:00:00Z",
      "timeTo": "2026-04-15T00:00:00Z"
    }
  }
}'

const payload = {
    "jsonrpc": "2.0",
    "id": "tool-call-1",
    "method": "tools/call",
    "params": {
      "name": "get_series_hub",
      "arguments": {
        "seriesId": "SERIES_ID",
        "timeFrom": "2026-04-08T00:00:00Z",
        "timeTo": "2026-04-15T00:00:00Z"
      }
    }
  };

const response = await fetch("https://sports-mcp-server.etonecarg.com/", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SPORTS_MCP_API_KEY!}`,
    Accept: "application/json, text/event-stream",
    "Content-Type": "application/json",
    "mcp-protocol-version": "2025-03-26",
  },
  body: JSON.stringify(payload),
});

const data = await response.json();
console.log(JSON.stringify(data, null, 2));

import json
import os

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "get_series_hub",
    "arguments": {
      "seriesId": "SERIES_ID",
      "timeFrom": "2026-04-08T00:00:00Z",
      "timeTo": "2026-04-15T00:00:00Z"
    }
  }
}

response = requests.post(
    "https://sports-mcp-server.etonecarg.com/",
    headers={
        "Authorization": f"Bearer {os.environ['SPORTS_MCP_API_KEY']}",
        "Accept": "application/json, text/event-stream",
        "Content-Type": "application/json",
        "mcp-protocol-version": "2025-03-26",
    },
    json=payload,
    timeout=30,
)

response.raise_for_status()
print(json.dumps(response.json(), indent=2))

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "get_series_hub",
    "arguments": {
      "seriesSeasonId": "SERIES_SEASON_ID",
      "includeSections": [
        "schedule",
        "rankings"
      ],
      "rowLimit": 10,
      "timeFrom": "2026-04-08T00:00:00Z",
      "timeTo": "2026-04-15T00:00:00Z"
    }
  }
}

curl "https://sports-mcp-server.etonecarg.com/" \
  -X POST \
  -H "Authorization: Bearer $SPORTS_MCP_API_KEY" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -H "mcp-protocol-version: 2025-03-26" \
  -d '{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "get_series_hub",
    "arguments": {
      "seriesSeasonId": "SERIES_SEASON_ID",
      "includeSections": [
        "schedule",
        "rankings"
      ],
      "rowLimit": 10,
      "timeFrom": "2026-04-08T00:00:00Z",
      "timeTo": "2026-04-15T00:00:00Z"
    }
  }
}'

const payload = {
    "jsonrpc": "2.0",
    "id": "tool-call-1",
    "method": "tools/call",
    "params": {
      "name": "get_series_hub",
      "arguments": {
        "seriesSeasonId": "SERIES_SEASON_ID",
        "includeSections": [
          "schedule",
          "rankings"
        ],
        "rowLimit": 10,
        "timeFrom": "2026-04-08T00:00:00Z",
        "timeTo": "2026-04-15T00:00:00Z"
      }
    }
  };

const response = await fetch("https://sports-mcp-server.etonecarg.com/", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SPORTS_MCP_API_KEY!}`,
    Accept: "application/json, text/event-stream",
    "Content-Type": "application/json",
    "mcp-protocol-version": "2025-03-26",
  },
  body: JSON.stringify(payload),
});

const data = await response.json();
console.log(JSON.stringify(data, null, 2));

import json
import os

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "get_series_hub",
    "arguments": {
      "seriesSeasonId": "SERIES_SEASON_ID",
      "includeSections": [
        "schedule",
        "rankings"
      ],
      "rowLimit": 10,
      "timeFrom": "2026-04-08T00:00:00Z",
      "timeTo": "2026-04-15T00:00:00Z"
    }
  }
}

response = requests.post(
    "https://sports-mcp-server.etonecarg.com/",
    headers={
        "Authorization": f"Bearer {os.environ['SPORTS_MCP_API_KEY']}",
        "Accept": "application/json, text/event-stream",
        "Content-Type": "application/json",
        "mcp-protocol-version": "2025-03-26",
    },
    json=payload,
    timeout=30,
)

response.raise_for_status()
print(json.dumps(response.json(), indent=2))

Previous-step tools

Next-step tools

Alternative tools

No common alternatives.

Prompt patterns this tool fits

Use get_series_hub when the host already knows the right scope and needs this job directly.

Common mistakes

Calling get_series_hub before the host has the right provider refs or bounded window.
Using get_series_hub when a smaller sibling tool would answer the question more directly.

Getting Started

Concepts

Guides

Tools

Tool Reference

Reference

What this tool is best at

Choose this tool when

Use something smaller or different when

Inputs you need

Plain-English prerequisites

Required inputs in the public contract

Optional inputs in the public contract

Notes on optional inputs

Sequencing guidance

Response highlights

Response shape

Reuse next

Example requests

Previous-step tools

Next-step tools

Alternative tools

Prompt patterns this tool fits

Common mistakes

​What this tool is best at

​Choose this tool when

​Use something smaller or different when

​Inputs you need

​Plain-English prerequisites

​Required inputs in the public contract

​Optional inputs in the public contract

​Notes on optional inputs

​Sequencing guidance

​Response highlights

​Response shape

​Reuse next

​Example requests

​Related tools

​Previous-step tools

​Next-step tools

​Alternative tools

​Prompt patterns this tool fits

​Common mistakes

What this tool is best at

Choose this tool when

Use something smaller or different when

Inputs you need

Plain-English prerequisites

Required inputs in the public contract

Optional inputs in the public contract

Notes on optional inputs

Sequencing guidance

Response highlights

Response shape

Reuse next

Example requests

Related tools

Previous-step tools

Next-step tools

Alternative tools

Prompt patterns this tool fits

Common mistakes