# API-Futebol MCP for AI Agents AI Agent Connect > API-Futebol is the definitive data source for Brazilian football. It connects your agent to real-time scores, standings, and match details for the Brasileirão, Copa do Brasil, and various State Leagues. Whether you're tracking the national top flight or local regional cups, this Connector puts the full scope of South American soccer at your fingertips. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ySUOtDxGQICYq4ZrY4z5DfQxHF632iCTor3HlZdb/ai-agent-connect - **Tags:** brazilian-football, match-lineups, tournament-brackets, live-scores, sports-intelligence, league-data ## Description You're tired of jumping between different sports websites to piece together a match preview or check a league table. It's a constant loop of opening tabs, copying scores, and trying to remember which team won that regional cup last weekend. This Connector changes that by putting the entire landscape of Brazilian soccer into a single conversation. Instead of hunting for data, you just ask your agent to pull it. You can get the latest scores from the Brasileirão or dig into the specific brackets of a cup competition without leaving your workspace. It handles the heavy lifting of gathering stats, so you can focus on the analysis. Because Vinkius makes it easy to manage dozens of these connections in one place, you can keep your football intelligence organized while your agent handles the data fetching. It's about having a scout that never sleeps, ready to provide every lineup, goal tally, and historical fixture the moment you ask for it. ## Tools ### get_cup_brackets Get the phases and brackets for a cup competition. This clarifies how teams move through knockout stages. ### list_championships List all available football championships in Brazil. This gives you a complete overview of the soccer landscape. ### get_live_matches Get real-time scores for matches currently in play. This is perfect for staying updated on live action. ### get_match_details Pull full details for a specific match ID. Use this to get the deep stats on any single game. ### list_championship_matches List all matches for a specific championship. This helps you see the full scope of a league's schedule. ### get_round_details Get results for a specific championship round. Use this to see how the league is moving week by week. ### list_championship_rounds List all rounds for a specific championship. This gives you a clear view of the entire season structure. ### list_top_scorers Get the leading goal scorers for a championship. This is the fastest way to see who is leading the pack. ### get_championship_standings Get the points table for a specific championship. Use this to see current leaders and relegation zones. ### get_api_status Check the API status and quota usage. Use this to keep your connection running smoothly. ### get_team_matches Get the match history and schedule for a specific team. This provides a full look at a club's season. ### search_teams Search for Brazilian football clubs by name. Use this to find the correct ID for any team in the country. ## Prompt Examples **Prompt:** ``` What's the current situation in the Brasileirão Série A? ``` **Response:** ``` ### Brasileirão Série A Standings | Rank | Team | Points | Played | |------|------|--------|--------| | 1 | **Palmeiras** | 62 | 28 | | 2 | **Botafogo** | 60 | 28 | | 3 | **Flamengo** | 58 | 28 | Palmeiras is currently leading the table. Would you like to see the full standings, including the relegation zone? ``` **Prompt:** ``` Give me the live scores for Brazil right now. ``` **Response:** ``` ### Live Match Updates I found **3 active matches** currently in progress: * **Corinthians vs São Paulo**: 1 - 1 (75th minute) * **Santos vs Santos FC**: 0 - 0 (12th minute) * **Vitória vs Bahia**: 2 - 1 (44th minute) Would you like the live lineups for any of these games? ``` **Prompt:** ``` Who are the top scorers in the Copa do Brasil? ``` **Response:** ``` ### Copa do Brasil Top Scorers Here are the leading scorers for the current tournament: * **Player Name** (Club A): 7 goals * **Player Name** (Club B): 5 goals * **Player Name** (Club C): 4 goals I have the full top 10 list. Shall I provide their club details as well? ``` ## Capabilities ### Get live scores Retrieve real-time scores for matches currently in play across Brazil. ### Pull match lineups Get the official starting squads and substitutions for specific games. ### Check league standings View current points tables for the Brasileirão and other major championships. ### Fetch club histories Access full match records and upcoming schedules for any Brazilian club. ### Track top scorers Identify the leading goal scorers for specific tournaments and leagues. ### View cup brackets See the phases and knockout brackets for major Brazilian cup competitions. ## Use Cases ### Rapid match recap writing A journalist needs to write a recap of a State League game and asks the agent to pull the final score and top scorers using `get_live_matches` and `list_top_scorers`. ### Fantasy league monitoring A fantasy player wants to know who is leading the goal count in the Copa do Brasil and asks for the leaderboard using `list_top_scorers`. ### Club season planning A sports bettor needs to see the full schedule for a specific club over the next month using the `get_team_matches` tool. ### Tournament structure mapping A sports app developer wants to see all available championships in Brazil to map out a new league tracking feature using `list_championships`. ## Benefits - Stop manual tab switching by using `get_live_matches` to see scores from the Brasileirão and State Leagues in one place. This saves you from hunting through multiple sports sites every time a goal is scored. - Build accurate match previews faster by pulling official lineups and `get_match_details` directly into your notes. You can skip the manual copy-pasting and move straight to the technical analysis of the game. - Track your favorite club's progress with `get_team_matches`, which combines historical results and future schedules. It gives you a complete view of where a team has been and where they are headed next. - Analyze tournament progress by pulling `get_cup_brackets` to see exactly how teams move through various phases. This is perfect for tracking complicated cup journeys without getting lost in the brackets. - Monitor player performance with `list_top_scorers` to identify the most productive athletes in any championship. You can quickly see who is leading the pack without digging through individual match logs. - Stay updated on league movements by using `get_championship_standings` to see point totals and relegation zones instantly. It keeps you on top of the table shifts as the season progresses in real time. ## How It Works The bottom line is you get instant, accurate Brazilian football data without the manual searching. 1. Subscribe to the Connector via the Vinkius Marketplace. 2. Enter your API-Futebol token from the developer portal into your client. 3. Ask your agent for specific Brazilian football data like scores or standings. ## Frequently Asked Questions **Does API-Futebol cover the Brasileirão?** Yes, it provides comprehensive data for the Brasileirão Série A, B, C, and D. You can pull standings, match histories, and live scores for all four divisions. **Can I get live scores for State Leagues?** Yes, the Connector tracks all major State Championships in Brazil. You can check live scores and results for regional leagues just as easily as national ones. **Can it show me cup brackets?** Yes, you can pull the phases and brackets for cup competitions like the Copa do Brasil. It helps you see exactly how teams move through the tournament. **Is this for all of South America?** This Connector is specifically focused on Brazilian football. It provides the deepest level of detail for Brazilian leagues, cups, and regional championships. **Does it show team schedules?** Yes, you can ask your agent for a specific club's match history or their upcoming schedule to see what's on the horizon for your favorite team. **Can I get official lineups for games?** Yes, the Connector can retrieve official match lineups, allowing you to see the starting squads and tactical setups for specific games. **Can my AI automatically find the current G-4 of Brasileirão Série A?** Yes! Use the `get_championship_standings` tool with the ID for Série A (e.g., 10). Your agent will respond with the top 4 teams, their points, and current win streaks in seconds. **How do I check the match history between Flamengo and Fluminense?** You can ask the agent to search for both teams to get their IDs and then run `get_team_matches` for either club. It will compile all recorded results, allowing the AI to analyze the head-to-head performance. **Are live scores for State Championships (Estaduais) available?** Absolutely. The `get_live_matches` tool monitors all ongoing professional matches in Brazil covered by your plan, including Paulistão, Carioca, and other state-level competitions.