`list_leagues`

Pack: thesportsdb · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

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

List the sports leagues catalogued by TheSportsDB, optionally narrowed by sport name (Soccer, Ice Hockey, Basketball, American Football, Baseball) and by country name. Returns each league id, name, alternate name, sport, and country; the league id feeds league_teams and league_table in this pack. Answers which leagues exist for a sport or a country, and what league id to use next.

Parameters

Name	Type	Required	Description
`sport`	string	no	Sport name (e.g. “Soccer”, “Ice Hockey”)
`country`	string	no	Country name

Example call

Arguments

{
  "sport": "Soccer",
  "country": "England"
}

curl

curl -X POST https://gateway.pipeworx.io/thesportsdb/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_leagues","arguments":{"sport":"Soccer","country":"England"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('list_leagues', {
  "sport": "Soccer",
  "country": "England"
});

More examples

{
  "sport": "Ice Hockey"
}

Response shape

Full JSON Schema

{
  "type": "object",
  "description": "Response from TheSportsDB leagues endpoint"
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the thesportsdb pack

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

See Getting Started for client-specific install steps.

list_leagues