# FantasyData MCP MCP > FantasyData (SportsDataIO) connects your AI client to real-time sports data across NFL, NBA, and MLB. It lets you list active players, fetch detailed profiles for any major league athlete, retrieve full season schedules, or pull live scores for specific dates—all through natural conversation. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** sports-data, real-time-stats, betting-odds, player-intelligence, api-data-feed, sports-analytics ## Description You connect this MCP to your preferred AI client and take control of deep sports data analysis using only chat prompts. Instead of juggling multiple websites or running complex API calls, you simply ask your agent for what you need. You can query the rosters of NFL, NBA, and MLB players, pull historical scores by date, or get detailed player metadata from a single source. This unified access means you don't have to switch context between league sites. Because Vinkius hosts this MCP, your AI client treats all 12 tools as one seamless resource, letting you plan fantasy rosters or analyze game history without any friction. ## Tools ### get_mlb_player_details Retrieves specific profile information for an MLB player. ### get_mlb_schedule Gets the complete schedule of games for a given MLB season. ### get_mlb_scores Pulls final or live scores for specific dates in Major League Baseball. ### get_nba_player_details Retrieves deep profile data and stats for a specific NBA player. ### get_nba_schedule Gets the full schedule of games for a given NBA season. ### get_nba_scores Pulls final or live scores for specific dates in the NBA. ### get_nfl_player_details Retrieves detailed player metrics and status information for an NFL athlete. ### get_nfl_schedule Gets the full schedule of games for a given NFL season. ### get_nfl_scores Pulls final or live scores for specific dates in the NFL. ### list_mlb_players Lists every active MLB player currently rostered. ### list_nba_players Lists all active NBA players available on the current roster. ### list_nfl_players Lists every active NFL player currently signed to a team. ## Prompt Examples **Prompt:** ``` List all active NFL players. ``` **Response:** ``` I've retrieved the NFL player roster. You have over 2,000 active players including 'Patrick Mahomes' (QB, ID: 18877) and 'Justin Jefferson' (WR, ID: 21685). Which team or position should I filter by? ``` **Prompt:** ``` Show me the NBA scores for last night. ``` **Response:** ``` Fetching NBA scores for 2024-04-03... The Lakers beat the Celtics 112-105, and the Warriors won against the Mavericks 120-118. Would you like the box score for any of these games? ``` **Prompt:** ``` Get the MLB schedule for the 2024 season. ``` **Response:** ``` Retrieving 2024 MLB schedule... The regular season consists of 2,430 games starting from March 28th. Opening day featured match-ups like Yankees vs Astros and Dodgers vs Cardinals. ``` ## Capabilities ### Get Roster Lists List all active players for a given league (NFL, NBA, or MLB) to see who's currently eligible. ### Check Player Details Pull deep-dive metadata and performance backgrounds for specific athletes across the three major sports. ### Find Game Scores Query live scores and final results for a specified date in any of the tracked leagues. ### Build Schedules Retrieve full season schedules to plan betting strategies or fantasy drafts months in advance. ## Use Cases ### A bettor needs last night's results. Instead of going to three different sports sites and checking the date filters, the agent handles it. The user asks for scores on a specific date, and the MCP runs `get_nfl_scores` or `get_nba_scores`, spitting out clear winners and final points. ### A fantasy player needs a roster check. The user asks, 'List all active NBA players who play guard.' The agent uses `list_nba_players` first, then filters the data to provide an immediate list of available talent. ### An analyst compares league depth. The analyst needs a comparison of star power. They ask for player details across multiple leagues, prompting the MCP to run `get_nfl_player_details`, then `get_mlb_player_details`, allowing them to compare metadata side-by-side. ### A manager plans a season's betting window. The user asks for the full schedule across two leagues. The agent retrieves both `get_nba_schedule` and `get_mlb_schedule`, giving the manager a complete calendar view to structure their bets. ## Benefits - Analyze players without leaving your chat. You can quickly check player status or retrieve specific profiles using tools like `get_nba_player_details` or `get_nfl_player_details`. - Plan months ahead by getting full season schedules for all three leagues. Use the dedicated schedule tools (`get_mlb_schedule`, `get_nba_schedule`, etc.) to map out potential game days. - Keep up with live action. Instantly check scores from any major league, whether it's the NBA or NFL, using specific score retrieval tools like `get_nfl_scores`. - Cross-reference data effortlessly. The MCP unifies access, letting you pull player details and schedule info for MLB, NBA, and NFL all in one conversation thread. - Go beyond simple lookups. You can list entire rosters using functions like `list_mlb_players`, which provides a complete starting point for deeper analysis. ## How It Works The bottom line is you get immediate answers to complex sports questions without leaving your chat interface. 1. Subscribe to this MCP and provide your SportsDataIO API Key. 2. Your AI client handles the rest. You ask a question—like 'What were the NBA scores for last Saturday?' 3. The MCP runs the necessary tool (e.g., `get_nba_scores`) and sends back clean, structured data that your agent summarizes. ## Frequently Asked Questions **How do I use get_nba_player_details for a player's stats?** You tell your agent which specific NBA player and season you want. The MCP runs the tool to retrieve deep, detailed metadata about that athlete instantly. **What tools do I use to find scores for multiple sports?** Use `get_nfl_scores`, `get_nba_scores`, and `get_mlb_scores` in the same prompt. The agent knows how to run all three separate checks against the required date. **Can list_nfl_players show me active players for a whole season?** The `list_nfl_players` tool lists all *currently* active players. For roster changes over a full season, you'd need to check the schedules using `get_nfl_schedule`. **What is the difference between list_mlb_players and get_mlb_player_details?** The `list_mlb_players` tool gives you a full roster count. The `get_mlb_player_details` tool requires an ID to pull deep, specific performance metrics on one player. **What credentials do I need to successfully run a query like `get_mlb_player_details`?** You must provide your SportsDataIO API Key. This key is entered during the Vinkius subscription setup for this MCP. Your agent uses it to authenticate and pull specific MLB player data when you prompt for details. **If I use `get_nba_scores` and receive zero results, what does that mean?** It means no game scores were reported or available for the exact date provided. Check if the league is active on that day, or try querying adjacent dates to pinpoint when the match took place. **How can I use `get_nfl_scores` to build a history of team performance across seasons?** The tool pulls scores only for a single date. To analyze multiple years, you must instruct your AI client to cycle through the necessary dates and feed those results into your agent for comprehensive comparison. **When I run `list_nba_players`, how do I get the most relevant subset of data?** The MCP retrieves the entire active roster. For better performance, refine your prompt to include filters like 'only guards' or 'players on team X.' This narrows the initial data pull efficiently. **How do I obtain a SportsDataIO (FantasyData) API Key?** You can sign up for a free trial or a paid plan at [**sportsdata.io**](https://sportsdata.io/developers). Once registered, you can find your API key in the developer portal dashboard. **Does this support live scores during games?** Yes! The `get_scores` tools for NFL, NBA, and MLB retrieve the most recent game data available for the specified date, including live updates if supported by your API plan. **Can I search for players in multiple sports?** Absolutely. This integration provides dedicated tools for NFL, NBA, and MLB player directories, allowing you to query rosters across all three major sports.