# SportDB MCP for AI Agents AI Agent Connect > SportDB gives your AI agent live access to sports data. It pulls real-time scores, league standings, and deep player stats across football, basketball, hockey, and tennis. Use it to get immediate updates on match progress, historical team records, and detailed transfer histories without leaving your workspace. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_uW9mHK2ANcNnadcHX4Cr2mVi2FcxdTIlIFMiVxxk/ai-agent-connect - **Tags:** live-scores, sports-data, league-standings, match-fixtures, real-time-updates, player-statistics ## Description You want your agent to know what's happening on the field right now, but most AI models are stuck in the past or have to hallucinate numbers from old training data. SportDB fixes that by connecting your agent to a live feed of global sports data. Instead of copy-pasting scores from five different websites, you can just ask for the current standings in the Premier League or see who's leading the NBA. It handles the heavy lifting of navigating through different countries, leagues, and seasons to find the exact match or player profile you need. If you're a sports journalist, you can pull a club's full roster or a player's entire transfer history in seconds. It's a way to turn a generic chat into a dedicated sports research desk. You can find this in the Vinkius catalog to get it running in your workspace quickly. It works across multiple sports, so you don't need a different setup for hockey or tennis. It's about getting accurate, real-time numbers so you can focus on the analysis instead of the data entry. This is especially useful when you need to compare historical seasons or check specific match stats like substitutions and lineups. You get a reliable source of truth that updates as the games do. No more manual searching or worrying about outdated stats. ## Tools ### get_club_players Lists all players currently on a specific club's roster. Use this to see who is currently signed to a team. ### get_club_profile Retrieves the full profile of a club using its unique ID. This gives you a complete overview of a team's identity. ### get_competition_seasons Lists all available seasons for a specific competition. Use this to find the correct year for standings or fixtures. ### get_country_competitions Lists all leagues and cups available in a specific country for a sport. This helps you navigate regional sports. ### get_fixtures Gets the schedule and scores for completed or upcoming matches in a season. It works for any specific league. ### get_match Provides detailed information for a specific match using its ID. Get everything from scores to basic match facts. ### get_match_lineups Shows the starting players and substitutions for a specific game. It's great for seeing who is actually on the pitch. ### get_match_stats Pulls in-match statistics for a specific game. Use this to see how the game is unfolding in real time. ### get_player_profile Retrieves the full profile of a player using their unique ID. This gives you a deep look at a player's background. ### get_player_stats Pulls career and seasonal statistics for a specific player. It's the best way to check a player's performance over time. ### get_player_transfers Shows the full transfer history for a specific player. See every move they have made throughout their career. ### get_standings Fetches the current league table for a specific competition and season. This tells you exactly who's at the top. ### list_countries Lists all countries available for a specific sport like football or hockey. This is your starting point for global data. ### get_live_basketball Provides real-time scores for ongoing basketball games like the NBA. It gives you the latest score updates instantly. ### get_live_football Provides real-time scores for ongoing football matches. Get the latest goals and scores as they happen. ### get_live_hockey Provides real-time scores for ongoing ice hockey games. Stay updated on NHL or KHL results in real time. ### search_clubs Finds clubs by name to get their IDs for further queries. Use this to quickly identify a team before looking up its roster. ### search_players Finds players by name to get their IDs for further queries. Use this to quickly identify a pro before checking their stats. ## Prompt Examples **Prompt:** ``` Show me the live football scores right now. ``` **Response:** ``` I've retrieved the live matches. There are currently 4 active games: * **Manchester City 2–1 Arsenal** (67') * **Real Madrid 0–0 Atlético Madrid** (32') * **Flamengo 1–0 Palmeiras** (55') * **Bayern Munich 3–2 Dortmund** (81') Would you like me to pull the match stats for any of these? ``` **Prompt:** ``` Search for Erling Haaland and show me his transfer history. ``` **Response:** ``` Found Erling Haaland (ID: 48291). Here is his transfer history: * **Bryne FK** $\rightarrow$ **Molde FK** (Jan 2017) * **Molde FK** $\rightarrow$ **Red Bull Salzburg** (Jan 2019, €5M) * **Red Bull Salzburg** $\rightarrow$ **Borussia Dortmund** (Jan 2020, €20M) * **Borussia Dortmund** $\rightarrow$ **Manchester City** (Jul 2022, €60M) Would you like to see his seasonal statistics? ``` **Prompt:** ``` Get the La Liga standings for the 2024-2025 season. ``` **Response:** ``` Here are the La Liga 2024-2025 standings: 1. **Barcelona** — 52 pts (W16 D4 L2) 2. **Real Madrid** — 48 pts (W15 D3 L4) 3. **Atlético Madrid** — 43 pts (W13 D4 L5) The table includes 20 teams with full records. Want me to pull the upcoming fixtures for any of these clubs? ``` ## Capabilities ### Pull live scores Get real-time updates for ongoing football, basketball, hockey, and tennis matches. ### Fetch league tables Retrieve full standings with points, wins, losses, and goal differences. ### Browse match schedules Check completed results and upcoming fixtures for any season. ### Access match lineups See starting players, formations, and live substitutions. ### Retrieve club profiles Get full team data including stadium info and current rosters. ### View player statistics Pull career stats, seasonal averages, and complete transfer histories. ## Use Cases ### Live match reporting for journalists A journalist needs to know the current NBA score and the top 3 teams in the standings. They ask the agent and get the data instantly using get_live_basketball and get_standings. ### Fantasy league player research A fantasy manager wants to see Erling Haaland's transfer history and current season stats. The agent pulls these details using search_players and get_player_stats. ### Sports data app development A developer wants to build a sports app and needs to fetch all competitions in Spain for football. They use get_country_competitions to map out the leagues. ### Real-time hockey betting analysis A bettor needs to see the live hockey scores and current match stats for the NHL. They use get_live_hockey and get_match_stats to monitor the game. ## Benefits - Get real-time scores for football, basketball, and hockey without checking multiple apps by using get_live_football or get_live_basketball. - Pull full league standings using get_standings to see who's leading the table instantly. - Access deep player history with get_player_transfers to see every move a pro has made throughout their career. - View live match lineups with get_match_lineups to see who's starting on the field during a game. - Research clubs quickly using search_clubs to find IDs for roster and profile lookups. - Automate data collection for sports reports by pulling fixtures and stats into one chat. ## How It Works The bottom line is you get live, accurate sports data in your chat without manual searching. 1. Subscribe to this Connector and grab your API key from the SportDB dashboard. 2. Plug the key into your AI client's configuration. 3. Ask your agent for scores, standings, or player stats. ## Frequently Asked Questions **Can SportDB provide real-time scores for the NBA?** Yes, it provides live basketball scores including the NBA and EuroLeague. Your agent can pull the current score and match status as it happens. **Does SportDB support soccer and football?** Yes, it covers live football scores, league standings, and detailed match statistics for leagues around the world. **Can I use SportDB to find player transfer histories?** Yes, you can ask your agent to pull the complete transfer history for any specific player. It will show you every move they have made in their career. **Does SportDB work for hockey and tennis too?** Yes, it includes live scores and data for both ice hockey and tennis, making it a versatile tool for multi-sport fans. **How do I get league standings with SportDB?** You can simply ask your agent for the standings of a specific league and season. It will return a full table with points, wins, draws, and losses. **Can SportDB help me with fantasy sports research?** Absolutely. You can use it to check player stats, current rosters, and match lineups to help you make better decisions for your fantasy teams. **Can my AI agent show me live football scores while I work?** Yes! Simply ask your agent to run the `get_live_football` tool and it will instantly retrieve all ongoing matches with real-time scores, minute markers, and status updates. You can also use `get_live_basketball` or `get_live_hockey` for other sports. **How do I find the Premier League standings for the current season?** Navigate the hierarchy: first use `list_countries` with sport 'football', then `get_country_competitions` for 'england', then `get_competition_seasons` for 'premier-league', and finally `get_standings` with the season slug. Your agent can chain these steps automatically from a simple question like 'Show me the Premier League table'. **Can the integration modify any data on SportDB, or is it strictly read-only?** All 18 tools are strictly read-only query operations. The integration cannot create, update, or delete any data on SportDB. Your API key is used solely for authenticated reads, ensuring your account remains safe from any destructive operations.