List FPL players most likely to RISE in price, sorted by predicted progress.

Args: limit: Maximum number of players to return (default 20). position: Optional position filter: GK, DEF, MID or FW. team: Optional team-name filter (case-insensitive substring, e.g. "Arsenal"). threshold: Minimum predicted progress (0-1 fraction of the change threshold) for a player to count as a riser candidate. Default 0.5. Use 1.0 to only show players predicted to actually change price tonight.

Returns: JSON array of players with progress_now_pct, prediction_pct, per_hour_pct and predicted_new_cost.

List FPL players most likely to FALL in price, sorted by predicted progress.

Args: limit: Maximum number of players to return (default 20). position: Optional position filter: GK, DEF, MID or FW. team: Optional team-name filter (case-insensitive substring, e.g. "Arsenal"). threshold: Minimum magnitude of predicted downward progress (0-1) for a player to count as a faller candidate. Default 0.5. Use 1.0 to only show players predicted to actually drop price tonight.

Returns: JSON array of players with progress_now_pct, prediction_pct, per_hour_pct and predicted_new_cost.

Get the price-change prediction for a specific FPL player by name.

Args: name: Full or partial player name (case-insensitive, e.g. "Haaland", "Calafiori", "salah").

Returns: JSON with the matching player's prediction, or all matches if the name is ambiguous, or an error if no player matches.

List the most common FPL transfers (player in / player out pairs).

These transfer volumes drive the price changes surfaced by the other tools.

Args: limit: Maximum number of transfer pairs to return (default 20).

Returns: JSON array of {player_in, player_out, count, share_pct} sorted by volume.

Get metadata about the current FPL price-change window.

Returns: JSON with the LiveFPL site version/gameweek generation info. Useful to confirm which gameweek the predictions apply to.

Render the FPL transfer trend as a node-link graph IMAGE (PNG).

Mirrors the "Transfer Trends" chart on livefpl.net/prices. Each node is a player; circle size = total transfer volume, and arrows point from the player transferred OUT to the player transferred IN.

Args: top_n: Number of highest-volume transfer pairs to include as edges (default 20). Nodes are the players appearing in those pairs. color_by: Node colouring scheme. "direction" (default) colours green = net transfers in, red = net out. "position" colours by playing position (GK/DEF/MID/FW).

Returns: A PNG image of the transfer-trend node-link graph.

Render transfer-trend graphs split by position as a 2x2 grid IMAGE (PNG).

Produces one node-link chart per position — Goalkeepers (GK), Defenders (DEF), Midfielders (MID) and Forwards (FW) — showing the transfer flow within each position. Circle size = total transfer volume, colour = net direction (green = net in, red = net out), arrows point out → in.

Args: top_n: Number of highest-volume transfer pairs to consider (default 40). A larger value than the single-graph tool is recommended so each position panel has enough players.

Returns: A PNG image with four position panels (GK, DEF, MID, FW).

Get the FPL transfer-trend node-link graph as structured DATA (JSON).

The underlying data behind livefpl_transfer_trend_graph: per-player net transfer trend plus the transfer-pair edges. Use this when you want the numbers rather than an image.

Args: top_n: Number of highest-volume transfer pairs to include (default 20).

Returns: JSON with nodes (id, name, transfers_in, transfers_out, net, total_volume, direction) and edges (source, target, count).

Get the LIVE gameweek standings for an FPL classic league.

Fetches the live league table from https://plan.livefpl.net/leagues/{id} — the same live-updating standings shown on LiveFPL, including provisional (in-progress) gameweek scores before bonus points and ranks are finalised.

Args: league_id: The FPL classic-league id (the number in the league URL, e.g. 230412). limit: Maximum number of managers to return, ordered by current rank (default 25).

Returns: JSON with the league title, gameweek, and standings. Each manager row has: rank, rank_change (movement vs last GW), team_name, manager_name, entry_id, overall_rank, captain, vice_captain, players_to_play, gw_score (live), total_score, free_transfers, team_value, players_played (e.g. "11/12") and active_chip.