The Washington Post MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on The Washington Post: 22 typed functions through one MCP server. No The Washington Post API key needed.

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

Connect

Just The Washington Post

An MCP server for The Washington Post 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/washingtonpost
Every site

One MCP server for The Washington Post 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
  • getArticleGets one article's own headline, byline, publish date, section and lede.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns WashingtonpostArticleDetail

    interface WashingtonpostArticleDetail {
      headline: string;
      byline?: string;
      url: string;
      publishDate?: string;
      section?: string;
      teaser?: string;
      lede?: string;
      isAccessibleForFree: boolean;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.getArticle("<url>");
  • getArticleFullTextGets the full text of a subscriber-only article using the CALLER's own Washington Post subscription.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns WashingtonpostArticleFullText

    interface WashingtonpostArticleFullText {
      headline: string;
      byline?: string;
      url: string;
      publishDate?: string;
      section?: string;
      text: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/getArticleFullText

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.getArticleFullText("<url>");
  • getElectionResultsGets one race's own results page.

    Arguments

    NameTypeRequired
    racestringYes

    Returns WashingtonpostElectionResult

    interface WashingtonpostElectionResult {
      race: string;
      url: string;
      headline: string;
      resultSummary?: string;
      description?: string;
      publishDate?: string;
      updatedAt?: string;
      otherRaces: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/getElectionResults

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.getElectionResults("alaska senate");
  • getLiveBlogGets a live-coverage page's own running updates (elections, speeches, breaking news), newest first.

    Arguments

    NameTypeRequired
    urlstringYes
    opts{ limit?: number }No

    Returns WashingtonpostLiveBlog

    interface WashingtonpostLiveUpdate {
      id: string;
      publishDate?: string;
      kind: string;
      headline?: string;
      text: string;
      authors: string[];
      imageUrl?: string;
    }
    
    interface WashingtonpostLiveBlog {
      headline: string;
      url: string;
      isLive: boolean;
      summary?: string;
      coverageStart?: string;
      coverageEnd?: string;
      lastUpdated?: string;
      authors: string[];
      updateCount: number;
      updates: WashingtonpostLiveUpdate[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/getLiveBlog

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.getLiveBlog("<url>");
  • getNewsletterGets one newsletter's own name, description and frequency off the directory.

    Arguments

    NameTypeRequired
    slugstringYes

    Returns WashingtonpostNewsletter

    interface WashingtonpostNewsletter {
      slug: string;
      name: string;
      description?: string;
      frequency?: string;
      imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/getNewsletter

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.getNewsletter("jobseeker-news");
  • getPodcastGets one podcast show's own details.

    Arguments

    NameTypeRequired
    slugstringYes

    Returns WashingtonpostPodcast

    interface WashingtonpostPodcast {
      slug: string;
      name: string;
      url: string;
      tagline?: string;
      description?: string;
      author?: string;
      feedUrl?: string;
      imageUrl?: string;
      applePodcastsUrl?: string;
      inactive: boolean;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.getPodcast("post-reports");
  • getTopicArticlesLists a topic page's own article grid, newest first.

    Arguments

    NameTypeRequired
    topicstringYes

    Returns WashingtonpostArticle[]

    interface WashingtonpostArticle {
      headline: string;
      byline?: string;
      url: string;
      publishDate?: string;
      section?: string;
      teaser?: string;
      imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/getTopicArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.getTopicArticles("sports");
  • getWriterGets a Washington Post writer's own byline page.

    Arguments

    NameTypeRequired
    writerstringYes

    Returns WashingtonpostWriter

    interface WashingtonpostWriter {
      slug: string;
      name: string;
      jobProfile?: string;
      bio?: string;
      longBio?: string;
      location?: string;
      imageUrl?: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.getWriter("philip-bump");
  • listArticlesLists a section front's own article grid, newest first, with headline, byline, teaser and publish date.

    Arguments

    NameTypeRequired
    sectionstringYes

    Returns WashingtonpostArticle[]

    interface WashingtonpostArticle {
      headline: string;
      byline?: string;
      url: string;
      publishDate?: string;
      section?: string;
      teaser?: string;
      imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/listArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.listArticles("politics");
  • listArticlesByWriterLists a writer's own articles, newest first.

    Arguments

    NameTypeRequired
    writerstringYes
    opts{ limit?: number; offset?: number }No

    Returns WashingtonpostArticle[]

    interface WashingtonpostArticle {
      headline: string;
      byline?: string;
      url: string;
      publishDate?: string;
      section?: string;
      teaser?: string;
      imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/listArticlesByWriter

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.listArticlesByWriter("philip-bump");
  • listEpisodesLists a podcast show's own episodes off its RSS feed, newest first.

    Arguments

    NameTypeRequired
    slugstringYes
    opts{ limit?: number }No

    Returns WashingtonpostPodcastEpisode[]

    interface WashingtonpostPodcastEpisode {
      title: string;
      url: string;
      publishDate?: string;
      show?: string;
      summary?: string;
      imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/listEpisodes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.listEpisodes("post-reports");
  • listHomepageLists the stories on the site's front page right now, each with the homepage module it sits in.

    Arguments

    None.

    Returns WashingtonpostArticle[]

    interface WashingtonpostArticle {
      headline: string;
      byline?: string;
      url: string;
      publishDate?: string;
      section?: string;
      teaser?: string;
      imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/listHomepage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.listHomepage();
  • listNewslettersLists the site's own newsletters off its newsletter directory (the /newsletters/ page's own client-side API).

    Arguments

    None.

    Returns WashingtonpostNewsletter[]

    interface WashingtonpostNewsletter {
      slug: string;
      name: string;
      description?: string;
      frequency?: string;
      imageUrl?: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.listNewsletters();
  • listPodcastsLists the site's own recent podcast episodes across every show.

    Arguments

    None.

    Returns WashingtonpostPodcastEpisode[]

    interface WashingtonpostPodcastEpisode {
      title: string;
      url: string;
      publishDate?: string;
      show?: string;
      summary?: string;
      imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/listPodcasts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.listPodcasts();
  • listSavedArticlesLists the signed-in reader's own saved articles off their Washington Post account.

    Arguments

    None.

    Returns WashingtonpostSavedArticle[]

    interface WashingtonpostSavedArticle {
      url: string;
      savedAt?: string;
      archived?: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/listSavedArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.listSavedArticles();
  • listSectionsLists the site's own news sections (Politics, World, Business, Sports, Opinions, etc.) off the header nav.

    Arguments

    None.

    Returns WashingtonpostSection[]

    interface WashingtonpostSection {
      slug: string;
      name: string;
      url: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.listSections();
  • listTopicsLists the site's own topic/beat pages off its published section-sitemap.

    Arguments

    None.

    Returns WashingtonpostTopic[]

    interface WashingtonpostTopic {
      slug: string;
      name: string;
      url: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.listTopics();
  • listTrendingLists the site's own most-read articles right now.

    Arguments

    None.

    Returns WashingtonpostArticle[]

    interface WashingtonpostArticle {
      headline: string;
      byline?: string;
      url: string;
      publishDate?: string;
      section?: string;
      teaser?: string;
      imageUrl?: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.listTrending();
  • listVideosLists the site's own newest videos off its video sitemap.

    Arguments

    NameTypeRequired
    opts{ limit?: number }No

    Returns WashingtonpostVideo[]

    interface WashingtonpostVideo {
      title: string;
      url: string;
      description?: string;
      publishDate?: string;
      durationSeconds?: number;
      section?: string;
      embedUrl?: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.listVideos();
  • searchWritersSearches Washington Post writers by name off the site's own author sitemap (the site publishes no writer search or directory).

    Arguments

    NameTypeRequired
    querystringYes

    Returns WashingtonpostWriterMatch[]

    interface WashingtonpostWriterMatch {
      slug: string;
      name: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/washingtonpost/searchWriters

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.searchWriters("balz");
Act 2
  • saveArticleSaves an article to the CALLER's own Washington Post saved-stories list.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns WashingtonpostSavedArticleResult

    interface WashingtonpostSavedArticleResult {
      url: string;
      saved: boolean;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.washingtonpost.saveArticle("<url>");
  • unsaveArticleRemoves an article from the CALLER's own Washington Post saved-stories list.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns WashingtonpostSavedArticleResult

    interface WashingtonpostSavedArticleResult {
      url: string;
      saved: boolean;
    }

    HTTP endpoint

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

    Call it

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

Use it from code