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.

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

Connect

Just The New York Times

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/nytimes
Every site

One 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/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 25
  • getArticleGets full article text, metadata and comments count.

    Arguments

    NameTypeRequired
    pathstringYes

    Returns NytimesArticle

    interface 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/getArticle

    Call 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");
  • getArticleCommentsReads an article's reader comments, newest or oldest first.

    Arguments

    NameTypeRequired
    pathstringYes
    sort"newest" | "oldest"No
    limitnumberNo
    offsetnumberNo

    Returns NytimesArticleComments

    interface 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/getArticleComments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.getArticleComments("/2026/09/28/world/americas/venezuela-gold-trump.html");
  • getConnectionsGets a day's Connections puzzle.

    Arguments

    NameTypeRequired
    datestringNo

    Returns NytimesConnectionsPuzzle

    interface 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/getConnections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.getConnections("2024-01-01");
  • getLiveBlogGets live blog updates (breaking news, events).

    Arguments

    NameTypeRequired
    slugstringYes
    limitnumberNo

    Returns NytimesLiveBlog

    interface 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/getLiveBlog

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    slugstringYes

    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/getNewsletter

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.getNewsletter("the-veggie");
  • getPodcastGets podcast details.

    Arguments

    NameTypeRequired
    slugstringYes

    Returns NytimesPodcast

    interface NytimesPodcast {
      id: string;
      slug: string;
      title: string;
      description?: string;
      imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nytimes/getPodcast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.getPodcast("the-daily");
  • getSectionGets a section front's own id and slug plus its article grid.

    Arguments

    NameTypeRequired
    sectionstringYes
    limitnumberNo
    offsetnumberNo

    Returns NytimesSectionDetail

    interface 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/getSection

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.getSection("world");
  • getSpellingBeeGets a day's Spelling Bee puzzle.

    Arguments

    NameTypeRequired
    datestringNo

    Returns NytimesSpellingBeePuzzle

    interface 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/getSpellingBee

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.getSpellingBee();
  • getTopicArticlesGets a topic (spotlight) page's own name and article grid.

    Arguments

    NameTypeRequired
    topicstringYes
    limitnumberNo
    offsetnumberNo

    Returns NytimesTopicDetail

    interface 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/getTopicArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.getTopicArticles("artificial-intelligence");
  • getTrendingGets one of the /trending/ page's own five OTHER popularity lists by name (default "mostViewed").

    Arguments

    NameTypeRequired
    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/getTrending

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.getTrending("mostViewed");
  • getWordleGets a day's Wordle puzzle.

    Arguments

    NameTypeRequired
    datestringNo

    Returns NytimesWordlePuzzle

    interface NytimesWordlePuzzle {
      id: number;
      solution: string;
      printDate: string;
      daysSinceLaunch: number;
      editor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nytimes/getWordle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.getWordle("2024-01-01");
  • getWriterGets a writer's own profile off their /by/<slug> page.

    Arguments

    NameTypeRequired
    writerstringYes

    Returns NytimesWriterProfile

    interface NytimesWriterProfile {
      slug: string;
      name: string;
      url: string;
      bio?: string;
      twitter?: string;
      lastModified?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nytimes/getWriter

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.getWriter("maggie-haberman");
  • listArticlesLists a section's own article grid, newest first, with metadata.

    Arguments

    NameTypeRequired
    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/listArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.listArticles("world");
  • listEpisodesLists a podcast's own episodes off its column page.

    Arguments

    NameTypeRequired
    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/listEpisodes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    pathstringYes
    limitnumberNo

    Returns NytimesMyCommentsResult

    interface 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/listMyComments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listNewsletters

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listPodcasts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listRSSFeeds

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.listRSSFeeds();
  • listSavedArticlesThe signed-in reader's saved articles (Reading List), newest first.

    Arguments

    None.

    Returns NytimesSavedArticlesResult

    interface 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/listSavedArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listSections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.listSections();
  • listTopicsLists NYT's own 'topic' (spotlight) pages off its collections sitemap, most recently active first.

    Arguments

    NameTypeRequired
    limitnumberNo
    offsetnumberNo

    Returns NytimesTopic[]

    interface NytimesTopic {
      slug: string;
      name: string;
      url: string;
      lastModified?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nytimes/listTopics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.listTopics(5);
  • listTrendingLists the site's own trending articles from /trending/.

    Arguments

    NameTypeRequired
    limitnumberNo
    offsetnumberNo

    Returns NytimesTrendingItem[]

    interface NytimesTrendingItem {
      id: string;
      headline?: string;
      summary?: string;
      url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nytimes/listTrending

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.listTrending();
  • listWriterArticlesGets the most recent articles and videos off a writer's own byline page.

    Arguments

    NameTypeRequired
    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/listWriterArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.listWriterArticles("maggie-haberman");
  • searchArticlesSearches articles by keyword with pagination.

    Arguments

    NameTypeRequired
    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/searchArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/searchWriters

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.searchWriters("haberman");
Act 6
  • followWriterFollows one NYT writer for the signed-in reader by pressing the follow control on their /by/<slug> byline page.

    Arguments

    NameTypeRequired
    writerstringYes

    Returns NytimesFollowWriterResult

    interface 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/followWriter

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    pathstringYes
    bodystringYes

    Returns NytimesPostCommentResult

    interface 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/postComment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.postComment("<path>", "<body>");
  • recommendCommentPresses Recommend on one reader comment under an article as the signed-in reader.

    Arguments

    NameTypeRequired
    pathstringYes
    commentIdstringYes

    Returns NytimesRecommendCommentResult

    interface NytimesRecommendCommentResult {
      url: string;
      commentId: string;
      recommended: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nytimes/recommendComment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.recommendComment("<path>", "<commentId>");
  • saveArticleSaves one article to the signed-in reader's Reading List.

    Arguments

    NameTypeRequired
    pathstringYes

    Returns NytimesSaveArticleResult

    interface NytimesSaveArticleResult {
      url: string; // the article that was saved
      saved: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nytimes/saveArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.saveArticle("<path>");
  • unfollowWriterUnfollows one NYT writer for the signed-in reader by pressing the same follow control followWriter does.

    Arguments

    NameTypeRequired
    writerstringYes

    Returns NytimesFollowWriterResult

    interface 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/unfollowWriter

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    pathstringYes

    Returns NytimesUnsaveArticleResult

    interface NytimesUnsaveArticleResult {
      url: string; // the article that was unsaved
      saved: false;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nytimes/unsaveArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nytimes.unsaveArticle("<path>");

Use it from code