# Cartola FC MCP

> Cartola FC tracks live market data, player values, and performance stats for Brasileirão Série A fantasy football. Check current round deadlines, find bargain players, list top scorers, and audit specific team lineups using real-time Globo database access.

## Overview
- **Category:** data
- **Price:** Free
- **Tags:** cartola-fc, fantasy-football, brasileirao-stats, player-scouts, mercado-cartola

## Description

This MCP turns your AI client into a professional sports strategist. Forget juggling multiple tabs and scraping unreliable scores; this tool gives you deep, structured access to the entire Cartola FC market. You can ask it to check live status updates or pull granular stats like tackles and passes for any player. It's designed so your agent acts like a dedicated scout, whether you're trying to find high-value players or just tracking league standings.

When you connect this MCP through Vinkius, you get the full depth of data—from searching public leagues to auditing specific team rosters and identifying which players are currently considered 'Probable.' It lets your agent handle all the complex statistical audits in plain conversation. You simply tell it what you need, and it handles the market complexity behind the scenes.

## Tools

### list_top_average_players
Shows players who have accumulated the highest performance averages throughout the season.

### list_cheap_players
Generates a list of players who currently cost very little, identifying potential bargains.

### list_players_by_club
Lists all players associated with a specific football club name or ID.

### list_clubs
Retrieves the full names and IDs for every club participating in the league.

### search_leagues
Searches for public or private fantasy leagues by name to find specific groups.

### list_round_scorers
Retrieves real-time scoring updates and highlight data for the current fantasy round.

### list_players_by_position
Filters and lists available players based on their role: Goalkeeper, Defender, Midfielder, or Forward.

### list_probable_players
Presents a list of players that are currently marked as 'Probable' for the active round.

### search_players
Finds players quickly using only their nickname.

### get_market_status
Checks whether the overall Cartola FC market is open to activity.

### get_user_team_by_slug
Pulls all details for a specific user's team using its unique identifier.

### list_top_scaled_players
Identifies and lists the most selected or popular players among all participants for this round.

## 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

### Assess Market Readiness
Check if the Cartola FC betting market is currently open for submissions or updates.

### Analyze Player Performance Metrics
Retrieve detailed stats, including tackles, passes, and goal involvement, for any athlete in the league.

### Identify Bargains and Top Performers
List players who are priced low compared to their value or identify those with the highest season averages across all available data.

### Track Player Availability
Get lists of players marked as 'Probable' for the current round, helping prevent selecting inactive athletes.

### Audit Teams and Leagues
Search for public or private fantasy leagues by name, or pull specific team rosters for detailed comparative analysis.

## Use Cases

### Finding the perfect budget player
A strategist needs a defender who scores points but costs less than expected. They ask: 'Show me defenders priced below 10 cartoletas with an average above 4.0.' The agent uses `list_players_by_position` and filters by price/average to deliver precise scouting data.

### Auditing a specific league's standings
A community manager needs to report on the top teams in their private group. They use `search_leagues` to find the league ID, then call `get_user_team_by_slug` to retrieve and summarize that team's historical performance metrics.

### Predicting round winners
A journalist needs a quick summary of the most hyped players. They ask for 'the top 5 most selected players.' The agent runs `list_top_scaled_players` and gives them the list, immediately followed by a check using `list_round_scorers` to see who actually scored.

## Benefits

- Stop guessing on team building. Use `list_top_average_players` to see who delivers consistent, high-level performance throughout the season.
- Build a championship roster without overspending. Run `list_cheap_players` first to spot bargain players you can add to your lineup immediately.
- Manage large groups easily. You can use `search_leagues` to find private leagues and then `get_user_team_by_slug` to audit specific team rosters for comparison.
- Stay ahead of injury news. Use `list_probable_players` to filter out athletes who might not play, keeping your lineup accurate round after round.
- Understand market hype versus actual value. Check `list_top_scaled_players` to see which players everyone is picking, then cross-reference that with their true performance using `list_round_scorers`.

## How It Works

The bottom line is that you get direct access to complex sports analytics without writing any code or dealing with API calls.

1. First, subscribe to this MCP through Vinkius.
2. No API key is needed for accessing public market data.
3. Then, start talking to your AI client and ask it to perform a specific audit (e.g., 'What are the top 5 most selected players?') using natural language.

## Frequently Asked Questions

**How do I find cheap players using list_cheap_players?**
The `list_cheap_players` tool shows you exactly who is low-priced. You can then cross-reference that list with a high average score from the `list_top_average_players` tool to pinpoint true bargains.

**Do I need an API key for get_market_status?**
No, you don't. The MCP handles access to public market data automatically once you connect it through Vinkius.

**What is the difference between list_top_scaled_players and list_top_average_players?**
They measure two different things: `list_top_scaled_players` shows who everyone *thinks* will perform (popularity), while `list_top_average_players` shows who has *actually* performed best over time.

**Can I find players from a specific club using list_players_by_club?**
Yes, you just need to provide the club's name or ID. The tool then generates a filtered list of every player associated with that team.

**How do I use `search_leagues` if I'm looking for a private league that isn't public?**
You search by name regardless of visibility. The tool checks both public and private databases, returning the associated League ID necessary for further actions. You just need to provide the league's common or unique title.

**When I use `list_probable_players`, how do I know if that status is guaranteed for the game day?**
The 'Probable' status reflects the current market assessment. It’s a strong indicator, but it doesn't guarantee participation on game day. Always cross-reference this data with league news before making final selections.

**If I only know a player's nickname, can `search_players` find them and give me their ID?**
Yes, the tool uses nicknames to narrow down results. It returns all matching players along with their unique IDs, allowing you to use that data for subsequent scouting queries.

**What scope does `list_round_scorers` cover? Does it include scores from abandoned matches?**
The tool retrieves real-time scoring updates only. It focuses on the current, active round and excludes any historical or incomplete match data. You get live results as they happen.

**Can my AI automatically find the 'Probable' lineup for a specific club to avoid injured players?**
Yes! Use the `list_probable_players` tool combined with `list_players_by_club`. Your agent will filter the official Globo data to return only athletes currently marked with the 'Probable' status, ensuring your picks are safe.

**How do I identify 'Bargains' or cheap players for value appreciation (valorização)?**
Simply ask the agent to run the `list_cheap_players` action. It will retrieve a curated list of athletes priced below 5 cartoletas, perfect for teams with a tight budget or those looking to increase their total wealth.

**Does the integration allow tracking the performance of my friends' teams in real-time?**
Yes. Using the `get_user_team_by_slug` tool, your agent can fetch the current round's points and total value for any team using its unique slug, allowing for direct competitive comparisons.