# Cartola FC MCP MCP > Cartola FC provides deep access to Brasileirão Série A data, letting you audit player scouts, track market status, and check live scores for your fantasy football team. It's a dedicated resource for serious fantasy strategists who need real-time stats on players, clubs, and leagues. ## Overview - **Category:** data - **Price:** Free - **Tags:** cartola-fc, fantasy-football, brasileirao-stats, player-scouts, mercado-cartola ## Description This MCP gives your agent the depth of a professional sports scout, pulling live data directly from the Globo database. You stop searching multiple websites to compile stats; instead, you ask questions and get actionable insights about player performance and market value for the Brasileirão Série A. The system lets you audit entire club rosters or narrow down players by position (like finding cheap defenders). It tracks who's playing this round, who was selected most often, and even checks if the overall market is open. This kind of deep, multi-source data analysis is critical for winning. When you use Vinkius to run these queries, your agent can chain together multiple steps—for instance, checking the current market status before running a search for high-scoring players—building complex strategies that span across different data points. ## Tools ### get_market_status Checks if the overall Cartola FC market is currently operational for betting or transfers. ### get_user_team_by_slug Pulls specific details and performance records for a user's team using its unique identifier (slug). ### list_cheap_players Finds and lists players who have low prices, identifying potential bargains. ### list_clubs Provides a complete list of all club names and their associated IDs within the system. ### list_players_by_club Retrieves every player roster belonging to a specified football club. ### list_players_by_position Lists available players, filtered by their role on the field (GK, DEF, MID, FWD). ### list_probable_players Identifies and lists all players who are marked as 'Probable' to play in the current match. ### list_round_scorers Gathers real-time, up-to-the-minute scoring data for every player participating this round. ### list_top_average_players Lists players who have the highest season averages based on performance metrics. ### list_top_scaled_players Determines and lists the most selected players across all user teams for this round. ### search_leagues Searches for specific public or private leagues using their name to find relevant groups. ### search_players Finds players by searching against their known nicknames or player names. ## Prompt Examples **Prompt:** ``` List all 'Probable' players from Flamengo for this round. ``` **Response:** ``` I've filtered the market data for Flamengo (ID: 262). I found 8 players currently marked as 'Probable', including Hulk and Arrascaeta. Would you like to see their prices and season averages? ``` **Prompt:** ``` Who are the top 5 most selected players in Cartola FC right now? ``` **Response:** ``` Running the highlights query... The most selected player is 'Player X' with over 1.2 million selections. I have the full top 5 list with their club details. Shall I provide the summary? ``` **Prompt:** ``` Find all defenders priced below 10 cartoletas with an average above 4.0. ``` **Response:** ``` Inspecting the market... I found 4 defenders matching your criteria, including 'Defender Y' (Price: 8.5, Avg: 4.8). Would you like to see their specific scouts for the last match? ``` ## Capabilities ### Check Market Status Determines if the Cartola FC betting and player market is currently open or closed. ### Identify Player Bargains Lists players who have low prices, helping you find value targets for your team. ### Track Performance Metrics Retrieves granular stats on athletes, including tackles, passes, and goal involvements. ### Analyze Top Performers Identifies players with the highest season averages or those most selected in the current round. ### Search League Data Locates specific public or private fantasy leagues and reviews user team setups. ## Use Cases ### Building a Week 1 Lineup A strategist needs to build a team and wants high-value players who aren't overhyped. The agent runs `list_players_by_position` for DEF and MID, then filters that list by calling `list_cheap_players`, ensuring the core of the team is affordable while still performing well. ### Researching a New League A community manager joins a new league. They use `search_leagues` to find the group, then call `list_players_by_club` for all teams in that league to quickly assess the overall quality of competition. ### Checking Player Availability Before making a major bet, an agent first calls `get_market_status`. If it's closed, the system immediately stops and informs you. This prevents wasting time when the market is paused. ### Comparing Team History A user wants to compare their team against a rival's performance. They use `get_user_team_by_slug` on both teams to pull side-by-side historical data and see who has performed better over the last five rounds. ## Benefits - Stop guessing. Use `list_top_scaled_players` to see exactly who other managers are picking, giving you a massive edge in drafting. - Time is money. You can immediately check if the market is open using `get_market_status`, so your agent doesn't waste time querying closed data. - Find hidden gems with `list_cheap_players`. Instead of wading through expensive stars, you get a list of value bargains to build around. - Deep dive into performance. The MCP lets you pull granular stats via tools like `list_top_average_players` and `list_round_scorers`, moving beyond simple goal counts. - Manage your group data. You can use `search_leagues` first, then audit specific user teams with `get_user_team_by_slug` for easy league tracking. ## How It Works The bottom line is you ask for the strategy; the MCP handles all the necessary database lookups to deliver the answer. 1. Connect your preferred AI client to this MCP in the Vinkius platform. 2. Ask a natural language query, like 'What are the most probable forwards under 10 cartoletas?' 3. The agent executes multiple background calls and returns structured data directly into your chat window. ## Frequently Asked Questions **How do I check if the Cartola FC market is open using `get_market_status`?** You simply ask your agent to run the `get_market_status` tool. It returns a clear status, telling you immediately whether you can bet on or track live player movements. **What is the best way to find bargain players with `list_cheap_players`?** Use `list_cheap_players` and then combine that list with a query using `list_top_average_players`. This lets you filter for low-cost players who still maintain high seasonal averages. **Can I search for leagues in the system? How does `search_leagues` work?** Yes, use `search_leagues` and provide the league name. The tool finds public or private groups by name, allowing you to access their specific roster data. **Which players are most likely to play this round? Do I need `list_probable_players`?** Yes, run `list_probable_players`. This tool filters out the uncertainty and gives you a definitive list of who is expected to be on the field for scoring. **If I want details on a specific user’s team, how do I use `get_user_team_by_slug`?** You retrieve the full roster and performance data for a known user team. This tool pulls all records associated with a unique slug identifier. It lets you audit a single, established fantasy squad instantly. **How can I list every player from a specific club using `list_players_by_club`?** You get the complete roster of players belonging to one team. Simply provide the club ID or name and this MCP pulls all associated athletes. It's useful for analyzing a club’s entire talent pool. **I need to find high-value, consistent performers; how do I use `list_top_average_players`?** This tool gives you players with the highest season averages across all recorded matches. It focuses on long-term performance metrics rather than just current round popularity. Use it for deep statistical value checks. **What is the fastest way to check live scores during the game using `list_round_scorers`?** You get real-time, updated scoring data for the current matchday. This tool bypasses market speculation and provides immediate results as they happen. It's critical when you need instant score validation.