API-Futebol MCP. Access every league stat from Brazilian football.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
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.
What your AI agents can do
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.
Retrieve real-time scores and status updates for all games currently being played in Brazil.
Get the full points table, including team rankings and current league positions, for any major championship.
Fetch a complete record of every match played by a specific club, both past and upcoming.
View the full phases and brackets for cup competitions like Copa do Brasil.
Access leaderboards to see who is scoring the most goals across different tournaments.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
API-Futebol (Brazilian Football) With 12 Tools
These twelve tools let your agent access specific, granular pieces of Brazilian football intelligence, from current scores to historical team records.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using API-Futebol (Brazilian Football) on Vinkius019d8416get api status
Checks the service status and your current usage quota for the API.
019d8416get championship standings
Retrieves the full points table for a specified football league or tournament.
019d8416get cup brackets
Lists the phases and knockout structure for any given cup competition.
019d8416get live matches
Gathers real-time scores and status updates for games that are actively in play.
019d8416get match details
Provides comprehensive information about a single, specific match by its ID.
019d8416get round details
Gets the results and details for all matches played in one particular league round.
019d8416get team matches
Displays a full timeline of match history and future fixtures for any given club.
019d8416list championship matches
Lists all scheduled or played matches within a specific league championship.
019d8416list championship rounds
Shows every round that has occurred or is planned for a championship.
019d8416list championships
Fetches a master list of all available Brazilian football leagues and tournaments.
019d8416list top scorers
Retrieves the names and goal counts for the leading scorers in a championship.
019d8416search teams
Finds Brazilian football clubs by entering their name.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with API-Futebol (Brazilian Football), then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by API-Futebol. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Getting reliable Brazilian football data used to mean switching between five different websites.
If you’re doing sports reporting, remember the manual process. You open ESPN for live scores; then you jump over to a league site just to check standings; next, you find an archive page to look at historical lineups. Copying and pasting data from these disparate sources is slow, error-prone, and frankly, exhausting.
With this MCP, your agent does the heavy lifting. You ask for 'the full record of the Série A,' and it pulls together the standings, live updates, and match details into one coherent answer. The result isn't a messy collage; it’s clean data you can use right away.
Accessing Brazilian football stats with the API-Futebol MCP
You eliminate manual cross-referencing entirely. You don't have to manually look up a team ID, then check its history, and *then* check its standing. The agent manages that entire sequence for you.
Now, complex queries are just conversation. Instead of hours of scraping or API key management, your agent answers the question immediately. It’s that simple.
What you can do with this MCP connector
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.
019d8416-fc64-73c5-b716-d2305a513de0 
How API-Futebol MCP Works
- 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.
The bottom line is: you give your agent a token, and it handles all the complex API calls to deliver clean, actionable sports data.
Who Is API-Futebol MCP For?
Sports journalists who need immediate pre-game lineups; professional fantasy football players tracking micro-metrics; or data analysts building models around league performance. If your job requires knowing exactly where a team stands in the Brasileirão, this is for you.
Pulls historical match details and current lineups to write technical reports or pre-game analysis pieces.
Builds performance models by querying top scorer lists, round details, and overall championship standings for deep insights.
Monitors team schedules and player performance data to make informed weekly lineup decisions.
What Changes When You Connect
- Instant Standings: Never manually check multiple sites for the points table again. Use
get_championship_standingsto pull current league rankings for any Brasileirão division. - Real-Time Coverage: Track active games immediately. The
get_live_matchestool 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_matchesto pull every single fixture—past results and future schedules—in one go. - Deep Dive Data: Identify league leaders easily. The
list_top_scorerstool 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 vialist_championship_rounds, and finally grab specific data withget_round_details.
Real-World 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.
The Tradeoffs
Asking for everything at once
Asking, 'Give me all the scores and standings and history.' The AI client gets confused because it doesn't know which league or date you mean.
→
Be specific. Start by calling list_championships to narrow down the sport/league, then ask for get_championship_standings for that specific championship.
Missing the initial league list
Trying to get standings for 'the biggest league' without knowing its official name or code. The request fails because the API can't find a match.
→
Always check list_championships first. This tells you exactly what leagues are available, which is crucial before running any other data tools.
Assuming continuous play
Asking for live scores when the tournament is paused or in a different state. The agent returns an error because get_live_matches expects games to be actively running.
→
First, check if the league has active rounds using list_championship_rounds. If results are available but no game is playing, use get_round_details instead of assuming a live score.
When It Fits, When It Doesn't
Use this MCP if your workflow requires structured, specific data about Brazilian league play. You need to know who played, when, and what the result was. If you only care about general team news or non-league sports (like baseball stats), don't use this; search for a different data category. However, if your task is complex—say, 'Compare the last five games of Team A against their top scorer list in League X'—this MCP handles that deep, multi-tool query structure perfectly. Don't try to get raw text descriptions of gameplay; stick to structured calls like get_match_details or list_top_scorers. If you only need a single piece of information (like one team's name), use search_teams first before calling any other tool.
Common Questions About API-Futebol MCP
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.