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.
- Site
- npr.org
- Functions
- 19
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/nprOne MCP server for NPR 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
Open a function to see its arguments, what it returns and how to call it.
findStationsFind NPR member stations by city, zip code, call letters or coordinates.Arguments
Name Type Required 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/findStationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.findStations({ query: "60601" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.findStations({"query": "60601"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/findStations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"60601"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required authorstringYes beforestring"YYYY-MM-DD": stories on or before this day.No Returns
NprAuthorStoriesinterface 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/getAuthorStoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.getAuthorStories({ author: "127410674/carrie-johnson" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.getAuthorStories({"author": "127410674/carrie-johnson"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/getAuthorStories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"author":"127410674/carrie-johnson"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required stationstringYes Returns
NprStationStreamsinterface 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/getLiveStreamCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.getLiveStream({ station: "WBEZ" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.getLiveStream({"station": "WBEZ"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/getLiveStream \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"station":"WBEZ"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.npr.getLiveStream({ station: "WBEZ" });getPodcastRead one podcast or show's details.Arguments
Name Type Required podcastIdstringYes Returns
NprPodcastDetailsinterface 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/getPodcastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.getPodcast({ podcastId: "510318" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.getPodcast({"podcastId": "510318"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/getPodcast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"podcastId":"510318"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required programstringYes datestringNo Returns
NprProgramRundowninterface 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/getProgramRundownCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.getProgramRundown({ program: "morning-edition" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.getProgramRundown({"program": "morning-edition"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/getProgramRundown \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"program":"morning-edition"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.npr.getProgramRundown({ program: "morning-edition" });getStationRead one member station's details.Arguments
Name Type Required stationstringYes Returns
NprStationinterface 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/getStationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.getStation({ station: "309" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.getStation({"station": "309"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/getStation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"station":"309"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required urlstringYes Returns
NprStoryinterface 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/getStoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.getStory({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.getStory({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/getStory \ -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.npr.getStory({ url: "<url>" });getTranscriptRead the broadcast transcript of a story or episode that aired, given its story id.Arguments
Name Type Required idstringYes Returns
NprTranscriptinterface 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/getTranscriptCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.getTranscript({ id: "nx-s1-5936538" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.getTranscript({"id": "nx-s1-5936538"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/getTranscript \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"nx-s1-5936538"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required categoryIdstringA 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/listCategoryPodcastsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.listCategoryPodcasts({ categoryId: "2061" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.listCategoryPodcasts({"categoryId": "2061"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/listCategoryPodcasts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"categoryId":"2061"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.npr.listCategoryPodcasts({ categoryId: "2061" });listHeadlinesList the homepage's current top stories.Arguments
Name Type Required 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/listHeadlinesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.listHeadlines();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.listHeadlines())curl -X POST https://api.bowmark.ai/v1/sites/npr/listHeadlines \ -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.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/listNewslettersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.listNewsletters();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.listNewsletters())curl -X POST https://api.bowmark.ai/v1/sites/npr/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.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/listPodcastCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.listPodcastCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.listPodcastCategories())curl -X POST https://api.bowmark.ai/v1/sites/npr/listPodcastCategories \ -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.npr.listPodcastCategories();listPodcastEpisodesList a podcast's episodes, newest first, with title, date, duration and audio URL, given its id from listPodcasts.Arguments
Name Type Required 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/listPodcastEpisodesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.listPodcastEpisodes({ podcastId: "510318" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.listPodcastEpisodes({"podcastId": "510318"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/listPodcastEpisodes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"podcastId":"510318"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listPodcastsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.listPodcasts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.listPodcasts())curl -X POST https://api.bowmark.ai/v1/sites/npr/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.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/listSectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.listSections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.listSections())curl -X POST https://api.bowmark.ai/v1/sites/npr/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.npr.listSections();listSectionStoriesList the latest stories in one section or topic, given its slug from listSections.Arguments
Name Type Required 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/listSectionStoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.listSectionStories({ slug: "news" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.listSectionStories({"slug": "news"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/listSectionStories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"news"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listSeriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.listSeries();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.listSeries())curl -X POST https://api.bowmark.ai/v1/sites/npr/listSeries \ -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.npr.listSeries();listSeriesStoriesList the latest entries of one series, e.g. Tiny Desk Concerts, given its slug from listSeries.Arguments
Name Type Required seriesstringYes beforestring"YYYY-MM-DD": entries on or before this day.No Returns
NprSeriesStoriesinterface 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/listSeriesStoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.listSeriesStories({ series: "tiny-desk-concerts" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.listSeriesStories({"series": "tiny-desk-concerts"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/listSeriesStories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"series":"tiny-desk-concerts"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.npr.listSeriesStories({ series: "tiny-desk-concerts" });searchStoriesSearch NPR stories, episodes and segments by keyword, newest or most relevant first.Arguments
Name Type Required 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/searchStoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.npr.searchStories({ query: "news" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.npr.searchStories({"query": "news"}))curl -X POST https://api.bowmark.ai/v1/sites/npr/searchStories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"news"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.npr.searchStories({ query: "news" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/npr/<function> - OpenAPI
/v1/sites/npr/openapi.json