API-Futebol MCP. Pull live scores or historical league data instantly.
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 provides direct access to Brazilian football data. Your agent instantly pulls real-time scores, full championship standings for Brasileirão and Copa do Brasil, match lineups, and historical schedules from any professional club.
It’s a single source for all things South American soccer stats.
What your AI agents can do
Get api status
Checks the current operational status and usage quota of the API server.
Get championship standings
Retrieves the points table for a specific league or championship.
Get cup brackets
Fetches the bracket and phases for an elimination cup competition.
Calls get_api_status to validate the server's operational state and current usage quota.
Gets the full points table, showing team rankings, points, and goal difference for a specific championship using get_championship_standings.
Pulls real-time results, including current score and minute markers, for all matches actively being played right now via get_live_matches.
Retrieves the phase progression and bracket details for any elimination tournament using get_cup_brackets.
Lists all past match results and future fixtures for a specified club using get_team_matches.
Returns a master list of every major football championship operating in Brazil via list_championships.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
API-Futebol MCP Server: 12 Tools for Sports Intelligence
Use these twelve specific functions to pull live scores, track league standings, get team history, and analyze tournament brackets from Brazilian football.
019d8416get api status
Checks the current operational status and usage quota of the API server.
019d8416get championship standings
Retrieves the points table for a specific league or championship.
019d8416get cup brackets
Fetches the bracket and phases for an elimination cup competition.
019d8416get live matches
Gets real-time scores and status updates for all matches currently in play.
019d8416get match details
Retrieves comprehensive data, including lineups and events, for a specific match ID.
019d8416get round details
Gets results and details for all matches played in a single championship round.
019d8416get team matches
Lists the full match history and future schedule for any professional team.
019d8416list championship matches
Lists all scheduled matches that took place or will take place in a specific championship.
019d8416list championship rounds
Gets a list of all defined rounds (e.g., 'Quarter-Finals') for a given league.
019d8416list championships
Retrieves the names and IDs of every major football championship in Brazil.
019d8416list top scorers
Identifies and lists the players with the most goals for a specific tournament.
019d8416search teams
Searches the database by name to find an official record of Brazilian football clubs.
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,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ 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
What you can do with this MCP connector
You’re getting direct access to Brazilian football data through this server. Your agent doesn't just read a spreadsheet; it calls specific functions to give you deep stats, real-time action, and historical context for every major club and league in Brazil.
When you need to know if the connection is solid before running complex queries, use get_api_status. This function checks the server’s current operational status and tells you what your usage quota looks like. You can start by listing all available leagues nationwide with list_championships, which returns every major championship's name and ID.
Need to know who played in Brazil? First, run search_teams to find the official club record using just the team's name. Once you have that club identified, your agent can pull their entire match history and upcoming schedule by calling get_team_matches. You can also ask for all scheduled matches—past or future—within a specific league using list_championship_matches.
For league performance, the server handles standings. You call get_championship_standings when you need the full points table for any championship, showing team rankings, points totals, and goal difference. If you want to break down what happened in a single week, use list_championship_rounds first; that gives you the list of defined rounds (like 'Group Stage' or 'Quarter-Finals').
Then, running get_round_details pulls all the results and details for every match played within that specific round.
Tracking cup tournaments is easy. You use list_championship_matches to see a full schedule of fixtures in any given championship. For elimination cups, you map out the entire structure using get_cup_brackets, which fetches the phase progression and bracket details for those single-elimination events. To find who’s putting up the best numbers across an entire tournament, run list_top_scorers to identify the players with the most goals.
When games are happening right now, your agent gets you live action using get_live_matches. This pulls real-time scores and status updates for every match currently in play. For a specific game that just finished or is paused, use get_match_details to grab comprehensive data—this includes the full lineups and all recorded events for that precise match ID.
It's a single source for everything South American soccer stats: you can check standings with get_championship_standings, pull real-time scores via get_live_matches, map out cup brackets using get_cup_brackets, or get a club’s entire history with get_team_matches. You'll never have to switch data sources.
How API-Futebol MCP Works
- 1 Subscribe to the server and provide your API-Futebol token.
- 2 Your agent calls the required tool (e.g.,
get_match_details) with specific parameters like a match ID or championship name. - 3 The server returns structured data—a JSON object containing scores, standings, or schedules that your AI client processes.
The bottom line is, you don't need to know how the sports database works; you just tell your agent what football info you need, and it handles the rest of the calls.
Who Is API-Futebol MCP For?
Sports journalists, data analysts, and fantasy football managers use this server. If you're tired of manually cross-referencing multiple sports sites just to get a full league table or today's scores, this is for you. It puts structured Brazilian football data directly into your workflow.
Needs get_match_details and list_top_scorers to quickly pull verifiable facts—like who scored the first goal or the full lineup—for an article draft.
Uses get_championship_standings repeatedly to build historical performance models and track league stability across multiple seasons.
Checks team form using get_team_matches and monitors live scores with get_live_matches right before drafting their weekly squad.
What Changes When You Connect
- Stop searching multiple sites for standings.
get_championship_standingsgives you the definitive, single table for Brasileirão Série A, B, C, and D. - Need to know who scored what? Use
get_match_detailsto pull full match reports—including official lineups and goal times—for accurate reporting. - Follow a club's whole journey without leaving your agent.
get_team_matchesgives you every past game and future fixture for any team. - Real-time data means no guesswork.
get_live_matchesprovides instant scores for all games happening right now, making it ideal for live commentary workflows. - Quickly understand the league landscape. Start by running
list_championships, then drill down into specific tournaments usinglist_top_scorersorget_cup_brackets.
Real-World Use Cases
Drafting a Match Preview
A sports journalist needs to write about the upcoming rivalry game between Flamengo and Vasco. Instead of searching, they run search_teams to verify IDs, then use get_team_matches to find their last three fixtures against each other, finishing with list_top_scorers to see who has been hot lately.
Monitoring a Cup Tournament
A user needs to track the final stages of Copa do Brasil. They first call list_championships to confirm the tournament ID, then use get_cup_brackets to see which teams are left in the semi-finals and who they play next.
Building a Live Score Dashboard
A developer needs to power a web widget. They run list_championships for context, then continuously call get_live_matches. This tool feeds the real-time score and minute updates directly into the client.
Analyzing League Stability
A data analyst wants to track relegation trends. They use list_championships to select Série B, then repeatedly call get_championship_standings over several months of simulated time to model potential league shifts.
The Tradeoffs
Assuming one tool covers everything
Trying to get both the overall league table and a single cup's bracket using only list_championships.
→
You need two distinct calls. First, use list_championships to find the correct ID; then, call either get_championship_standings (for leagues) or get_cup_brackets (for cups).
Missing live data
Running list_championship_matches right after a match ends and getting an outdated score.
→
For real-time scores, always use get_live_matches. If the game is over, switch to get_round_details for the final results of that round.
Ignoring team context
Knowing a match happened but not knowing if it was a league game or a cup knockout.
→
Use search_teams to find the club's official record, then use get_team_matches which provides the full context (league vs. cup) for every single fixture.
When It Fits, When It Doesn't
Use this server if your core need involves querying structured data about Brazilian professional football—specifically standings, live scores, or historical match records. It's perfect when you need to answer questions like: 'Who is leading the table right now?' or 'What were the top scorers in Copa do Brasil?'.
Don't use this if you only need basic information that doesn't change (e.g., a list of all active sports leagues globally, which would require an alternative server). If your data requirement is too general, start by using list_championships to narrow the scope down first.
Crucially: if you need current scores, use get_live_matches. If you need a full league table, use get_championship_standings. Don't mix these up.
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.
Available Capabilities
Getting accurate football data shouldn't feel like forensic accounting.
Right now, pulling comprehensive sports stats is a mess. You open one site for standings, another for the live score ticker, and yet a third just to find out who was even playing in the first place. It involves copy-pasting IDs across three different tabs, hoping you didn't miss the 'State League' distinction.
With this MCP server, your agent handles it all. You simply ask for the status of the Brasileirão Série A; the agent calls `get_championship_standings` and gives you a single, accurate table—no cross-site clicking required.
API-Futebol MCP Server: Get precise league and match data.
Before this server, getting a club's entire career history meant jumping between pages for every season. You had to manually track if the game was part of a cup or just a regular round.
Now, one call to `get_team_matches` gives you that whole record in structured data. It’s clean, it’s complete, and it eliminates guesswork entirely.
Common Questions About API-Futebol MCP
How do I check the current league standings using get_championship_standings? +
Just specify the championship ID you want. You need to call list_championships first to get the correct name or code for the table you're looking at.
Does get_live_matches only show major games? +
No, it shows real-time scores for every match currently in play. It covers everything from Brasileirão to smaller State League matches.
What is the difference between list_championship_matches and get_team_matches? +
list_championship_matches gives you all games for a league in a given round. get_team_matches only shows the history/schedule for one specific team.
Can I find the top scorers using list_top_scorers? +
Yes, you can. You just need to tell the tool which championship or cup competition's data you want the leaderboards from.
How do I check my API quota usage using get_api_status? +
It returns your current status and remaining quota. This tool lets you quickly verify if you're hitting rate limits before running complex queries, so you know exactly when to plan for a token refresh.
What should I do if I need to find details for a club that isn’t in the major leagues? Does search_teams help? +
Yes, use search_teams. It allows you to look up Brazilian football clubs by name regardless of their current league status. This is useful for finding teams participating in State Leagues or lower divisions.
I need specific data from a past tournament. How do I get detailed results for a championship round using get_round_details? +
You provide the specific championship and round ID to get_round_details. This retrieves all results, scores, and participating teams solely for that defined period, which is much more precise than general standings.
How do I find out what championships are available? Should I use list_championships first? +
Calling list_championships provides a complete list of all available football competitions in Brazil. Use this tool first to get the correct championship identifier before querying standings or matches.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
HappierLeads
Identify the companies visiting your website and match them to decision-makers for warm outbound prospecting that converts.
PostHog
Analyze product data via PostHog — list insights, track persons, inspect feature flags, and monitor experiments directly from any AI agent.
IBGE Nomes
Access official Brazilian name frequency and ranking data from IBGE — explore popularity by decade, gender, and locality.
You might also like
vCita
Run your small business with online scheduling, payment collection, and client management that keeps everything in one place.
Worksuite
Freelancer management and global contractor onboarding via Worksuite directly through AI.
Hudu
Manage IT documentation, assets, and passwords via Hudu API.