NPR MCP server for AI agents

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

Functions
19
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just NPR

An MCP server for NPR 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/npr
Every site

One MCP server for NPR 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

Open a function to see its arguments, what it returns and how to call it.

Read 19
  • findStationsFind NPR member stations by city, zip code, call letters or coordinates.

    Arguments

    NameTypeRequired
    querystringNo
    latnumberNo
    lonnumberNo

    Returns NprStation[]

    interface NprLiveStream {
      title: string | null;
      url: string;
      contentType: string | null;
      primary: boolean;
      musicOnly: boolean;
      description: string | null;
    }
    
    interface NprStation {
      orgId: string;
      call: string | null;
      name: string | null;
      band: string | null;
      frequency: string | null;
      marketCity: string | null;
      marketState: string | null;
      tagline: string | null;
      homepage: string | null;
      logo: string | null;
      streams: NprLiveStream[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/findStations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.findStations({ query: "60601" });
  • getAuthorStoriesList one NPR correspondent's or host's latest stories, with their name, bio and headshot, given their byline page URL or id.

    Arguments

    NameTypeRequired
    authorstringYes
    beforestring
    "YYYY-MM-DD": stories on or before this day.
    No

    Returns NprAuthorStories

    interface NprAuthorStories {
      author: string;
      name: string | null;
      bio: string | null;
      imageUrl: string | null;
      url: string;
      stories: NprSeriesStory[];
      nextBefore: string | null;
    }
    
    interface NprSeriesStory {
      title: string;
      url: string;
      storyId: string | null;
      publishedDate: string | null;
      teaser: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/getAuthorStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.getAuthorStories({ author: "127410674/carrie-johnson" });
  • getLiveStreamGet the live audio stream URL(s) for a member station, given its call letters or org id.

    Arguments

    NameTypeRequired
    stationstringYes

    Returns NprStationStreams

    interface NprLiveStream {
      title: string | null;
      url: string;
      contentType: string | null;
      primary: boolean;
      musicOnly: boolean;
      description: string | null;
    }
    
    interface NprStation {
      orgId: string;
      call: string | null;
      name: string | null;
      band: string | null;
      frequency: string | null;
      marketCity: string | null;
      marketState: string | null;
      tagline: string | null;
      homepage: string | null;
      logo: string | null;
      streams: NprLiveStream[];
    }
    
    interface NprStationStreams {
      station: NprStation;
      streams: NprLiveStream[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/getLiveStream

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.getLiveStream({ station: "WBEZ" });
  • getPodcastRead one podcast or show's details.

    Arguments

    NameTypeRequired
    podcastIdstringYes

    Returns NprPodcastDetails

    interface NprPodcastDetails {
      id: string;
      title: string | null;
      url: string | null;
      description: string | null;
      author: string | null;
      categories: string[];
      imageUrl: string | null;
      feedUrl: string;
      type: string | null;
      lastUpdated: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.getPodcast({ podcastId: "510318" });
  • getProgramRundownList the segments one broadcast program (Morning Edition, All Things Considered, Weekend Edition…) aired on a given date, defaulting to the latest…

    Arguments

    NameTypeRequired
    programstringYes
    datestringNo

    Returns NprProgramRundown

    interface NprRundownSegment {
      title: string;
      url: string;
      id: string | null;
      audioUrl: string | null;
      durationSeconds: number | null;
      slug: string | null;
      affiliation: string | null;
    }
    
    interface NprProgramRundown {
      program: string;
      date: string;
      episodeId: string | null;
      title: string | null;
      url: string | null;
      segments: NprRundownSegment[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/getProgramRundown

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.getProgramRundown({ program: "morning-edition" });
  • getStationRead one member station's details.

    Arguments

    NameTypeRequired
    stationstringYes

    Returns NprStation

    interface NprLiveStream {
      title: string | null;
      url: string;
      contentType: string | null;
      primary: boolean;
      musicOnly: boolean;
      description: string | null;
    }
    
    interface NprStation {
      orgId: string;
      call: string | null;
      name: string | null;
      band: string | null;
      frequency: string | null;
      marketCity: string | null;
      marketState: string | null;
      tagline: string | null;
      homepage: string | null;
      logo: string | null;
      streams: NprLiveStream[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/getStation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.getStation({ station: "309" });
  • getStoryA complete NPR story, headline, publication date, author, bylines (each with the id getAuthorStories takes), body text and (when available) a link to…

    Arguments

    NameTypeRequired
    urlstringYes

    Returns NprStory

    interface NprStory {
      title: string;
      url: string;
      description?: string;
      publishedDate?: string;
      author?: string;
      body?: string;
      audioUrl?: string;
      bylines?: NprByline[];
    }
    
    interface NprByline {
      name: string;
      id?: string;
      url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/getStory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.getStory({ url: "<url>" });
  • getTranscriptRead the broadcast transcript of a story or episode that aired, given its story id.

    Arguments

    NameTypeRequired
    idstringYes

    Returns NprTranscript

    interface NprTranscriptParagraph {
      speaker: string | null;
      text: string;
    }
    
    interface NprTranscript {
      id: string;
      title: string | null;
      url: string | null;
      publishedDate: string | null;
      available: boolean;
      paragraphs: NprTranscriptParagraph[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/getTranscript

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.getTranscript({ id: "nx-s1-5936538" });
  • listCategoryPodcastsList every podcast in one directory category (technology, comedy, news…), given its id from listPodcastCategories.

    Arguments

    NameTypeRequired
    categoryIdstring
    A category id off listPodcastCategories(), e.g. "2061".
    Yes

    Returns NprCategoryPodcast[]

    interface NprCategoryPodcast {
      id: string;
      title: string;
      url: string;
      org: string | null;
      image: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/listCategoryPodcasts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.listCategoryPodcasts({ categoryId: "2061" });
  • listHeadlinesList the homepage's current top stories.

    Arguments

    NameTypeRequired
    limitnumberNo

    Returns NprHeadline[]

    interface NprHeadline {
      id: string | null;
      url: string;
      title: string;
      teaser?: string;
      section?: string;
      sectionUrl?: string;
      publishedDate?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/listHeadlines

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.listHeadlines();
  • listNewslettersList NPR's email newsletters with what each one covers.

    Arguments

    None.

    Returns NprNewsletter[]

    interface NprNewsletter {
      id: string;
      title: string;
      frequency: string | null;
      description: string | null;
      previewUrl: string | null;
      featured: boolean;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.listNewsletters();
  • listPodcastCategoriesList the podcast directory's categories with the id each one takes.

    Arguments

    None.

    Returns NprPodcastCategory[]

    interface NprPodcastCategory {
      id: string;
      slug: string;
      title: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/listPodcastCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.listPodcastCategories();
  • listPodcastEpisodesList a podcast's episodes, newest first, with title, date, duration and audio URL, given its id from listPodcasts.

    Arguments

    NameTypeRequired
    podcastIdstringYes
    limitnumberNo

    Returns NprPodcastEpisode[]

    interface NprPodcastEpisode {
      id: string | null;
      title: string | null;
      url: string | null;
      publishedDate: string | null;
      summary: string | null;
      audioUrl: string | null;
      durationSeconds: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/listPodcastEpisodes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.listPodcastEpisodes({ podcastId: "510318" });
  • listPodcastsList NPR's podcasts and shows, optionally filtered to one category (news, technology, comedy…).

    Arguments

    None.

    Returns NprPodcast[]

    interface NprPodcast {
      id: string;
      title: string;
      url: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.listPodcasts();
  • listSectionsList NPR's news sections and topics (news, politics, business, science, health, culture, music…) with the slug each one takes.

    Arguments

    None.

    Returns NprSection[]

    interface NprSection {
      slug: string;
      title: string;
      url: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.listSections();
  • listSectionStoriesList the latest stories in one section or topic, given its slug from listSections.

    Arguments

    NameTypeRequired
    slugstringYes
    limitnumberNo

    Returns NprHeadline[]

    interface NprHeadline {
      id: string | null;
      url: string;
      title: string;
      teaser?: string;
      section?: string;
      sectionUrl?: string;
      publishedDate?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/listSectionStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.listSectionStories({ slug: "news" });
  • listSeriesList NPR's series (Tiny Desk Concerts, New Music Friday, Life Kit…) with the slug or id each one takes.

    Arguments

    None.

    Returns NprSeries[]

    interface NprSeries {
      id: string;
      title: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/listSeries

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.listSeries();
  • listSeriesStoriesList the latest entries of one series, e.g. Tiny Desk Concerts, given its slug from listSeries.

    Arguments

    NameTypeRequired
    seriesstringYes
    beforestring
    "YYYY-MM-DD": entries on or before this day.
    No

    Returns NprSeriesStories

    interface NprSeriesStory {
      title: string;
      url: string;
      storyId: string | null;
      publishedDate: string | null;
      teaser: string | null;
    }
    
    interface NprSeriesStories {
      series: string;
      title: string | null;
      url: string;
      stories: NprSeriesStory[];
      nextBefore: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/listSeriesStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.listSeriesStories({ series: "tiny-desk-concerts" });
  • searchStoriesSearch NPR stories, episodes and segments by keyword, newest or most relevant first.

    Arguments

    NameTypeRequired
    querystringYes
    limitnumberNo

    Returns NprSearchResult[]

    interface NprSearchResult {
      url: string;
      title: string;
      id?: string;
      publishedDate?: string;
      publishedAt?: string;
      bylines?: string[];
      teaser?: string;
      show?: string;
      topics?: string[];
      hasAudio: boolean;
      audioDurationSeconds?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/npr/searchStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.npr.searchStories({ query: "news" });

Use it from code