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.
- Site
- usatoday.com
- Functions
- 13
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/usatodayOne 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/mcpSet it up in your clientBoth 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.
browseSectionLists articles in one USA Today section, paginated, showing headline, summary, URL, date and image.Arguments
Name Type Required 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/browseSectionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.browseSection({ sectionId: "news" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.browseSection({"sectionId": "news"}))curl -X POST https://api.bowmark.ai/v1/sites/usatoday/browseSection \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"sectionId":"news"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required urlstringYes Returns
usatodayFullArticleinterface 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/getArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.getArticle({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.getArticle({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/usatoday/getArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required idstringA crossword id (uuid) from an earlier result's id; omit for today's puzzle.No Returns
usatodayCrosswordinterface 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/getCrosswordCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.getCrossword({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.getCrossword({}))curl -X POST https://api.bowmark.ai/v1/sites/usatoday/getCrossword \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.usatoday.getCrossword({});getPuzzleReads one USA Today puzzle puzzle.Arguments
Name Type Required idstringYes Returns
usatodayPuzzleDetailinterface usatodayPuzzleDetail { id: string; name: string; type: string; difficulty?: string; date: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/usatoday/getPuzzleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.getPuzzle({ id: "word-wipe" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.getPuzzle({"id": "word-wipe"}))curl -X POST https://api.bowmark.ai/v1/sites/usatoday/getPuzzle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"word-wipe"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.usatoday.getPuzzle({ id: "word-wipe" });getScoresReads sports scores from USA Today's scores section.Arguments
Name Type Required 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/getScoresCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.getScores({ sport: "NFL" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.getScores({"sport": "NFL"}))curl -X POST https://api.bowmark.ai/v1/sites/usatoday/getScores \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"sport":"NFL"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.usatoday.getScores({ sport: "NFL" });getStandingsReads the current league standings from USA Today Sports.Arguments
Name Type Required 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/getStandingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.getStandings({ league: "NFL" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.getStandings({"league": "NFL"}))curl -X POST https://api.bowmark.ai/v1/sites/usatoday/getStandings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"NFL"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required urlstringThe url of a listVideos row, verbatim.Yes Returns
usatodayVideoDetailinterface 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/getVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.getVideo({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.getVideo({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/usatoday/getVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listHomepageHeadlinesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.listHomepageHeadlines();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.listHomepageHeadlines())curl -X POST https://api.bowmark.ai/v1/sites/usatoday/listHomepageHeadlines \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listNewslettersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.listNewsletters();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.listNewsletters())curl -X POST https://api.bowmark.ai/v1/sites/usatoday/listNewsletters \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listPuzzlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.listPuzzles();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.listPuzzles())curl -X POST https://api.bowmark.ai/v1/sites/usatoday/listPuzzles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listSectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.listSections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.listSections())curl -X POST https://api.bowmark.ai/v1/sites/usatoday/listSections \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.listVideos();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.listVideos())curl -X POST https://api.bowmark.ai/v1/sites/usatoday/listVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchNewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.usatoday.searchNews({ query: "politics" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.usatoday.searchNews({"query": "politics"}))curl -X POST https://api.bowmark.ai/v1/sites/usatoday/searchNews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"politics"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.usatoday.searchNews({ query: "politics" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/usatoday/<function> - OpenAPI
/v1/sites/usatoday/openapi.json