# API-Futebol MCP MCP > API-Futebol (Brazilian Football) is your dedicated data source for Brazilian soccer. Track Brasileirão, Copa do Brasil, and every major State League live. Get real-time scores, official standings tables, complete match history, and top scorer leaderboards instantly via your AI agent. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** brazilian-football, match-lineups, tournament-brackets, live-scores, sports-intelligence, league-data ## Description Need deep stats on Brazilian football? This MCP gives your agent instant access to everything from the Brasileirão Série A through local state cups. You can get current live scores for any game happening now, check detailed championship standings at a glance, or map out a team's entire season journey. It’s like having an expert scout who knows every league and tournament in Brazil. The data goes beyond just win/loss records; you pull precise metadata, full match lineups, and historical context. Using this MCP through Vinkius means your agent connects to the authoritative source for South American soccer stats, letting you run complex analysis without juggling multiple websites or APIs. ## Tools ### get_api_status Checks the service status and your current usage quota for the API. ### get_championship_standings Retrieves the full points table for a specified football league or tournament. ### get_cup_brackets Lists the phases and knockout structure for any given cup competition. ### get_live_matches Gathers real-time scores and status updates for games that are actively in play. ### get_match_details Provides comprehensive information about a single, specific match by its ID. ### get_round_details Gets the results and details for all matches played in one particular league round. ### get_team_matches Displays a full timeline of match history and future fixtures for any given club. ### list_championship_matches Lists all scheduled or played matches within a specific league championship. ### list_championship_rounds Shows every round that has occurred or is planned for a championship. ### list_championships Fetches a master list of all available Brazilian football leagues and tournaments. ### list_top_scorers Retrieves the names and goal counts for the leading scorers in a championship. ### search_teams Finds Brazilian football clubs by entering their name. ## Prompt Examples **Prompt:** ``` Show me the current standings for the Brasileirão Série A. ``` **Response:** ``` I've retrieved the Série A standings. Currently, Palmeiras is leading with 62 points, followed closely by Botafogo. Would you like to see the full table including the relegation zone? ``` **Prompt:** ``` Which Brazilian football matches are happening live right now? ``` **Response:** ``` Running the live query... I found 3 active matches. In the Brasileirão, Corinthians is drawing 1-1 with São Paulo (75'). I also found two State League matches. Would you like the live lineups for the Corinthians game? ``` **Prompt:** ``` Get the top scorers list for the latest Copa do Brasil. ``` **Response:** ``` Inspecting the scoring charts... I've retrieved the top scorers for the Copa do Brasil. Currently, the leader is 'Player Name' with 7 goals. I have the full list of the top 10. Shall I provide their club details as well? ``` ## Capabilities ### Track Live Match Data Retrieve real-time scores and status updates for all games currently being played in Brazil. ### Audit League Standings Get the full points table, including team rankings and current league positions, for any major championship. ### Analyze Team History Fetch a complete record of every match played by a specific club, both past and upcoming. ### Map Tournament Structure View the full phases and brackets for cup competitions like Copa do Brasil. ### Identify Key Players Access leaderboards to see who is scoring the most goals across different tournaments. ## Use Cases ### Pre-Match Scouting Report A journalist needs to write a deep dive on the Série B final. They ask their agent, 'Give me the last five matches for both teams.' The agent uses `get_team_matches` and `get_match_details` to compile a full tactical report instantly. ### Tracking Cup Progress A fan wants to know if their favorite team made the semi-finals of Copa do Brasil. They ask for the bracket, and the agent uses `get_cup_brackets` to show the entire tournament flow. ### Checking Current League Status An analyst needs to verify which leagues are active today. They start by calling `list_championships` to get a master list, then use `get_live_matches` to see what's playing right now. ### Identifying Goal Hotspots A bettor wants to find the most prolific players. They simply ask for 'The top 10 scorers for this month.' The agent uses `list_top_scorers` to get the definitive list. ## Benefits - Instant Standings: Never manually check multiple sites for the points table again. Use `get_championship_standings` to pull current league rankings for any Brasileirão division. - Real-Time Coverage: Track active games immediately. The `get_live_matches` tool gives you live scores and match status as they happen, perfect for breaking news reports. - Full Season Context: Need to know a team's whole story? Use `get_team_matches` to pull every single fixture—past results and future schedules—in one go. - Deep Dive Data: Identify league leaders easily. The `list_top_scorers` tool gives you the names and goal totals for championship scoring charts. - Structured Navigation: Start broad and narrow down fast. First, use `list_championships`, then drill into rounds via `list_championship_rounds`, and finally grab specific data with `get_round_details`. ## How It Works The bottom line is: you give your agent a token, and it handles all the complex API calls to deliver clean, actionable sports data. 1. Subscribe to this MCP and grab your API-Futebol token from their developer portal. 2. Input that token into your preferred AI client (like Claude or Cursor). 3. Ask your agent for specific data, such as 'What are the current standings for Série A?' The agent then executes the necessary tools using the live connection. ## Frequently Asked Questions **How do I find out which leagues are available using list_championships?** You call `list_championships` to get a master list of all active Brazilian football tournaments. This initial list tells you what data sets the API can access, so you know exactly where to start your query. **What is the difference between get_round_details and get_match_details?** `get_round_details` gives you a summary of all results for an entire day or round (e.g., 'Match 1 finished, Match 2 finished'). `get_match_details`, however, requires a specific match ID to give deep info on just that one game. **Can I track live scores without knowing the league name? Use get_live_matches.** No. While you can call `get_live_matches`, it's best practice to first use `list_championships` to confirm which leagues are active. This ensures your agent is looking for games in a currently relevant competition. **I need historical team data, what tool should I use? Use get_team_matches.** Use `get_team_matches`. It pulls the full timeline of every game—past results and future fixtures—for any specific club ID you provide. This is better than listing all matches for a championship. **How do I check my quota or see if there are API limits using get_api_status?** It immediately returns your current usage and remaining credits. This is essential for managing costs and preventing service interruptions due to hitting rate limits. **If I only know the name of a club, how do I find its official ID using search_teams?** The tool executes a simple text search across all registered Brazilian clubs. It returns match records and IDs, allowing you to pull specific data for any team later on. **What is the difference between general league matches and cup phases when using get_cup_brackets?** This tool structures knockout tournaments into clear brackets and phases. Unlike regular season play, it tracks elimination rounds to determine a champion winner through single-elimination structure. **How can I list every single match scheduled for a championship using list_championship_matches?** This function pulls the complete historical and future fixture list for an entire league. You get a comprehensive record of all matches, not just those currently happening or scheduled for this week.