- LEAGUE DATA
- CLUB DATA
- SEARCH
- HUMAN
Short answer
How can I get team and league details using my AI?
Your AI uses TheSportsDB to identify every team in a specific league and grab deep metadata for each club. You'll get organized lists of rosters and league structures. Here is how the data flows.
The data outcomes
What you get
The specific information your AI pulls from the database.
LEAGUE DATA
Complete league lists
The AI identifies every club competing in a specific league. You get a clean roster of all participating teams.
CLUB DATA
Detailed club profiles
Your AI pulls specific metadata for individual clubs. This includes the deep details needed for scouting or analysis.
SEARCH
Targeted team lookups
If you only need one specific club, the AI finds them instantly. It pulls their specific data without needing the full league list.
HUMAN
Manual verification
You review the data the AI pulls. You decide which specific club details are worth deep-diving into next.
The workflow
What your AI does when the request arrives.
The AI acts as a bridge between your chat and the global sports database.
Identify the league
The AI looks up the specific league you are interested in to understand its structure.
get_league_detailsMap the teams
Once the league is identified, the AI pulls a list of every team currently in that competition.
list_all_teams_in_leagueFind specific clubs
If you need to narrow things down, the AI searches for specific team names to pull their unique data.
search_teamsCompile the report
The AI organizes the retrieved metadata into a readable format for your analysis.
get_league_detailssearch_teams
Try it
Copy these to start.
Use these prompts to kick off your research.
Starting points
Swap out the league or team names for the ones you actually want to research.
TheSportsDB Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_tly0YZjx9y72dtauQzjwXJ1r3HdG91sL3TBGmwp6/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — TheSportsDB capabilities are ready to use.
{
"mcpServers": {
"thesportsdb-global-sports-database-mcp": {
"url": "https://edge.vinkius.com/vk_preview_tly0YZjx9y72dtauQzjwXJ1r3HdG91sL3TBGmwp6/mcp"
}
}
}List all the teams currently in the English Premier League.
Find the metadata for Real Madrid and tell me about their club details.
Get the full details for the NBA to see how the league is structured.
Search for the Los Angeles Lakers and give me their team info.
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Start here
Connect TheSportsDB once, then ask.
One click connects this MCP to your client. Your credentials stay encrypted, and you can start asking questions immediately.
Connect TheSportsDB to your AIFAQ
How this task behaves
- 01
Can the AI update team rosters?
No. The AI can only read and retrieve existing data from the database. It cannot change or add new team information.
- 02
Can I use this to change league standings?
No. This tool is for data retrieval only. It does not have the ability to write or modify any records in TheSportsDB.
- 03
Does it work for minor leagues?
Yes, as long as the league and its teams exist within TheSportsDB.
- 04
Can the AI pull player stats?
The AI pulls the metadata provided by the tools, which includes club and league details.
- 05
Do I need to provide the league ID?
No, you can just name the league in plain English and the AI will find it.
More questions about TheSportsDB? See everything the TheSportsDB Connector can do
Connect TheSportsDB to Claude, Cursor, ChatGPT & more
