Craque

Craque — connector documentation

• MCP endpoint: https://craque.connectorbay.com/mcp
• REST API: POST https://craque.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://craque.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
• Health: https://craque.connectorbay.com/health · Tool schemas: https://craque.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/craque · agent@connectorbay.com

What Craque is for

The questions a Brazilian football fan — especially a Cartola FC player — asks every round: is the market open and when does it close, who's cheap and actually delivering, is my player doubtful or suspended this round, who's playing and when, and what's a reasonable starting XI for my budget.

What it does

Reads Cartola FC's own public data feed (the same one the official game uses) and turns it into direct answers: market/round status with the closing time and a plain reference for position and status codes; every club with its shield; player search by name with optional position/club filters; a single player's full detail (club, position, price in cartoletas, season average, last round's points, price variation, status, and this round's scout); a club's complete current squad; the best players by season average or by last round alone; "value picks" — season average points divided by price, the who's-a-bargain-right-now scouting tool, with an option to exclude doubtful/suspended/ injured players; fixtures for any round (defaults to the current one) with the official score once final; the full season's round-by-round schedule; and a lineup builder that greedily fills a Cartola formation (4-3-3, 3-5-2, etc.) within a cartoletas budget, picking the highest season-average player it can still afford at each slot.

What it is not

Not affiliated with Cartola FC, Globo, or any club — it reads their public feed and adds independent analysis on top. The lineup builder is a heuristic scouting suggestion (fills goalkeeper → defence → midfield → attack → coach, reserving enough for the slots still to come), not a guaranteed-optimal combination, and it draws defenders from both zagueiros and laterais without enforcing a formation's exact split between them. Not betting or wagering advice — Cartola FC is a free-to-play fantasy game, not a sportsbook, and Craque only reports information about it.

Tools

Status & reference

market_status — Current round number, whether the Cartola FC transfer market is open or closed, when it closes, and the position/status code reference. Use for "is the market open", "what round are we in".

clubs — Every club in the current Cartola FC season, with shield images. Use for "list the clubs", to get a club id for other tools.

Players

player_search — Search players by name. Optionally filter by position or club. Use for "find Pedro", "midfielders named Gabriel at Palmeiras". Args: query, position, club, limit.

player_info — Full detail for one player: club, position, price, season average, last round's points, price variation, status and this round's scout (tackles, shots, fouls, etc). Use for "how is Gerson doing", "what does player 12345 cost". Args: player_id, name.

club_squad — A club's full squad currently in the market, with price/average/status, optionally filtered by position. Use for "Palmeiras squad", "Flamengo's midfielders". Args: club, position.

top_players — The best players by season average points or by last round's points, optionally filtered by position or club. Use for "top scorers this season", "best forwards last round". Args: position, club, sort_by, limit.

value_picks — Best price-performance players — season average points divided by price in cartoletas — the "who's a bargain right now" scouting tool. Use for "best value midfielders under 10 cartoletas", "cheap defenders worth starting". Args: position, max_price, min_games, safe_only, limit.

Fixtures

round_matches — Fixtures for a round: home/away clubs, kickoff time, venue, and the official score once the match is final. Use for "who's playing this round", "results from round 5". Args: round_number.

rounds_schedule — The full season's round-by-round schedule with start/end datetimes. Use for "when does round 20 start", "how many rounds are left".

Planning

lineup_builder — Suggest a starting lineup for a formation and cartoletas budget: greedily picks the highest season-average player available at each position slot (goalkeeper, defence, midfield, attack, coach) without exceeding the budget. A heuristic scouting suggestion, not a guaranteed-optimal combination. Use for "build me a 4-3-3 with 100 cartoletas". Args: formation, budget, safe_only.

Conventions

• Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
• Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
• Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/craque/support

Craque — Privacy Policy

Effective 23 September 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Craque is. Craque is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for Brazilian football (Cartola FC) reference data: market status, clubs, players, fixtures, the round schedule, value picks and a lineup builder. You interact with your assistant; the assistant sends us only the arguments needed for that one lookup or calculation.

What we receive. The arguments of each tool call — a player or club name, a round number, a formation and budget, or search filters — the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant, and a Pro API key if you have one), and standard server logs.

Everything is fetched from Cartola FC's own public feed or computed on our server, and nothing is stored. No request is forwarded to any third party beyond Cartola FC's public API itself, and no query is logged in request bodies, recorded, or used to train anything.

What we do not receive or store. We do not receive your conversation with the assistant, your name, your Cartola FC account, or any league/team you may have there, and we do not build a profile from your queries: each request is answered independently and nothing carries over between requests. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting-provider access logs, which contain IP addresses and request paths but not request bodies, are retained for up to 30 days for security and abuse prevention.

Sub-processors. Cartola FC (Globo Comunicação e Participações S.A.) — the public data source queried live for every tool except the reference tables that ship with the server. Hosting: Vercel (United States regions).

Legal bases and your rights. For users in Brazil, California, the EU/UK and elsewhere, our processing is necessary to provide the service you request through your assistant. Because we store no personal data beyond short-lived logs, requests to access, correct or delete personal data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days. We do not sell or share personal information and do not use your data to train models.

Children. Craque is a general-audience service operated by the adult using the assistant.

Changes. We will post changes here with a new effective date.

Craque — Terms of Service

Effective 23 September 2026. These terms govern use of the Craque connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Craque returns Brazilian football (Cartola FC) reference data — market status, clubs, players, fixtures, the round schedule, price-performance value picks and a lineup-building suggestion — sourced from Cartola FC's own public data feed and computed from it. It is accessed through an AI assistant or directly over MCP or HTTP.
2. Not affiliated with Cartola FC or Globo. The Service is an independent, unofficial client of Cartola FC's public API. "Cartola FC" and related names are trademarks of their respective owners; use here is purely descriptive/referential.
3. Not betting, wagering or investment advice. Cartola FC is a free-to-play fantasy game; nothing in the Service is a recommendation to place a bet or wager of any kind. The lineup builder and value-picks tools are heuristic scouting suggestions based on past performance, which does not guarantee future points.
4. Data currency. Prices, averages, status and fixtures reflect Cartola FC's feed at the time of the request and can change (prices move round to round; a player's status can change up to kickoff). We do not guarantee the upstream feed's accuracy or availability.
5. Estimates, not guarantees. The lineup builder is a greedy heuristic, not a guaranteed-optimal combination within budget; the value-picks ranking (average points ÷ price) is one reasonable measure of value, not the only one.
6. Acceptable use. Automated use within the published rate limits is welcome.
7. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time, including if Cartola FC's public feed changes or becomes unavailable.
8. Data. Our Privacy Policy describes what we process. In short: your query is answered from Cartola FC's public feed or computed locally, and nothing is stored.
9. Pro keys. Optional Pro API keys are issued at our discretion, are personal to the holder and may be revoked for abuse.
10. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss arising from use of or reliance on the Service, including fantasy-league outcomes. Our total liability is limited to US $100.
11. Governing law. California law; venue in San Mateo County, California.
12. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/craque

Craque support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://craque.connectorbay.com/mcp
• REST API: https://craque.connectorbay.com/openapi.json
• Live status: https://craque.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Craque never asks for them.