USA Today MCP server for AI agents

Let Claude, ChatGPT or your own agent read USA Today: 13 typed functions through one MCP server. No USA Today API key needed.

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

Connect

Just USA Today

An MCP server for USA Today 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/usatoday
Every site

One MCP server for USA Today 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 13
  • browseSectionLists articles in one USA Today section, paginated, showing headline, summary, URL, date and image.

    Arguments

    NameTypeRequired
    sectionIdstringYes
    limitnumberNo
    pagenumberNo

    Returns usatodayArticle[]

    interface usatodayArticle {
      id: string;
      headline: string;
      summary?: string;
      url: string;
      publicationDate?: string;
      image?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/browseSection

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.browseSection({ sectionId: "news" });
  • getArticleReads the full text of one USA Today article, returning headline, byline, body text, publication and update dates, section, image, and whether it is…

    Arguments

    NameTypeRequired
    urlstringYes

    Returns usatodayFullArticle

    interface usatodayFullArticle {
      id: string;
      headline: string;
      byline?: string;
      body: string;
      publicationDate: string;
      updateDate?: string;
      section?: string;
      image?: string;
      isAccessibleForFree: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/getArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.getArticle({ url: "<url>" });
  • getCrosswordReads today's USA TODAY Crossword, or one by id: title, date, constructor, grid size and every across and down clue with its number.

    Arguments

    NameTypeRequired
    idstring
    A crossword id (uuid) from an earlier result's id; omit for today's puzzle.
    No

    Returns usatodayCrossword

    interface usatodayCrosswordClue {
      number: number;
      clue: string;
    }
    
    interface usatodayCrossword {
      id: string;
      title: string;
      date: string;
      author?: string;
      editor?: string;
      copyright?: string;
      width: number;
      height: number;
      across: usatodayCrosswordClue[];
      down: usatodayCrosswordClue[];
      /** The page a person plays it on. */
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/getCrossword

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.getCrossword({});
  • getPuzzleReads one USA Today puzzle puzzle.

    Arguments

    NameTypeRequired
    idstringYes

    Returns usatodayPuzzleDetail

    interface usatodayPuzzleDetail {
      id: string;
      name: string;
      type: string;
      difficulty?: string;
      date: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/getPuzzle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.getPuzzle({ id: "word-wipe" });
  • getScoresReads sports scores from USA Today's scores section.

    Arguments

    NameTypeRequired
    sportstringYes

    Returns usatodayScore[]

    interface usatodayScore {
      id: string;
      homeTeam: string;
      awayTeam: string;
      homeScore: number;
      awayScore: number;
      date: string;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/getScores

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.getScores({ sport: "NFL" });
  • getStandingsReads the current league standings from USA Today Sports.

    Arguments

    NameTypeRequired
    leaguestring
    "NFL", "NBA", "MLB", "NHL", "NCAAF", "NCAAM", "NCAAW", "WNBA", "MLS" or "EPL".
    Yes

    Returns usatodayStanding[]

    interface usatodayStanding {
      team: string;
      abbreviation?: string;
      conference?: string;
      division?: string;
      divisionRank?: number;
      gamesBehind?: number;
      wins: number;
      losses: number;
      ties?: number;
      pct?: string;
      pointsFor?: number;
      pointsAgainst?: number;
      /** e.g. "W4" or "L2". */
      streak?: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.getStandings({ league: "NFL" });
  • getVideoReads one USA Today video, given the url a listVideos row returns, returning its title, description, duration, publish date, thumbnail and video file…

    Arguments

    NameTypeRequired
    urlstring
    The url of a listVideos row, verbatim.
    Yes

    Returns usatodayVideoDetail

    interface usatodayVideoDetail {
      id: string;
      title: string;
      description?: string;
      url: string;
      thumbnailUrl?: string;
      /** ISO 8601 duration as the page publishes it, e.g. `PT40S`. */
      duration?: string;
      publishDate?: string;
      /** The video file itself (an mp4 on gannett-cdn.com), when the page names one. */
      contentUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/getVideo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.getVideo({ url: "<url>" });
  • listHomepageHeadlinesReads the USA Today homepage and returns the top headlines currently displayed.

    Arguments

    None.

    Returns usatodayArticle[]

    interface usatodayArticle {
      id: string;
      headline: string;
      summary?: string;
      url: string;
      publicationDate?: string;
      image?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/listHomepageHeadlines

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.listHomepageHeadlines();
  • listNewslettersLists every USA Today email newsletter, each with an id, name, description, topic group, how often it is sent and a sign-up page URL.

    Arguments

    None.

    Returns usatodayNewsletter[]

    interface usatodayNewsletter {
      id: string;
      name: string;
      description?: string;
      group?: string;
      frequency?: string;
      popular?: boolean;
      url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/listNewsletters

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.listNewsletters();
  • listPuzzlesLists the puzzles on USA Today's puzzles hub (crossword, Sudoku, KenKen, word games and more), each with an id, display name and play URL.

    Arguments

    None.

    Returns usatodayPuzzle[]

    interface usatodayPuzzle {
      id: string;
      name: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/listPuzzles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.listPuzzles();
  • listSectionsLists the sections in USA Today's own navigation (news, politics, sports, entertainment, money, travel, tech, opinion and more), each with a section…

    Arguments

    None.

    Returns usatodaySection[]

    interface usatodaySection {
      id: string;
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/listSections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.listSections();
  • listVideosLists the videos on USA Today's videos hub, each with a title, description, thumbnail URL and publish date.

    Arguments

    None.

    Returns usatodayVideo[]

    interface usatodayVideo {
      id: string;
      title: string;
      description?: string;
      url: string;
      thumbnailUrl?: string;
      duration?: string;
      publishDate?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/listVideos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.listVideos();
  • searchNewsSearches USA Today's news archive for articles matching a free-text query, returning headline, summary, URL, publication date, section and image.

    Arguments

    NameTypeRequired
    querystringYes
    limitnumberNo
    pagenumberNo

    Returns usatodayArticle[]

    interface usatodayArticle {
      id: string;
      headline: string;
      summary?: string;
      url: string;
      publicationDate?: string;
      image?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/usatoday/searchNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.usatoday.searchNews({ query: "politics" });

Use it from code