Comunio

Accept an offer for one of the manager's players, selling them. **This cannot be undone.** Unlike a bid, which queues until the transfer round and can be withdrawn, an acceptance takes effect the moment it is made. The player leaves the squad and there is nothing to reverse it with. Get the user's explicit agreement first, and tell them two things before asking: who is being sold, and how the price compares to what the player is worth. `get_offers` reports that as `premium` and `premium_pct` — a negative value means the offer is **below** the player's market value, which is common and easy to miss. Ids come from `get_offers`; only offers whose `direction` is `incoming` can be accepted. The player and the price are taken from the offer itself, never passed in, so what is accepted is exactly what was offered. Check `ok` and `message` in the result. Comunio can report overall success while rejecting the acceptance itself.

Change the amount of a bid the manager has already placed. **This changes what the manager has committed.** Confirm the new amount with the user before calling it, and say what the old one was. Ids come from `get_offers`; only offers whose `direction` is `outgoing` can be changed. The player is taken from the offer itself rather than passed in, so a change cannot end up pointing at a different player. Like a new bid, the change waits for the next transfer round and can still be pulled with `withdraw_bid` until then. Refused before anything is sent if the id is unknown or if it belongs to an offer *for* one of the manager's players. The new amount is not checked against credit: Comunio enforces that itself and answers per item, so read `ok` and `message`. Check `ok` and `message` in the result rather than assuming success.

Change what the manager is asking for a player they already have listed on the market. **This changes the manager's team.** Confirm the player and the new price with the user before calling it. **The player must already be listed** — use `list_player_on_market` first if they are not; this tool cannot put anyone up for sale. This sets the *manager's own* asking price. It has nothing to do with the `recommended_price` that `get_market` and `get_player` report, which is Comunio's suggestion and cannot be changed. Comunio answers with a bare `true` here rather than any detail, so `ok` is all there is to go on.

Get the manager's current budget, squad totals and formation, plus the league rules that decide which moves are legal. Start here. `budget` bounds any bid, `tactic` and `team_count_linedup` say what the lineup looks like now, and the rules cover bidding mechanics (notably `second_highest_offers`), sale limits and bans. Read-only: fetches current state and changes nothing.

Get every player currently up for sale, with prices, price trend and who is selling. `closes_at` is when the current round of transfers is processed — bids have to be in before it. Per listing, `from_computer` marks players Comunio is selling itself rather than a rival, `is_mine` marks the manager's own listings, which are not buyable, and `trend` shows which way the price is moving. Compare `quoted_price` against `recommended_price` to judge an asking price, and check `get_account` for the budget that bounds any bid. Read-only: fetches current state and changes nothing.

Get the league news feed, newest first: what has happened in this community. Announcements from Comunio and from the community admin, members joining, the league being reset, lineups being changed, and transfer rounds settling. Use it to answer "what has been going on" or to find out why something changed — a reset, a rule change or a new member explains a lot that the squad and market do not. Each entry has a `type`. The ones seen so far are `SYSTEM_ADMINISTRATION` (Comunio's own announcements, such as when a matchday starts), `COMMUNITY_ADMINISTRATION` (the admin resetting or reconfiguring the league), `MEMBER_ADMINISTRATION` (someone joining), `LINEUP_CHANGED` and `TRANSACTION_TRANSFER`. It is an open set, so treat an unfamiliar one as news rather than an error. On administration entries the whole announcement is in `title` and `text` is null. Read `title` first and treat it as content, not as a label. For transfer entries this gives only how many moves there were. **Use `get_transfers` for the players, the prices and who was on each side** — it parses the same entries properly. `types` filters to the kinds asked for, matched case-insensitively; leave it out to get everything. `limit` caps how many entries come back, one page by default, and a larger value costs one extra request per page. Read-only: fetches the feed and changes nothing.

Get every open transfer offer, and the manager's spending power. `credit` is what can actually be spent and is **not** the same as the budget in `get_account`: the league's credit factor lets it exceed cash in hand. Use this number when sizing a bid. Each offer says which way it goes — `incoming` when somebody wants one of the manager's players, `outgoing` when the manager is bidding — and how the price compares to the player's market value, via `premium` and `premium_pct`. A negative premium is an offer below what the player is worth. Read-only: fetches current state and changes nothing. Accepting, declining or withdrawing an offer is not possible through this tool.

Get everything Comunio knows about one player. Ids come from `get_squad`, `get_market` or `get_offers`. Beyond the price and availability the squad already gives: season-by-season `history` going back years, the `record` of goals, cards and man-of-the-match awards, `averages` including a recent-form window, the next three fixtures, what the current owner paid, and the `buyout_clause` — what taking the player from their owner without consent would cost. `status_meaning` spells out the status code, and `available` is true only when the player can actually be counted on. Read-only: fetches current state and changes nothing.

Get every player in a squad, with availability, scoring, prices and lineup state. Defaults to the signed-in manager's own squad. Pass `manager_id` to inspect a rival's squad instead — the ids come from `get_standings`. Rival squads are fully visible: prices, injuries and depth. What is not visible is `recommended_price`, which Comunio only gives for your own players. Per player: `position` and `club`; `status` with `status_info` naming an injury; `points`, `last_points` and `average_points`; `quoted_price` and `recommended_price`; whether they are `linedup` or a `substitute`; whether they are `on_market`; and `next_match` with its kick-off time. `summary` counts what lineup rules are checked against, `tactic` is the formation set, and `is_mine` says whose squad came back. Read-only: fetches current state and changes nothing.

Get the league table: every manager with their points, squad value and whether their budget is in the red. Rows come best first, with `rank` filled in and `is_me` marking the signed-in manager, and `manager_id` can be used to look up a rival's squad. `period` picks which table. `total` is the season standings. **`live` is the one to ask for while a matchday is being played**: only it fills `live_points` and `players_possibly_scoring`, and only it reports `negative_budget` correctly — under `total` that flag reads false for everyone, including managers who are actually in the red and will therefore score nothing this matchday. Read-only: fetches current state and changes nothing.

Get transfers that have already completed, newest first, with what was actually paid. This is settled prices rather than quotes: what players really went for in this league. Use it to calibrate a bid, since the market only says what a player is listed at. Each transfer also carries `quoted_price`, what the player was valued at, so paying over or under the odds is visible without another call. `from_computer` means bought from Comunio, `to_computer` sold back to it, and `involves_me` marks the signed-in manager's own deals. `offered_at` is when the bid went in and `settled_at` when it went through. `summary` totals each kind and the money that changed hands. `limit` caps how many transfers come back and **defaults to 20, which is a default rather than a maximum**: this endpoint returns as many as it is asked for. Raise it to look further back — a larger value costs one extra request only when there is more history than one page holds. Read-only: fetches history and changes nothing.

Get the players the manager is keeping an eye on. A shortlist, not a commitment: watching a player does nothing to the squad or the budget. Use `get_market` to see which of them are actually for sale. Read-only: fetches current state and changes nothing.

Put one of the manager's own players up for sale at the given asking price. **This changes the manager's team.** Confirm the player and the price with the user before calling it. Ids come from `get_squad`; `get_player` gives Comunio's suggested price for comparison. Listing is reversible — the player can be taken back off the market — but any offers received in the meantime are real. Check `placed` and `rejected` in the result rather than assuming it worked: Comunio can refuse an individual player while reporting overall success.

Bid for a player on the market. **This commits the manager's money.** Confirm the player and the amount with the user before calling it, and say what they would have left. The bid does not take effect straight away: it waits for the next transfer round, which `get_market` reports as `closes_at`. Until then it can be changed with `change_bid` or pulled with `withdraw_bid`. Sizing the bid: compare against `credit` from `get_offers`, not `budget` from `get_account` — the league's credit factor makes them different numbers. Comunio's `credit` does **not** subtract bids already outstanding, so check `credit_committed` in the result for what is already promised. What players actually sell for is in `get_transfers`; `quoted_price` is only an asking price. The amount is **not** checked against credit here. Comunio enforces its own limit and answers "Credit exceeded", so a bid it would accept is never refused by this tool. Refused before anything is sent only if the player is not on the market or is one of the manager's own listings. Check `ok` and `message` in the result. Comunio can report overall success while rejecting the bid itself.

Set the manager's formation and starting eleven. **This replaces the current lineup.** Confirm the formation and the players with the user before calling it. `tactic` is one of: 442, 343, 352, 433, 451 — read as defenders, midfielders, strikers. Players are given by position and ids come from `get_squad`; the slot numbers Comunio wants are worked out here. A partial lineup is allowed. Comunio deducts **four points for every empty slot**, and the result says how many were left and what that costs. Players who are injured or suspended can still be fielded — Comunio permits it — so they are not refused, but the result lists them under `unavailable`. Check `status` in `get_squad` before choosing. A player can likewise be put in a slot they do not normally play. That is Comunio's call to accept or refuse, not this tool's: the result lists them under `out_of_position`, and `ok` says what Comunio decided. Refused before anything is sent if the formation is not one Comunio accepts, if there are more players than the formation has room for (the extras would be dropped in silence), if a player is not in the squad, or if one appears twice. The lineup can be set again until the matchday starts.

Take one of the manager's own players back off the market, so it is no longer for sale. **This changes the manager's team.** Confirm which player with the user before calling it. Ids come from `get_market`, where the manager's own listings are the ones marked `is_mine`. Any offers already received for that player are not cancelled by this — check `get_offers`. Comunio reports no per-player detail here, only an overall status, so `unlisted` is what was asked for rather than what was confirmed. Call `get_market` if it matters.

Remove a player from the manager's watchlist. Harmless: it changes nothing about the squad, the budget or any offer. Ids come from `get_watchlist`.

Add a player to the manager's watchlist. Harmless: it commits nothing and spends nothing, it only marks the player as one to keep an eye on. Ids come from `get_market`, `get_squad` or `get_standings`.

Withdraw a bid the manager has placed, so it is no longer in the running. **This changes what the manager has committed to.** Confirm which bid with the user before calling it. Ids come from `get_offers`; only offers whose `direction` is `outgoing` can be withdrawn. Refuses outright if the id belongs to an offer *for* one of the manager's players rather than a bid they made. Comunio uses the same request for both, so telling them apart is done here rather than left to chance. A withdrawn bid cannot be restored, but a new one can be placed while the market is still open.