Finds and recommends free agents when the user needs a player, asks about the waiver wire, needs a position filled, wants to stream a pitcher, or asks 'who should I pick up'. Searches by position, compares top options, and recommends based on H2H category impact. Triggers on: 'free agent', 'waiver', 'pickup', 'pick up', 'stream', 'available', position needs like 'I need a shortstop'.
When the user is looking for free agent pickups or waiver wire targets, follow these steps:
Call get_scoring_categories to know which 14 stats matter and their direction (some are reverse — lower wins).
Call get_my_roster to see the current team composition, stats, and any gaps.
get_roster_needs to identify which positions are unfilled or weakest.get_category_trends to identify which categories need help, and get_watchlist to see if there are players already being tracked.Call get_free_agents with the target position filter. Request up to 25 results to have a good pool.
For the top 3-5 candidates from the free agent list, call get_player_info for each to get detailed stat breakdowns. If comparing two close options, use compare_players.
Rank the candidates by category impact, not just total points. For each recommendation:
For the reverse categories (B_SO, ERA, WHIP, L), remember that lower values are better. A pitcher with high K but also high ERA is a mixed bag.
save_roster_move with action="ADD" and the player detailssave_roster_move with action="DROP"remove_from_watchlist after pickupadd_to_watchlist