Yahoo Sports MCP server for AI agents

Let Claude, ChatGPT or your own agent read Yahoo Sports: 20 typed functions through one MCP server. No Yahoo Sports API key needed.

Functions
20
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Yahoo Sports

An MCP server for Yahoo Sports alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/yahoo_sports
Every site

One MCP server for Yahoo Sports and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 20
  • findPlayersFinds players on one team's roster by name.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes
    teamSlugstring
    Abbreviation (getOdds' abbr "IND") is resolved via standings; no fuzzy guess.
    Yes
    querystringYes

    Returns YahooSportsPlayerRow[]

    interface YahooSportsPlayerRow {
      league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball";
      playerId: string;
      name: string;
      position: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/findPlayers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.findPlayers({ league: "nfl", teamSlug: "detroit", query: "a" });
  • getFantasyLeagueReads the CALLER's own fantasy football league.

    Arguments

    NameTypeRequired
    leagueIdstring
    The league's numeric id off its own URL (football.fantasysports.yahoo.com/f1/<leagueId>).
    Yes

    Returns YahooFantasyLeagueDetail

    interface YahooFantasyStandingsRow {
      teamId: string;
      teamName: string;
      rank: number;
      wins: number;
      losses: number;
      ties: number;
      pointsFor: number;
      pointsAgainst: number;
      streak: string | null;
      waiverPriority: string | null;
      moves: string | null;
    }
    
    interface YahooFantasyMatchupTeam {
      teamId: string;
      teamName: string;
      record: string | null;
      score: number;
    }
    
    interface YahooFantasyMatchup {
      teams: [YahooFantasyMatchupTeam, YahooFantasyMatchupTeam];
    }
    
    interface YahooFantasyLeagueDetail {
      leagueId: string;
      leagueName: string;
      week: number | null;
      standings: YahooFantasyStandingsRow[];
      matchups: YahooFantasyMatchup[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getFantasyLeague

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getFantasyLeague({ leagueId: "101" });
  • getFantasyTeamReads the CALLER's own fantasy team.

    Arguments

    NameTypeRequired
    leagueIdstring
    The league's numeric id off its own URL (football.fantasysports.yahoo.com/f1/<leagueId>).
    Yes
    teamIdstring
    The team's numeric id off its own URL (football.fantasysports.yahoo.com/f1/<leagueId>/<teamId>).
    Yes

    Returns YahooFantasyTeamDetail

    interface YahooFantasyRosterSlot {
      slot: string;
      playerId: string | null;
      name: string | null;
      nflPosition: string | null;
      nflTeam: string | null;
    }
    
    interface YahooFantasyTeamDetail {
      leagueId: string;
      teamId: string;
      teamName: string;
      week: number | null;
      roster: YahooFantasyRosterSlot[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getFantasyTeam

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getFantasyTeam({ leagueId: "101", teamId: "1" });
  • getGameReads one game in full off its own game page.

    Arguments

    NameTypeRequired
    gameUrlstringYes

    Returns YahooSportsGameDetail

    interface YahooSportsBoxScorePlayerLine {
      playerId: string;
      name: string;
      stats: YahooSportsPlayerStat[];
    }
    
    interface YahooSportsBoxScoreCategory {
      category: string;
      players: YahooSportsBoxScorePlayerLine[];
    }
    
    interface YahooSportsBoxScore {
      away: YahooSportsBoxScoreCategory[];
      home: YahooSportsBoxScoreCategory[];
    }
    
    interface YahooSportsGameRecapPlay {
      description: string;
      team: string | null;
      timestamp: string | null;
    }
    
    interface YahooSportsGameRecap {
      summary: string | null;
      keyPlays: YahooSportsGameRecapPlay[];
    }
    
    interface YahooSportsGameDetail {
      name: string;
      homeTeam: string;
      awayTeam: string;
      homeScore: number | null;
      awayScore: number | null;
      status: "scheduled" | "in_progress" | "final";
      startDate: string;
      venue: string | null;
      boxScore: YahooSportsBoxScore | null; // null before the game starts
      recap: YahooSportsGameRecap | null; // null before the game starts
    }
    
    interface YahooSportsPlayerStat {
      name: string;
      abbreviation: string;
      value: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getGame

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getGame({ gameUrl: "<gameUrl>" });
  • getInjuriesReads a league's full injury report the way its own Injuries page does.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes

    Returns YahooSportsInjuryRow[]

    interface YahooSportsInjuryRow {
      league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball";
      team: string;
      teamSlug: string | null;
      playerId: string;
      name: string;
      url: string | null;
      status: string; // the site's own labels, read the values off a result, never guess one from prose; e.g. "Questionable", "Out"
      statusAbbr: string;
      description: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getInjuries

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getInjuries({ league: "nfl" });
  • getNewsReads a league's News tab, all story headlines, links, sources and publication times from Yahoo Sports' own news page.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes

    Returns YahooSportsNews

    interface YahooSportsNewsStory {
      headline: string;
      url: string;
      source: string | null;
      published: string | null;
      tags: string[];
    }
    
    interface YahooSportsNews {
      league: string;
      stories: YahooSportsNewsStory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getNews({ league: "nfl" });
  • getOddsReads a league's current betting lines off the site's own Odds page.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes

    Returns YahooSportsOddsGame[]

    interface YahooSportsOddsTeamLine {
      team: string; // full display name, e.g. "Indianapolis Colts", a label, not a teamSlug
      abbr: string; // e.g. "IND", getSchedule/getTeamRoster/findPlayers take this as teamSlug
      spread: string | null; // e.g. "-3.5", null if the market has not posted one
      spreadNote: string | null;
      total: string | null; // WITH its own over/under marker, e.g. "O 48.5", "U 48.5"
      totalNote: string | null;
      moneyline: string | null; // American odds, e.g. "-207", "+167"
      moneylineNote: string | null;
    }
    
    interface YahooSportsOddsGame {
      league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball";
      // Always away-then-home, the same order as getScoreboard's own data, the
      // page itself labels neither side.
      teams: [YahooSportsOddsTeamLine, YahooSportsOddsTeamLine];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getOdds

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getOdds({ league: "nfl" });
  • getPlayerReads one player's profile and current-season stat line off their own player page.

    Arguments

    NameTypeRequired
    playerUrlstringYes

    Returns YahooSportsPlayerDetail

    interface YahooSportsPlayerStat {
      name: string;
      abbreviation: string;
      value: string;
    }
    
    interface YahooSportsPlayerStatGroup {
      category: string;
      stats: YahooSportsPlayerStat[];
    }
    
    interface YahooSportsPlayerDetail {
      playerId: string;
      name: string;
      position: string;
      team: string; // display label, e.g. "Detroit Lions"
      teamSlug: string | null; // e.g. "detroit", getSchedule/getTeamRoster/findPlayers take this as teamSlug
      college: string | null;
      displayHeight: string | null;
      weight: number | null;
      birthDate: string | null;
      jerseyNumber: string | null;
      status: string | null; // the site's own labels, read the values off a result, never guess one from prose
      currentSeasonStats: YahooSportsPlayerStatGroup[];
      recentGames: YahooSportsPlayerRecentGame[]; // last THREE games only, newest first; may reach into last season; [] off-season
    }
    
    interface YahooSportsPlayerRecentGame {
      season: number | null;
      week: number | null;
      date: string | null;
      seasonPhase: string | null;
      result: string | null; // e.g. "L 24-28", the player's team first
      opponent: string | null;
      opponentAbbr: string | null;
      home: boolean | null;
      gameUrl: string | null; // the url getGame takes
      stats: YahooSportsPlayerStat[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getPlayer

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getPlayer({ playerUrl: "<playerUrl>" });
  • getPlayerNewsReads one player's News tab.

    Arguments

    NameTypeRequired
    playerUrlstring
    The url getPlayer takes, e.g. "https://sports.yahoo.com/nfl/players/30123/".
    Yes

    Returns YahooSportsPlayerNews

    interface YahooSportsPlayerNewsItem {
      headline: string;
      url: string; // the item's page on Yahoo Sports
      sourceUrl: string | null; // the publisher's own copy, when it differs
      provider: string | null; // e.g. "Chiefs Wire", "NBC Sports"
      author: string | null;
      published: string | null; // ISO timestamp
      summary: string | null;
    }
    
    interface YahooSportsPlayerNews {
      playerUrl: string;
      stories: YahooSportsPlayerNewsItem[]; // the player's story stream, newest first (about ten)
      videos: YahooSportsPlayerNewsItem[]; // the player's video rail (about thirty), team-level clips mixed in
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getPlayerNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getPlayerNews({ playerUrl: "<playerUrl>" });
  • getRankingsReads a college poll, who is ranked, off Yahoo's own Rankings page and the rankings service behind it: college football AP Top 25, Coaches and the…

    Arguments

    NameTypeRequired
    league"college-football" | "college-basketball"
    Default "college-football".
    No
    pollstring
    College-basketball: "AP_TOP_25" (default) | "USA_TODAY_ESPN".
    No
    datestring
    YYYY-MM-DD, the poll in force that day; default the latest.
    No

    Returns YahooSportsRankings

    interface YahooSportsRankingRow {
      rank: number;
      previousRank: number | null; // null when unranked last week
      team: string;
      teamId: string | null;
      teamUrl: string | null; // the team's page
      wins: number | null;
      losses: number | null;
      points: number | null; // poll points (AP, Coaches); null for the CFP
    }
    
    interface YahooSportsRankings {
      league: string;
      poll: string; // e.g. "AP_TOP_25"
      pollName: string | null; // e.g. "AP Top 25"
      date: string | null; // the poll's release date, YYYY-MM-DD
      week: number | null;
      rankings: YahooSportsRankingRow[]; // rank order, usually 25
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getRankings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getRankings({ league: "college-football", poll: "AP_TOP_25" });
  • getRssFeedReads a league's own RSS feed the way finance.yahoo.com/news/rssindex does for markets.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes

    Returns YahooSportsRssFeedItem[]

    interface YahooSportsRssFeedItem {
      title: string | null;
      link: string | null;
      published: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getRssFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getRssFeed({ league: "nfl" });
  • getScheduleReads a team's full schedule for the season the way its own Schedule page does.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes
    teamSlugstring
    Return it, or an exact team name/abbreviation (getOdds' abbr "IND"), resolved via standings.
    Yes

    Returns YahooSportsScheduleRow[]

    interface YahooSportsScheduleRow {
      league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball";
      opponent: string;
      date: string;
      result: "W" | "L" | "T" | null;
      score: string | null;
      isHome: boolean;
      // This game's own page, the gameUrl getGame takes. Null only if Yahoo's
      // own payload omitted alias.url for this game, which was not observed in
      // measurement.
      gameUrl: string | null;
      // "FINAL", "PREGAME", …
      status: string | null;
      week: number | null;
      // "PRESEASON", "REGULAR_SEASON", …
      seasonPhase: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getSchedule

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getSchedule({ league: "nfl", teamSlug: "detroit" });
  • getScoreboardReads games for one league.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes
    weeknumber
    Optional week number (1-17) for football leagues; filters to that week's games.
    No
    datestring
    Optional date for daily leagues; filters to that day's games.
    No

    Returns YahooSportsGameRow[]

    interface YahooSportsGameRow {
      league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball";
      name: string;
      homeTeam: string;
      awayTeam: string;
      homeScore: number | null;
      awayScore: number | null;
      status: "scheduled" | "in_progress" | "final";
      startDate: string;
      venue: string | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getScoreboard

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getScoreboard({ league: "nfl" });
  • getStandingsReads a league's full standings table the way its own Standings page does.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes

    Returns YahooSportsStandingsRow[]

    interface YahooSportsStandingsRow {
      league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball";
      team: string;
      // The site's own short team slug off that team's /teams/<slug>/ page,
      // e.g. "detroit", "ny-yankees", the same slug getSchedule, getTeamRoster
      // and findPlayers all take as teamSlug. Null if the row's anchor is missing.
      slug: string | null;
      wins: number;
      losses: number;
      ties: number;
      winPercentage: number;
      pointsFor: number;
      pointsAgainst: number;
      pointsDifferential: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getStandings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getStandings({ league: "nfl" });
  • getStatLeadersReads the season-to-date individual leaderboard for one category off the site's own Stats page.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes
    categorystring
    "Scoring", these differ per league and are not a closed set.
    Yes

    Returns YahooSportsStatLeaderRow[]

    interface YahooSportsStatLeaderRow {
      league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball";
      category: string; // the site's own category heading, verbatim
      rank: number;
      name: string;
      url: string | null;
      team: string | null; // an abbreviation ("PIT") or team nickname ("Saints") depending on Yahoo's own CDN asset for that row, null for a team-level row. getSchedule/getTeamRoster/findPlayers take an abbreviation as teamSlug; a nickname is refused (pass listTeams' slug)
      value: string; // the site's own displayed value, not re-parsed (some categories are decimals)
      statLabel: string; // the site's own label for what value measures, e.g. "Passing Yards"
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getStatLeaders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getStatLeaders({ league: "nfl", category: "Passing" });
  • getTeamNewsReads one team's own News tab.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes
    teamSlugstring
    ListTeams()' slug, e.g. "kansas-city", or an exact team name/abbreviation.
    Yes

    Returns YahooSportsTeamNews

    interface YahooSportsPlayerNewsItem {
      headline: string;
      url: string; // the item's page on Yahoo Sports
      sourceUrl: string | null; // the publisher's own copy, when it differs
      provider: string | null; // e.g. "Chiefs Wire", "NBC Sports"
      author: string | null;
      published: string | null; // ISO timestamp
      summary: string | null;
    }
    
    interface YahooSportsTeamNews {
      league: string;
      teamSlug: string;
      stories: YahooSportsPlayerNewsItem[]; // the team's story stream, newest first (the first page, about five)
      videos: YahooSportsPlayerNewsItem[]; // the team's video rail (about thirty)
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getTeamNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getTeamNews({ league: "nfl", teamSlug: "kansas-city" });
  • getTeamRosterReads one team's current roster the way its own Roster page does.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes
    teamSlugstring
    Abbreviation (getOdds' abbr "IND") is resolved via standings; no fuzzy guess.
    Yes

    Returns YahooSportsRosterRow[]

    interface YahooSportsRosterRow {
      league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball";
      playerId: string;
      name: string;
      position: string;
      jerseyNumber: string | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getTeamRoster

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getTeamRoster({ league: "nfl", teamSlug: "detroit" });
  • getTeamStatsReads one team's season stats off its own Stats page.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes
    teamSlugstring
    ListTeams()' slug, e.g. "kansas-city", or an exact team name/abbreviation.
    Yes

    Returns YahooSportsTeamStats

    interface YahooSportsTeamStatValue {
      key: string; // the site's own stable column id, e.g. "PASSING_YARDS", unique within a category
      label: string; // the short label as rendered, e.g. "Yds", not unique
      title: string | null; // the long name, e.g. "Passing Yards"
      value: string; // the displayed value, verbatim ("1795", "66.4", "34:23", "3-3")
    }
    
    interface YahooSportsTeamStatPlayer {
      name: string;
      playerId: string | null;
      url: string | null; // the url getPlayer takes
      stats: YahooSportsTeamStatValue[];
    }
    
    interface YahooSportsTeamStatCategory {
      category: string; // the site's own heading, verbatim, "Passing", "Rushing", "Averages"
      players: YahooSportsTeamStatPlayer[];
    }
    
    interface YahooSportsTeamStats {
      league: string;
      teamSlug: string;
      categories: YahooSportsTeamStatCategory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/getTeamStats

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.getTeamStats({ league: "nfl", teamSlug: "kansas-city" });
  • listTeamsLists every team in a league.

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"Yes

    Returns YahooSportsTeamRow[]

    interface YahooSportsTeamRow {
      league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball";
      team: string;
      // The site's own short team slug off that team's /teams/<slug>/ page,
      // e.g. "detroit", "ny-yankees", the same slug getSchedule, getTeamRoster
      // and findPlayers all take as teamSlug. Null if the row's anchor is missing.
      slug: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/listTeams

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.listTeams({ league: "nfl" });
  • searchPlayersSearches for a player by name across every league: NFL, NBA, MLB, NHL, college football, college basketball.

    Arguments

    NameTypeRequired
    querystring
    A player's name or part of it, e.g. "lebron", "geno smith".
    Yes
    league"nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball"No

    Returns YahooSportsPlayerSearchRow[]

    interface YahooSportsPlayerSearchRow {
      league: "nfl" | "nba" | "mlb" | "nhl" | "college-football" | "college-basketball";
      playerId: string;
      name: string;
      position: string | null;
      team: string | null; // display label, e.g. "NY Jets", not a teamSlug
      active: boolean; // false for a retired/inactive player
      url: string; // the url getPlayer takes
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/yahoo_sports/searchPlayers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.yahoo_sports.searchPlayers({ query: "smith" });

Use it from code