TheSportsDB

live Sports

Sports catalog across 50+ leagues — teams, players, events, league tables. Free public tier (key "3"); higher tiers via supporter key.

11 tools
0ms auth
free tier 50 calls/day

Tools

list_sports

All sports.

No parameters required.

▶ Try it
list_leagues

List leagues filtered by sport/country.

Parameters
Name Type Description
sport opt string —
country opt string —
▶ Try it
search_teams required: query

Search teams by name.

Parameters
Name Type Description
query req string —
▶ Try it
get_team required: team_id

Team profile by ID.

Parameters
Name Type Description
team_id req string —
▶ Try it
league_teams required: league_id

All teams in a league.

Parameters
Name Type Description
league_id req string —
▶ Try it
search_players required: query

Search players by name.

Parameters
Name Type Description
query req string —
▶ Try it
get_player required: player_id

Player profile by ID.

Parameters
Name Type Description
player_id req string —
▶ Try it
team_events_last required: team_id

Last 5 events for a team.

Parameters
Name Type Description
team_id req string —
▶ Try it
team_events_next required: team_id

Next 5 events for a team.

Parameters
Name Type Description
team_id req string —
▶ Try it
events_by_day required: date

All events on a given date.

Parameters
Name Type Description
date req string —
sport opt string —
league opt string —
▶ Try it
league_table required: league_id

Standings table for a league/season.

Parameters
Name Type Description
league_id req string —
season opt string —
▶ Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash 
curl -X POST https://gateway.pipeworx.io/thesportsdb/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash 
curl -X POST https://gateway.pipeworx.io/thesportsdb/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_sports","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript 
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("list_sports", {});
ask_pipeworx 
// Or ask in plain English:
const answer = await px.ask("sports catalog across 50+ leagues — teams, players, events, league tables");