The New York Times MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on The New York Times: 31 typed functions through one MCP server. No The New York Times API key needed.
- Site
- nytimes.com
- Functions
- 31
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for The New York Times 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/nytimesOne MCP server for The New York Times 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.
getArticleGets full article text, metadata and comments count.Arguments
Name Type Required pathstringYes Returns
NytimesArticleinterface NytimesArticle { id: string; headline?: string; description?: string; body?: string; tone?: string; section?: NytimesArticleSection; // pass it (or its slug) to listArticles / getSection bylines?: Array<{ name: string }>; firstPublished?: string; lastModified?: string; commentsCount?: number; warnings?: string[]; } interface NytimesArticleSection { name: string; // the site's short name, e.g. "world" displayName?: string; // e.g. "World" slug?: string; // e.g. "world" or "world/middleeast", what listArticles and getSection take url?: string; // e.g. "https://www.nytimes.com/section/world", also accepted by listArticles and getSection }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getArticle("/2026/09/26/world/middleeast/israel-netanyahu-gali-baharav-miara-attorney-general.html");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getArticle("/2026/09/26/world/middleeast/israel-netanyahu-gali-baharav-miara-attorney-general.html"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"/2026/09/26/world/middleeast/israel-netanyahu-gali-baharav-miara-attorney-general.html"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.getArticle("/2026/09/26/world/middleeast/israel-netanyahu-gali-baharav-miara-attorney-general.html");getArticleCommentsReads an article's reader comments, newest or oldest first.Arguments
Name Type Required pathstringYes sort"newest" | "oldest"No limitnumberNo offsetnumberNo Returns
NytimesArticleCommentsinterface NytimesComment { id: string; author: string; location?: string; body: string; createdAt: string; recommendations: number; replyCount: number; editorsSelection: boolean; parentId?: string; } interface NytimesArticleComments { totalCount: number; commentsEnabled: boolean; comments: NytimesComment[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getArticleCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getArticleComments("/2026/09/28/world/americas/venezuela-gold-trump.html");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getArticleComments("/2026/09/28/world/americas/venezuela-gold-trump.html"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getArticleComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"/2026/09/28/world/americas/venezuela-gold-trump.html"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.getArticleComments("/2026/09/28/world/americas/venezuela-gold-trump.html");getConnectionsGets a day's Connections puzzle.Arguments
Name Type Required datestringNo Returns
NytimesConnectionsPuzzleinterface NytimesConnectionsCard { content: string; position: number; } interface NytimesConnectionsCategory { title: string; cards: NytimesConnectionsCard[]; } interface NytimesConnectionsPuzzle { id: number; printDate: string; editor?: string; categories: NytimesConnectionsCategory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getConnectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getConnections("2024-01-01");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getConnections("2024-01-01"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getConnections \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"date":"2024-01-01"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.getConnections("2024-01-01");getLiveBlogGets live blog updates (breaking news, events).Arguments
Name Type Required slugstringYes limitnumberNo Returns
NytimesLiveBloginterface NytimesLiveBlogUpdate { id: string; title: string; summary?: string; timestamp: string; } interface NytimesLiveBlog { slug: string; title: string; summary?: string; updates: NytimesLiveBlogUpdate[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getLiveBlogCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getLiveBlog("/live/2026/11/05/us/midterm-elections-democrats-trump");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getLiveBlog("/live/2026/11/05/us/midterm-elections-democrats-trump"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getLiveBlog \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slug":"/live/2026/11/05/us/midterm-elections-democrats-trump"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.getLiveBlog("/live/2026/11/05/us/midterm-elections-democrats-trump");getNewsletterGets one newsletter's own catalog entry (title, caption, frequency, sample).Arguments
Name Type Required slugstringYes Returns
NytimesNewsletterinterface NytimesNewsletter { id: string; slug: string; title: string; caption?: string; frequency?: string; sampleUrl?: string; thumbImageUrl?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getNewsletterCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getNewsletter("the-veggie");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getNewsletter("the-veggie"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getNewsletter \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slug":"the-veggie"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.getNewsletter("the-veggie");getPodcastGets podcast details.Arguments
Name Type Required slugstringYes Returns
NytimesPodcastinterface NytimesPodcast { id: string; slug: string; title: string; description?: string; imageUrl?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getPodcastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getPodcast("the-daily");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getPodcast("the-daily"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getPodcast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slug":"the-daily"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.getPodcast("the-daily");getSectionGets a section front's own id and slug plus its article grid.Arguments
Name Type Required sectionstringYes limitnumberNo offsetnumberNo Returns
NytimesSectionDetailinterface NytimesArticleSummary { id: string; url?: string; headline?: string; summary?: string; kicker?: string; bylines?: Array<{ name: string }>; lastModified?: string; } interface NytimesSectionDetail { id: string; slug: string; articles: NytimesArticleSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getSectionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getSection("world");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getSection("world"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getSection \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"section":"world"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.getSection("world");getSpellingBeeGets a day's Spelling Bee puzzle.Arguments
Name Type Required datestringNo Returns
NytimesSpellingBeePuzzleinterface NytimesSpellingBeePuzzle { id: number; printDate: string; editor?: string; centerLetter: string; outerLetters: string[]; validWords: string[]; pangrams: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getSpellingBeeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getSpellingBee();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getSpellingBee())curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getSpellingBee \ -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.nytimes.getSpellingBee();getTopicArticlesGets a topic (spotlight) page's own name and article grid.Arguments
Name Type Required topicstringYes limitnumberNo offsetnumberNo Returns
NytimesTopicDetailinterface NytimesArticleSummary { id: string; url?: string; headline?: string; summary?: string; kicker?: string; bylines?: Array<{ name: string }>; lastModified?: string; } interface NytimesTopicDetail { slug: string; name: string; summary?: string; articles: NytimesArticleSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getTopicArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getTopicArticles("artificial-intelligence");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getTopicArticles("artificial-intelligence"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getTopicArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"topic":"artificial-intelligence"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.getTopicArticles("artificial-intelligence");getTrendingGets one of the /trending/ page's own five OTHER popularity lists by name (default "mostViewed").Arguments
Name Type Required list"trending" | "recipes" | "videos" | "mostViewed" | "mostFacebooked" | "mostEmailed"No limitnumberNo offsetnumberNo Returns
NytimesPopularItem[]interface NytimesPopularItem { id: string; type: string; headline?: string; summary?: string; url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getTrendingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getTrending("mostViewed");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getTrending("mostViewed"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getTrending \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"list":"mostViewed"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.getTrending("mostViewed");getWordleGets a day's Wordle puzzle.Arguments
Name Type Required datestringNo Returns
NytimesWordlePuzzleinterface NytimesWordlePuzzle { id: number; solution: string; printDate: string; daysSinceLaunch: number; editor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getWordleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getWordle("2024-01-01");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getWordle("2024-01-01"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getWordle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"date":"2024-01-01"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.getWordle("2024-01-01");getWriterGets a writer's own profile off their /by/<slug> page.Arguments
Name Type Required writerstringYes Returns
NytimesWriterProfileinterface NytimesWriterProfile { slug: string; name: string; url: string; bio?: string; twitter?: string; lastModified?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/getWriterCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.getWriter("maggie-haberman");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.getWriter("maggie-haberman"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/getWriter \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"writer":"maggie-haberman"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.getWriter("maggie-haberman");listArticlesLists a section's own article grid, newest first, with metadata.Arguments
Name Type Required sectionstringYes limitnumberNo offsetnumberNo Returns
NytimesArticleSummary[]interface NytimesArticleSummary { id: string; url?: string; headline?: string; summary?: string; kicker?: string; bylines?: Array<{ name: string }>; lastModified?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/listArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.listArticles("world");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.listArticles("world"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/listArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"section":"world"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.listArticles("world");listEpisodesLists a podcast's own episodes off its column page.Arguments
Name Type Required slugstringYes Returns
NytimesEpisode[]interface NytimesEpisode { id: string; url?: string; headline?: string; summary?: string; publishedAt?: string; byline?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/listEpisodesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.listEpisodes("the-daily");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.listEpisodes("the-daily"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/listEpisodes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slug":"the-daily"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.listEpisodes("the-daily");listMyCommentsThe signed-in reader's own comments on one article, read from the same community API thread getArticleComments reads.Arguments
Name Type Required pathstringYes limitnumberNo Returns
NytimesMyCommentsResultinterface NytimesComment { id: string; author: string; location?: string; body: string; createdAt: string; recommendations: number; replyCount: number; editorsSelection: boolean; parentId?: string; } interface NytimesMyCommentsResult { url: string; // the article whose thread was read comments: NytimesComment[]; // only the signed-in reader's own comments on it }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/listMyCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.listMyComments("/2026/09/28/world/americas/venezuela-gold-trump.html");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.listMyComments("/2026/09/28/world/americas/venezuela-gold-trump.html"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/listMyComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"/2026/09/28/world/americas/venezuela-gold-trump.html"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.listMyComments("/2026/09/28/world/americas/venezuela-gold-trump.html");listNewslettersLists NYT's own email newsletters off the signup page's catalog tray.Arguments
None.
Returns
NytimesNewsletter[]interface NytimesNewsletter { id: string; slug: string; title: string; caption?: string; frequency?: string; sampleUrl?: string; thumbImageUrl?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/listNewslettersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.listNewsletters();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.listNewsletters())curl -X POST https://api.bowmark.ai/v1/sites/nytimes/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.nytimes.listNewsletters();listPodcastsLists NYT podcasts.Arguments
None.
Returns
NytimesPodcast[]interface NytimesPodcast { id: string; slug: string; title: string; description?: string; imageUrl?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/listPodcastsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.listPodcasts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.listPodcasts())curl -X POST https://api.bowmark.ai/v1/sites/nytimes/listPodcasts \ -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.nytimes.listPodcasts();listRSSFeedsLists every RSS feed the site's own /rss index publishes, with its title, url and nav group.Arguments
None.
Returns
NytimesRssFeed[]interface NytimesRssFeed { title: string; url: string; group: string; // the site's own nav heading, e.g. "News", "Opinion", "Culture & Lifestyle" }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/listRSSFeedsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.listRSSFeeds();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.listRSSFeeds())curl -X POST https://api.bowmark.ai/v1/sites/nytimes/listRSSFeeds \ -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.nytimes.listRSSFeeds();listSavedArticlesThe signed-in reader's saved articles (Reading List), newest first.Arguments
None.
Returns
NytimesSavedArticlesResultinterface NytimesArticleSummary { id: string; url?: string; headline?: string; summary?: string; kicker?: string; bylines?: Array<{ name: string }>; lastModified?: string; } interface NytimesSavedArticlesResult { articles: NytimesArticleSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/listSavedArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.listSavedArticles();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.listSavedArticles())curl -X POST https://api.bowmark.ai/v1/sites/nytimes/listSavedArticles \ -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.nytimes.listSavedArticles();listSectionsLists all news sections (World, US, Business, etc.).Arguments
None.
Returns
NytimesSection[]interface NytimesSection { name: string; slug: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/listSectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.listSections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.listSections())curl -X POST https://api.bowmark.ai/v1/sites/nytimes/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.nytimes.listSections();listTopicsLists NYT's own 'topic' (spotlight) pages off its collections sitemap, most recently active first.Arguments
Name Type Required limitnumberNo offsetnumberNo Returns
NytimesTopic[]interface NytimesTopic { slug: string; name: string; url: string; lastModified?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/listTopicsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.listTopics(5);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.listTopics(5))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/listTopics \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"limit":5}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.listTopics(5);listTrendingLists the site's own trending articles from /trending/.Arguments
Name Type Required limitnumberNo offsetnumberNo Returns
NytimesTrendingItem[]interface NytimesTrendingItem { id: string; headline?: string; summary?: string; url?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/listTrendingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.listTrending();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.listTrending())curl -X POST https://api.bowmark.ai/v1/sites/nytimes/listTrending \ -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.nytimes.listTrending();listWriterArticlesGets the most recent articles and videos off a writer's own byline page.Arguments
Name Type Required writerstringYes Returns
NytimesWriterArticle[]interface NytimesWriterArticle { id: string; type: "article" | "video"; url?: string; headline?: string; summary?: string; kicker?: string; publishedAt?: string; byline?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/listWriterArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.listWriterArticles("maggie-haberman");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.listWriterArticles("maggie-haberman"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/listWriterArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"writer":"maggie-haberman"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.listWriterArticles("maggie-haberman");searchArticlesSearches articles by keyword with pagination.Arguments
Name Type Required querystringYes limitnumberNo offsetnumberNo Returns
NytimesSearchResult[]interface NytimesSearchResult { id: string; headline?: string; description?: string; url?: string; section?: string; // display name, e.g. "U.S.", listArticles / getSection resolve it by exact name bylines?: Array<{ name: string }>; firstPublished?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/searchArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.searchArticles("climate change");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.searchArticles("climate change"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/searchArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"climate change"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.searchArticles("climate change");searchWritersSearches NYT's own writers by name off its collections sitemap (the site publishes no writer search or directory). name is formatted from the slug…Arguments
Name Type Required querystringYes limitnumberNo offsetnumberNo Returns
NytimesWriter[]interface NytimesWriter { slug: string; name: string; url: string; lastModified?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/searchWritersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.searchWriters("haberman");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.searchWriters("haberman"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/searchWriters \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"haberman"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.searchWriters("haberman");
followWriterFollows one NYT writer for the signed-in reader by pressing the follow control on their /by/<slug> byline page.Arguments
Name Type Required writerstringYes Returns
NytimesFollowWriterResultinterface NytimesFollowWriterResult { url: string; // the writer's /by/<slug> page following: boolean; // true after followWriter, false after unfollowWriter }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/followWriterCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.followWriter("<writer>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.followWriter("<writer>"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/followWriter \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"writer":"<writer>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.followWriter("<writer>");postCommentPosts a comment as the signed-in reader under one article through the article's own comment box.Arguments
Name Type Required pathstringYes bodystringYes Returns
NytimesPostCommentResultinterface NytimesPostCommentResult { url: string; // the article the comment was submitted under posted: true; // NYT moderates: a posted comment is pending until approved }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/postCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.postComment("<path>", "<body>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.postComment("<path>", "<body>"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/postComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"<path>","body":"<body>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.postComment("<path>", "<body>");recommendCommentPresses Recommend on one reader comment under an article as the signed-in reader.Arguments
Name Type Required pathstringYes commentIdstringYes Returns
NytimesRecommendCommentResultinterface NytimesRecommendCommentResult { url: string; commentId: string; recommended: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/recommendCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.recommendComment("<path>", "<commentId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.recommendComment("<path>", "<commentId>"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/recommendComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"<path>","commentId":"<commentId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.recommendComment("<path>", "<commentId>");saveArticleSaves one article to the signed-in reader's Reading List.Arguments
Name Type Required pathstringYes Returns
NytimesSaveArticleResultinterface NytimesSaveArticleResult { url: string; // the article that was saved saved: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/saveArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.saveArticle("<path>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.saveArticle("<path>"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/saveArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"<path>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.saveArticle("<path>");unfollowWriterUnfollows one NYT writer for the signed-in reader by pressing the same follow control followWriter does.Arguments
Name Type Required writerstringYes Returns
NytimesFollowWriterResultinterface NytimesFollowWriterResult { url: string; // the writer's /by/<slug> page following: boolean; // true after followWriter, false after unfollowWriter }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/unfollowWriterCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.unfollowWriter("<writer>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.unfollowWriter("<writer>"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/unfollowWriter \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"writer":"<writer>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.unfollowWriter("<writer>");unsaveArticleRemoves an article from the signed-in reader's Reading List, by driving the same save button saveArticle does.Arguments
Name Type Required pathstringYes Returns
NytimesUnsaveArticleResultinterface NytimesUnsaveArticleResult { url: string; // the article that was unsaved saved: false; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nytimes/unsaveArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nytimes.unsaveArticle("<path>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nytimes.unsaveArticle("<path>"))curl -X POST https://api.bowmark.ai/v1/sites/nytimes/unsaveArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"<path>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nytimes.unsaveArticle("<path>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/nytimes/<function> - OpenAPI
/v1/sites/nytimes/openapi.json