Fantasy Football Manager

Execute an existing proposal against synthetic demo state only. First call prepare_action, then obtain approval for that exact proposal when requires_confirmation is true. Execution rechecks snapshot and configuration revisions, freshness, automation modes, and action limits before changing state. Returns status='executed', scope, action, proposal_id, and the new revision, and records one audit event. Retrying a completed proposal returns its original result with idempotent_replay=true, without another state change or approval check. Unknown or changed proposals fail. Use the ESPN companion for live submissions.

Read recent audit records from this data directory without changing state. Returns history entries with id, at, event, and detail, ordered from newest to oldest. Records include snapshot imports, configuration changes, prepared proposals, and completed demo actions. An action_prepared event records preparation, not execution. Calculation evidence is separate from this audit history. Works before a snapshot is loaded.

Read this server's capabilities before selecting analysis or execution tools. Returns supported actions, effective automation modes, pause state, snapshot presence, and state and configuration revisions. This server analyzes imported data and executes synthetic demo actions only. The response separately describes browser drafts and HTTP season actions through the ESPN companion. Its acceptance report distinguishes implemented actions from verified live execution. Works before a snapshot is loaded and does not change saved state.

Read cached results and status from the local draft monitor without running a simulation. Returns running, status, error, current, trial counters, and latest when the cached inputs remain usable. latest is null when revisions change, the snapshot becomes stale or incomplete, automation pauses, or no result exists. Completed trials include work across the monitor session, while current_state_trials counts only the current inputs. Use start_draft_monitor to produce these results or recommend_draft for an independent single batch. This tool does not fetch observations or append calculation evidence.

Read the full current configuration and its config_revision. Returns strategies, automation presets and per-action modes, pause state, and user limits. Works before a snapshot is loaded and does not change saved state. Use this response as the starting configuration for update_manager_config to preserve existing settings.

Compare every team's best legal weekly lineup by projected points. Requires current season data, weekly inputs for every team, and verified locks with league scope. Returns rankings, source details, warnings, and input revisions with status='ok' or status='incomplete'. Incomplete team lineups produce null ranks, while missing league lock coverage produces an empty rankings list. These estimates describe one week and are not championship probabilities. Appends calculation evidence without changing rosters. Use recommend_lineup to analyze only the selected team.

Check the freshness and completeness of the saved observation. Requires an imported snapshot or loaded demo. Returns source fields, age_seconds, the phase-specific maximum_age_seconds, stale, and local draft monitor status. This tool reads saved data and does not refresh the source or run a simulation. Use the ESPN companion for fresh HTTP season observations or browser draft observations. Use import_league_snapshot for replacement data supplied by the caller.

Read the selected team's roster from the saved snapshot. Requires an imported snapshot or loaded demo. Returns the snapshot revision, league context, roster and reserve players, lineup, league rules, and budget when supplied. Use recommend_lineup to calculate a lineup or get_source_status to check observation freshness. This tool does not fetch new data or change saved state.

Validate and save a complete league snapshot supplied by the caller. Use the ESPN companion to fetch live observations or load_demo for fictional data. Replacement requires the current snapshot revision and preserves observation order and confirmed draft history. Pending browser submissions, HTTP submissions, and queued waivers retain their original context and rules until reconciliation resolves them. Changing the league, selected team, or season resets configuration to defaults. Records the import, increments the snapshot revision, and invalidates unexecuted proposals and monitor results. Returns status='imported', revision, config_revision, and config_reset, or an error without replacing state.

Load a fictional scenario for local testing or demonstrations. Use import_league_snapshot for your own data. Requires an empty data directory or existing synthetic state and preserves confirmed draft history checks. Stops the local draft monitor, replaces the snapshot, and resets configuration when the league changes. Records the import and returns status='imported', revision, config_revision, and config_reset. This tool does not connect to ESPN.

Validate a synthetic action and save a proposal without executing it. Requires fresh, complete synthetic data, unpaused automation, and review or automatic mode for every action component. Checks action-specific player eligibility, locks, projections, roster rules, and user limits before saving the proposal. Returns proposal_id, normalized payload, mode, requires_confirmation, scope, and the bound snapshot and configuration revisions. Each call creates a new proposal and audit record. Use execute_demo_action with that exact proposal_id for execution. Use the ESPN companion for browser draft proposals or HTTP lineup, acquisition, drop, and IR proposals.

Rank alternative single-player acquisitions using the saved weekly snapshot and user limits. Requires current season data, verified locks, weekly projections, and known budget and pending commitments. Returns recommendations with add and optional drop IDs, lineup improvement, and maximum FAAB bids, plus revisions and input warnings. Status is ok, incomplete for missing inputs, or blocked when the weekly move limit is reached. Unrostered players are not verified free agents, and this tool does not estimate winning bids or submit claims. Appends calculation evidence. Use prepare_action only for synthetic acquisitions that pass action checks. Use the ESPN companion's espn_prepare_season_action for a live HTTP acquisition proposal.

Run one bounded draft simulation against the current imported draft snapshot. Use start_draft_monitor for repeated batches or get_draft_recommendations to read that monitor's cached results. Requires draft data with consistent pick history and full-season projections for available and selected-team players. Returns estimated recommendations, trial counts, warnings, revisions, and status such as ready, stale_snapshot, incomplete_snapshot, or roster_complete. current checks revision and snapshot freshness after calculation, but does not grant action permission. Appends a calculation evidence record, including discarded work, without changing rosters or submitting picks.

Optimize the selected team's known weekly projections while preserving locked slots. Uses the saved season snapshot, weekly projections, verified player locks, and configured source age limits. Returns status='ok' with a lineup and comparison details, or status='incomplete' with errors and missing-input details. Unknown unchanged scores can cancel from improvement while total projected points remain null. Comparison scope and coverage gaps describe those limits. Coverage suggestions do not authorize a repair. Locked players remain in their current slots, including unavailable players whose games have locked. Appends calculation evidence without changing the lineup, and includes the input snapshot and configuration revisions. Use prepare_action for a synthetic proposal or the ESPN companion for live lineup changes.

Start background draft simulations and return the initial monitor status. Requires a loaded draft snapshot and no active local draft monitor. Each batch uses the latest imported snapshot and appends calculation evidence, including discarded batches. The monitor waits while paused or while the snapshot is stale or incomplete, and clears obsolete cached results. Import new observations to maintain freshness. This tool neither reads a browser nor submits picks. Use get_draft_recommendations for results, stop_draft_monitor to stop, or recommend_draft for one synchronous calculation.

Request shutdown of the local draft monitor and wait up to five seconds. Returns monitor status and counters, with running=true and status='stopping' if the active batch still needs to finish. Use get_draft_recommendations to confirm running=false before starting another monitor. Repeated calls are safe when the monitor is already stopped. This tool does not stop the ESPN companion or change saved automation configuration.

Replace the saved configuration using its current configuration revision. Read get_manager_config first to preserve settings that you do not intend to change. Omitted fields use model defaults rather than existing values, including when config is an empty object. Validates strategies and limits, records the change, and invalidates unexecuted proposals and monitor results. Returns status='updated' and the new config_revision, or a revision conflict without changing configuration. This tool does not execute actions or start a monitor.