`get_league_table`

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

Get current standings/table for a league and season. Returns team, played, wins, draws, losses, goals for, goals against, and points.

Parameters

Name	Type	Required	Description
`league_id`	string	yes	TheSportsDB league ID (e.g., “4328” for English Premier League)
`season`	string	yes	Season string (e.g., “2024-2025”)

Example call

Arguments

{
  "league_id": "4328",
  "season": "2024-2025"
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_league_table', {
  "league_id": "4328",
  "season": "2024-2025"
});

More examples

{
  "league_id": "4391",
  "season": "2023-2024"
}

Response shape

Always returns: league_id, season, total, standings

Field	Type	Description
`league_id`	string	TheSportsDB league ID
`season`	string	Season string (e.g., 2024-2025)
`total`	integer	Total number of teams in standings
`standings`	array	League standings/table entries

Full JSON Schema

{
  "type": "object",
  "properties": {
    "league_id": {
      "type": "string",
      "description": "TheSportsDB league ID"
    },
    "season": {
      "type": "string",
      "description": "Season string (e.g., 2024-2025)"
    },
    "total": {
      "type": "integer",
      "description": "Total number of teams in standings"
    },
    "standings": {
      "type": "array",
      "description": "League standings/table entries",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Team ID"
          },
          "team": {
            "type": "string",
            "description": "Team name"
          },
          "played": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Matches played"
          },
          "wins": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of wins"
          },
          "draws": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of draws"
          },
          "losses": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of losses"
          },
          "goals_for": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Goals scored"
          },
          "goals_against": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Goals conceded"
          },
          "points": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Total points"
          }
        },
        "required": [
          "id",
          "team"
        ]
      }
    }
  },
  "required": [
    "league_id",
    "season",
    "total",
    "standings"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

get_league_table