`list_leagues`

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

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, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

list_leagues