# TheSportsDB Global Sports Database MCP for AI Agents AI Agent Connect > TheSportsDB Global Sports Database lets your AI agent act as a pro sports scout. It pulls real-time scores, historical athlete stats, and league standings from a massive global database. Use it to research teams, find player milestones, or check upcoming match schedules instantly. ## Overview - **Category:** knowledge-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_tly0YZjx9y72dtauQzjwXJ1r3HdG91sL3TBGmwp6/ai-agent-connect - **Tags:** sports-data, metadata, league-standings, athlete-profiles, match-schedules, historical-data ## Description Stop jumping between five different tabs just to find a team's trophy history or a player's previous clubs. This Connector gives your AI client a direct line into TheSportsDB, which is one of the most reliable sources for sports metadata on the web. Instead of copy-pasting stats into a doc, you can just ask your agent to pull the latest NBA standings or find every team in a specific league. It works by connecting your AI client to a huge pool of information covering thousands of professional teams and athletes worldwide. Whether you're building a sports news site or just trying to win your fantasy league, this tool makes the data accessible in plain English. You'll find it's much faster to have your agent do the heavy lifting of auditing historical career achievements while you focus on the actual analysis. It's one of the high-quality tools you'll find in the Vinkius catalog for anyone who needs accurate sports data without the manual headache. ## Tools ### list_last_events_by_team See the most recent match results for a specific team. Use it to check recent scores. ### list_events_by_season Get all events in a league for a specific season. This is perfect for historical research. ### list_all_teams_in_league List every team belonging to a specific league. This helps you see the full scope of a competition. ### list_player_contracts Get contract details for a specific player. This is useful for financial or roster analysis. ### list_player_honours List trophies and awards for a specific player. Use this to see an athlete's career achievements. ### list_player_milestones List career milestones for a specific player. This pulls out the big moments in an athlete's history. ### list_former_teams Find out where a player played before their current club. This is great for career history checks. ### search_players Find sports players by typing their name. This is the fastest way to get to an athlete profile. ### list_events_by_day See every game happening on a specific date. This helps you build daily schedules quickly. ### list_next_events_by_team Find upcoming matches for a specific team. It shows you what's on the horizon. ### list_all_leagues See every league available in the database. Use this to browse global competitions. ### get_league_details Get metadata for a specific league by its ID. This provides the background context for a competition. ### get_league_table Fetch the current standings for a league and season. It gives you the full ranking of teams. ### list_all_sports See all available sports in the database. Use this to understand the scope of the data. ### search_events Look for specific sports events by name. Use this to find matches in a large database. ### search_teams Search for sports teams by name. This is the primary way to find specific team profiles. ## Prompt Examples **Prompt:** ``` Who did Cristiano Ronaldo play for before Real Madrid? ``` **Response:** ``` Ronaldo played for the following clubs before his time at Real Madrid: * **Sporting CP** (Portugal) * **Manchester United** (England) Would you like to see his career milestones or his trophy cabinet next? ``` **Prompt:** ``` Show me the current standings for the NBA. ``` **Response:** ``` Here are the current standings for the NBA: | Team | Wins | Losses | Record | | :--- | :--- | :--- | :--- | | Boston Celtics | 45 | 12 | .789 | | OKC Thunder | 42 | 15 | .736 | | Denver Nuggets | 40 | 17 | .700 | Would you like the specific records for any other teams? ``` **Prompt:** ``` What are the next matches for Arsenal? ``` **Response:** ``` Arsenal has several upcoming fixtures scheduled: * **Arsenal vs Everton** at Emirates Stadium * **Arsenal vs Brighton** at Emirates Stadium * **Arsenal vs Bournemouth** at Emirates Stadium I can get the precise start times for these matches if you'd like. ``` ## Capabilities ### Pull team biographies Get full histories and badges for thousands of professional teams. ### Get live league tables Fetch current standings and member club lists for global competitions. ### Find upcoming match dates Check the next fixtures for specific teams or dates. ### Audit player trophy cabinets Retrieve honors, awards, and milestones for specific athletes. ### List all sports available See every sport covered by the database in one list. ## Use Cases ### Auditing a player's career for a documentary A researcher asks their agent to find every club Lionel Messi played for. The agent uses list_former_teams to provide a full history in seconds. ### Building a weekly sports news summary A journalist asks for all matches happening this Friday. The agent uses list_events_by_day to generate a complete schedule for the day. ### Verifying fantasy league rankings A manager needs to see the current NBA standings. The agent uses get_league_table to pull the latest win and loss records. ### Researching league membership A content creator wants to know every team in the Premier League. The agent uses list_all_teams_in_league to get the full list. ## Benefits - Get accurate team histories using list_former_teams without manual searching through old archives. - Quickly identify all teams in a league with list_all_teams_in_league to see the full competition. - Track upcoming fixtures for specific teams using list_next_events_by_team to stay ahead of the schedule. - Retrieve detailed player honors and trophies with list_player_honours for deep biographical research. - Check current league standings instantly using get_league_table to see who is leading the pack. - Find specific players and teams instantly using search_players and search_teams to save time on navigation. ## How It Works The bottom line is you get instant access to global sports records without ever leaving your chat interface. 1. Subscribe to this Connector on Vinkius. 2. Enter your TheSportsDB API Key in your configuration. 3. Ask your AI client to fetch sports data or league standings. ## Frequently Asked Questions **Can TheSportsDB Global Sports Database find player stats?** Yes, it pulls detailed athlete profiles including biographies, previous clubs, career milestones, and trophy honors. **Does TheSportsDB Global Sports Database work for all sports?** It covers a vast range of global sports and competitions, making it useful for diverse sports reporting. **How do I get league tables with TheSportsDB Global Sports Database?** Just ask your agent to fetch the current standings for a specific league, and it will pull the latest rankings for you. **Can I find old team history with TheSportsDB Global Sports Database?** Yes, it can retrieve information about former clubs and historical career achievements for specific athletes. **Is TheSportsDB Global Sports Database good for live scores?** It provides recent results and upcoming match schedules, which is perfect for staying updated on recent and future games. **Can I use TheSportsDB Global Sports Database for fantasy sports?** It is excellent for fantasy managers who need to quickly check player contracts, honors, and league standings. **Can my AI find the history and official badge of a specific team just by its name?** Yes! Use the `search_teams` tool with the team name. Your agent will respond with complete metadata, founded year, and high-resolution badge URLs in seconds. **How do I check the current standings for a major league like the Premier League?** Simply ask the agent to run the `get_league_table` tool providing the League ID (e.g., 4328 for Premier League) and the current season. It will compile the full standings with points and goal differences. **Does the integration provide video highlights for recent match events?** Yes. Many event results retrieved via tools like `list_last_events_by_team` include a `strVideo` field which contains direct YouTube links to official match highlights when available.