webmcp-demo.shredly.io

{
  "name": "get_user",
  "kind": "answer",
  "impl": "imperative",
  "description": "Look up a Sleeper user by username or user_id. Returns user_id, display_name, username, and avatar. The user_id is required for all other Sleeper queries.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "username_or_id": {
        "description": "The Sleeper username (e.g. vinnie) or numeric user_id",
        "type": "string"
      }
    },
    "required": [
      "username_or_id"
    ]
  }
}

{
  "name": "get_leagues_for_user",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get all fantasy leagues a user is in for a given sport and season. Returns league names, IDs, roster counts, status, and scoring settings.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "user_id": {
        "description": "The numeric Sleeper user_id (get this from get_user)",
        "type": "string"
      },
      "season": {
        "description": "The season year, e.g. 2025",
        "type": "string"
      },
      "sport": {
        "description": "The sport, e.g. nfl",
        "type": "string"
      }
    },
    "required": [
      "user_id",
      "season",
      "sport"
    ]
  }
}

{
  "name": "get_rosters",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get all rosters in a league. Returns each team's players, starters, reserve (IR), wins, losses, points scored, and waiver position. Use get_users_in_league to map roster_id to a real team name.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "league_id": {
        "description": "The league ID (get this from get_leagues_for_user)",
        "type": "string"
      }
    },
    "required": [
      "league_id"
    ]
  }
}

{
  "name": "get_matchups",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get all matchups in a league for a given week. Each object is one team — pair teams with the same matchup_id to see who played who. Includes starters, all players, and total points scored.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "week": {
        "description": "The NFL week number",
        "type": "number"
      },
      "league_id": {
        "description": "The league ID (get this from get_leagues_for_user)",
        "type": "string"
      }
    },
    "required": [
      "week",
      "league_id"
    ]
  }
}

{
  "name": "get_users_in_league",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get all users in a league with their display names, team names, and roster IDs. Essential for mapping roster_id numbers (returned by get_rosters and get_matchups) to real team and player names.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "league_id": {
        "description": "The league ID (get this from get_leagues_for_user)",
        "type": "string"
      }
    },
    "required": [
      "league_id"
    ]
  }
}

{
  "name": "get_transactions",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get all transactions in a league for a given week — includes trades, waiver claims, and free agent adds/drops. Shows which players moved, which rosters were involved, and FAAB bids.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "week": {
        "description": "The week number to pull transactions for",
        "type": "number"
      },
      "league_id": {
        "description": "The league ID (get this from get_leagues_for_user)",
        "type": "string"
      }
    },
    "required": [
      "week",
      "league_id"
    ]
  }
}

{
  "name": "get_trending_players",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get the most added or dropped players across all Sleeper leagues in the past 24 hours for a given sport. Useful for spotting waiver wire targets. Returns player IDs and add/drop counts.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "lookback_hours": {
        "description": "Hours to look back, default is 24",
        "optional": true,
        "type": "number"
      },
      "limit": {
        "description": "Number of results to return, default is 25",
        "optional": true,
        "type": "number"
      },
      "type": {
        "description": "Either 'add' (most added) or 'drop' (most dropped)",
        "type": "string"
      },
      "sport": {
        "description": "The sport, e.g. nfl",
        "type": "string"
      }
    },
    "required": [
      "type",
      "sport"
    ]
  }
}

{
  "name": "get_players",
  "kind": "answer",
  "impl": "imperative",
  "description": "Fetch players for a given sport and position, used to resolve player IDs returned by get_rosters, get_matchups, and get_transactions. Position is required to keep the response under Lambda's 6MB limit — make parallel calls per position when you need multiple. Pass active=true to further reduce the response.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "active": {
        "description": "Pass 'true' to return only active players",
        "optional": true,
        "type": "string"
      },
      "position": {
        "description": "Required. Filter to a single position: QB, RB, WR, TE, K, DEF",
        "type": "string"
      },
      "sport": {
        "description": "The sport, e.g. nfl",
        "type": "string"
      }
    },
    "required": [
      "position",
      "sport"
    ]
  }
}

{
  "name": "get_nfl_state",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get the current NFL state, including the active week, season, season type, and display week.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "_placeholder": {
        "type": "string",
        "description": "Unused; this tool takes no parameters.",
        "optional": true
      }
    },
    "required": []
  }
}