BBC MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on BBC: 31 typed functions through one MCP server. No BBC API key needed.
- Site
- bbc.com
- Functions
- 31
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for BBC 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/bbcOne MCP server for BBC 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.
getArticleOne BBC article as data: headline, byline, published and updated times, section, topic tags (ids listTopicStories takes), the body text as ordered…Arguments
Name Type Required articleIdOrUrlstringYes Returns
BbcGetArticleResultinterface BbcArticleBlock { type: string; // the site's own block type: "paragraph", "subheading", "video", … text?: string; imageUrl?: string; caption?: string; } interface BbcArticleTopic { id: string; title: string; } interface BbcRelatedLink { headline: string; url: string; } interface BbcGetArticleResult { articleId: string; headline: string; byline?: string; section?: string; published?: string; // ISO updated?: string; // ISO topics: BbcArticleTopic[]; body: BbcArticleBlock[]; // the article's body, in reading order relatedLinks: BbcRelatedLink[]; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getArticle("cqgmrr9ekr7ko");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getArticle("cqgmrr9ekr7ko"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/getArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"articleIdOrUrl":"cqgmrr9ekr7ko"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.getArticle("cqgmrr9ekr7ko");getCurrentWeatherThe latest observation BBC Weather shows for a location: temperature, wind, humidity, pressure, visibility and the observation time and station.Arguments
Name Type Required locationIdstringYes Returns
BbcGetCurrentWeatherResultinterface BbcGetCurrentWeatherResult { stationName: string; stationDistanceKm: number | null; observationTime: string; // ISO 8601, the station's own local offset temperatureC: number | null; temperatureF: number | null; weatherType: string | null; windSpeedKph: number | null; windDirection: string | null; // e.g. "Westerly"; null when the site has none humidityPercent: number | null; pressureMb: number | null; visibility: string | null; // e.g. "Good", "Poor"; the site's own text }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getCurrentWeatherCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getCurrentWeather("2643743");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getCurrentWeather("2643743"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/getCurrentWeather \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"locationId":"2643743"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.getCurrentWeather("2643743");getFixturesScores and fixtures for a sport or competition on a date: each match's teams, kick-off time, status (upcoming, live, finished, cancelled), score and…Arguments
Name Type Required args{ sport: string; competition?: string; date?: string }Yes Returns
BbcGetFixturesResultinterface BbcFixtureMatch { matchId?: string; // what getMatch takes, present only when BBC built a live-coverage page for this match competition: string; // the site's own tournament name, e.g. "Premier League", a label; pass competitionPath on competitionPath?: string; // e.g. "/sport/football/nations-league", what getFixtures' competition and getStandings take homeTeam: string; awayTeam: string; homeTeamPath?: string; // e.g. "/sport/football/teams/belgium", what getTeam takes awayTeamPath?: string; // e.g. "/sport/football/teams/france", what getTeam takes homeScore?: string; // absent before kickoff and on a cancelled match awayScore?: string; status: string; statusDetail: string; // the site's own short status word, e.g. "FT", "90'+2", "Scheduled", "Match Cancelled" kickOff: string; // ISO } interface BbcGetFixturesResult { sport: string; // the sport path this was fetched for, e.g. "/sport/football" competition?: string; // the competition path, when one was passed date?: string; // the single day filtered to, when `date` was passed alongside a competition matches: BbcFixtureMatch[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getFixturesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getFixtures({ sport: "/sport/football" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getFixtures({"sport": "/sport/football"}))curl -X POST https://api.bowmark.ai/v1/sites/bbc/getFixtures \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"sport":"/sport/football"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.getFixtures({ sport: "/sport/football" });getForecastThe BBC Weather forecast for a location: up to 14 days (high/low, weather type, chance of rain, wind, sunrise/sunset) plus the hour-by-hour detail…Arguments
Name Type Required locationIdstringYes Returns
BbcGetForecastResultinterface BbcForecastHourly { time: string; temperatureC: number; temperatureF: number; weatherType: string; chanceOfRain: number; windSpeedKph: number; humidity: number; } interface BbcForecastDay { date: string; highC: number; highF: number; lowC: number; lowF: number; weatherType: string; chanceOfRain: number; windSpeedKph: number; sunrise: string; sunset: string; hourly: BbcForecastHourly[]; // the site's own hour-by-hour detail for this day } interface BbcGetForecastResult { days: BbcForecastDay[]; // up to 14 days, the site's own order }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getForecastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getForecast("2643743");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getForecast("2643743"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/getForecast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"locationId":"2643743"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.getForecast("2643743");getLivePageA BBC live page (rolling coverage) as data: title, summary, whether it is still live, and its posts newest first.Arguments
Name Type Required liveIdOrUrlstringYes Returns
BbcGetLivePageResultinterface BbcLivePost { id: string; // the site's own asset urn, e.g. "asset:4978fe54-a49d-46c6-866b-7cd295400a4b" heading: string; text: string; author?: string; published?: string; // ISO updated?: string; // ISO } interface BbcGetLivePageResult { liveId: string; title: string; summaryPoints: string[]; // the site's own "key points" bullets; [] when none live: boolean; posts: BbcLivePost[]; // newest first, the site's own order url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getLivePageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getLivePage("cj4zwkp2p1kt");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getLivePage("cj4zwkp2p1kt"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/getLivePage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"liveIdOrUrl":"cj4zwkp2p1kt"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.getLivePage("cj4zwkp2p1kt");getMatchOne match as BBC Sport shows it: teams, score, status, venue, and.Arguments
Name Type Required matchIdstringYes Returns
BbcGetMatchResultinterface BbcMatchTeam { name: string; score?: string; // the site's own score as of this read, e.g. "1", absent before kickoff } interface BbcMatchTimelineEvent { minute: number; type: string; // "Goal" | "Penalty" | other site-defined action types, passed through verbatim team: string; player?: string; } interface BbcMatchPlayer { name: string; number: number; position: string; isSubstitute: boolean; } interface BbcMatchLineup { team: string; formation?: string; players: BbcMatchPlayer[]; } interface BbcGetMatchResult { matchId: string; homeTeam: BbcMatchTeam; awayTeam: BbcMatchTeam; kickOffTime: string; // ISO string status: string; statusDetail: string; // the site's own short status word, e.g. "FT", "90'+2", "Scheduled", "Match Cancelled" venue?: string; competition?: string; // the competition this match belongs to timeline?: BbcMatchTimelineEvent[]; // goal/penalty timeline built from the site's own per-team action lists, absent when none lineups?: BbcMatchLineup[]; // team lineups, absent when BBC does not cover this match that closely stats?: Record<string, unknown>; // the page's own match-stats module, { home: {...}, away: {...} }, absent when not covered }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getMatchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getMatch("<matchId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getMatch("<matchId>"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/getMatch \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"matchId":"<matchId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.getMatch("<matchId>");getPodcastOne BBC podcast or series: title, description, genres, episode count, and ten episodes a page newest first.Arguments
Name Type Required args{ podcastId: string; page?: number }Yes Returns
BbcGetPodcastResultinterface BbcPodcastEpisodeSummary { episodeId: string; title: string; summary: string; duration?: string; date?: string; image?: string; url: string; } interface BbcGetPodcastResult { podcastId: string; title: string; description: string; image?: string; genres: string[]; episodeCount: number; page: number; hasMore: boolean; url: string; episodes: BbcPodcastEpisodeSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getPodcastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getPodcast({ podcastId: "b015sqc7" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getPodcast({"podcastId": "b015sqc7"}))curl -X POST https://api.bowmark.ai/v1/sites/bbc/getPodcast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"podcastId":"b015sqc7"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.getPodcast({ podcastId: "b015sqc7" });getPodcastEpisodeOne podcast episode: title, synopsis, duration, broadcast date, and the playable media link where the page carries one.Arguments
Name Type Required args{ episodeId: string }Yes Returns
BbcGetPodcastEpisodeResultinterface BbcGetPodcastEpisodeResult { episodeId: string; title: string; synopsis: string; duration?: string; date?: string; image?: string; podcast?: { podcastId: string; title: string }; listenUrl?: string; requiresSubscription: boolean; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getPodcastEpisodeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getPodcastEpisode({ episodeId: "m0031t2m" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getPodcastEpisode({"episodeId": "m0031t2m"}))curl -X POST https://api.bowmark.ai/v1/sites/bbc/getPodcastEpisode \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"episodeId":"m0031t2m"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.getPodcastEpisode({ episodeId: "m0031t2m" });getStandingsA competition's league table: position, team, played, won, drawn, lost, goals/points for and against, goal difference and points.Arguments
Name Type Required competitionstringYes Returns
BbcGetStandingsResultinterface BbcStandingsRow { rank: number; team: string; teamPath: string; // site-relative, e.g. "/sport/football/teams/manchester-city", what getTeam takes played: number; won: number; drawn: number; lost: number; goalsFor: number; goalsAgainst: number; goalDifference: number; points: number; status?: string; // the site's own qualification/relegation label, e.g. "UEFA Champions League", "Relegation" } interface BbcGetStandingsResult { competition: string; // the competition path this was fetched for, e.g. "/sport/football/premier-league" tournamentName: string; // the site's own tournament name, e.g. "Premier League" standings: BbcStandingsRow[]; // ranked ascending, the site's own order }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getStandingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getStandings("/sport/football/premier-league");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getStandings("/sport/football/premier-league"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/getStandings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"competition":"/sport/football/premier-league"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.getStandings("/sport/football/premier-league");getTeamOne team's BBC Sport page: name, competition, its recent results and upcoming fixtures, and its latest stories.Arguments
Name Type Required teamSlugOrUrlstringYes Returns
BbcGetTeamResultinterface BbcTeamFixture { opponent: string; date: string; // ISO date-time string status: string; score?: string; // "<this team's score>-<opponent's score>" matchId?: string; // what getMatch takes, present only when BBC built a live-coverage page } interface BbcTeamStory { headline: string; url: string; date: string; // the site's own display timestamp, e.g. "12:46 BST", not an ISO date } interface BbcGetTeamResult { name: string; recentResults: BbcTeamFixture[]; // most recent first upcomingFixtures: BbcTeamFixture[]; // oldest first, matching the site's own order stories: BbcTeamStory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getTeamCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getTeam("manchester-united");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getTeam("manchester-united"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/getTeam \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"teamSlugOrUrl":"manchester-united"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.getTeam("manchester-united");getVideoOne BBC video page as data: title, summary, duration, published time, section, poster image and the related-story links.Arguments
Name Type Required videoIdOrUrlstringYes Returns
BbcGetVideoResultinterface BbcGetVideoResult { videoId: string; title: string; summary: string; duration?: number; // seconds, from the video's own primary version published?: string; // ISO section?: string; image?: string; url: string; relatedLinks: BbcRelatedLink[]; } interface BbcRelatedLink { headline: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getVideo("cmx236yd1nr6o");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getVideo("cmx236yd1nr6o"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/getVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"videoIdOrUrl":"cmx236yd1nr6o"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.getVideo("cmx236yd1nr6o");getWeatherWarningsUK weather or flood warnings currently in force, grouped by region and issuing agency (Met Office for weather; the Environment Agency, SEPA or…Arguments
Name Type Required type"weather" | "floods"No Returns
BbcGetWeatherWarningsResultinterface BbcWeatherWarningTime { visualTime: string; screenReaderTime: string; } interface BbcWeatherWarning { warningType: string; // the site's own hazard word, e.g. "flood" warningLevel: string; warningTitle: string; description: string; source: string; severity: string | null; // "red" | "amber" | "yellow", the site's own label severityLabel: string | null; // e.g. "Flooding possible - Be prepared" areasAffected: string | null; validFrom: BbcWeatherWarningTime | null; validTo: BbcWeatherWarningTime | null; issuedAt: BbcWeatherWarningTime | null; active: boolean; } interface BbcWeatherWarningGroup { region: string; // "uk" for weather; "england" | "scotland" | "wales" for floods agency: string | null; agencyUrl: string | null; warnings: BbcWeatherWarning[]; // [] is a real "nothing active" answer } interface BbcGetWeatherWarningsResult { warningType: "weather" | "floods"; groups: BbcWeatherWarningGroup[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/getWeatherWarningsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.getWeatherWarnings();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.getWeatherWarnings())curl -X POST https://api.bowmark.ai/v1/sites/bbc/getWeatherWarnings \ -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.bbc.getWeatherWarnings();listCompetitionsThe competitions BBC Sport covers for one sport (for football: Premier League, Championship, Champions League, …) with the key getFixtures and…Arguments
Name Type Required sportstringYes Returns
BbcListCompetitionsResultinterface BbcCompetition { name: string; path: string; // site-relative, e.g. "/sport/football/premier-league", what getFixtures and getStandings take url: string; category: string; // the site's own grouping, e.g. "UK & Ireland", "Europe", "International" } interface BbcListCompetitionsResult { sport: string; // the sport path this was fetched for, e.g. "/sport/football" competitions: BbcCompetition[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/listCompetitionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.listCompetitions("/sport/football");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.listCompetitions("/sport/football"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/listCompetitions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"sport":"/sport/football"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.listCompetitions("/sport/football");listFollowedPodcastsThe podcasts and series the signed-in reader follows.Arguments
Name Type Required args{ page?: number }No Returns
BbcListFollowedPodcastsResultinterface BbcFollowedPodcast { id: string; // the middleware's pips URN, what unfollowPodcast takes podcastId: string | null; // the bare podcast id getPodcast takes title: string; summary: string; url: string; image?: string; latestEpisode?: { id: string | null; title: string | null; url: string | null }; } interface BbcListFollowedPodcastsResult { podcasts: BbcFollowedPodcast[]; page: number; // 0-based, the site's own paging pageSize: number; total: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/listFollowedPodcastsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.listFollowedPodcasts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.listFollowedPodcasts())curl -X POST https://api.bowmark.ai/v1/sites/bbc/listFollowedPodcasts \ -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.bbc.listFollowedPodcasts();listHeadlinesThe stories a BBC section page shows right now, in the page's own order and grouping: headline, summary, url, article id, image, section label and…Arguments
Name Type Required args{ path?: string }No Returns
BbcListHeadlinesResultinterface BbcHeadline { headline: string; summary: string; url: string; articleId: string; image?: string; section: string; lastUpdated?: string; } interface BbcListHeadlinesResult { headlines: BbcHeadline[]; // stories in the section's own order }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/listHeadlinesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.listHeadlines();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.listHeadlines())curl -X POST https://api.bowmark.ai/v1/sites/bbc/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.bbc.listHeadlines();listMostReadThe "Most read" list the BBC shows on its news front page: rank, headline, summary, url, article id, image and last-updated time, in the site's own…Arguments
None.
Returns
BbcListMostReadResultinterface BbcMostReadEntry { rank: number; // 1-based, the site's own order headline: string; summary: string; url: string; articleId: string; image?: string; section: string; lastUpdated?: string; } interface BbcListMostReadResult { headlines: BbcMostReadEntry[]; // ranked, the site's own order }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/listMostReadCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.listMostRead();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.listMostRead())curl -X POST https://api.bowmark.ai/v1/sites/bbc/listMostRead \ -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.bbc.listMostRead();listNewslettersThe BBC newsletters a reader can sign up to: name, description, frequency and newsletter id.Arguments
None.
Returns
BbcListNewslettersResultinterface BbcNewsletter { newsletterId: string; name: string; description: string; frequency: string; newsletterType: string; thumbnailImageUrl?: string; } interface BbcListNewslettersResult { newsletters: BbcNewsletter[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/listNewslettersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.listNewsletters();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.listNewsletters())curl -X POST https://api.bowmark.ai/v1/sites/bbc/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.bbc.listNewsletters();listPodcastsThe podcasts and audio series featured on BBC Audio (/audio): title, description, image and podcast id.Arguments
None.
Returns
BbcListPodcastsResultinterface BbcPodcast { title: string; description: string; image?: string; url: string; podcastId: string; } interface BbcListPodcastsResult { podcasts: BbcPodcast[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/listPodcastsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.listPodcasts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.listPodcasts())curl -X POST https://api.bowmark.ai/v1/sites/bbc/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.bbc.listPodcasts();listSavedArticlesThe signed-in reader's saved articles: headline, url, article id and when saved.Arguments
Name Type Required args{ page?: number }No Returns
BbcListSavedArticlesResultinterface BbcSavedArticle { id: string; // the middleware's content URN, what removeSavedArticle takes articleId: string | null; // the bare article id getArticle takes, when it is an article headline: string; summary: string; url: string; type: string | null; subtype: string | null; image?: string; firstPublishedAt: string | null; lastPublishedAt: string | null; } interface BbcListSavedArticlesResult { articles: BbcSavedArticle[]; page: number; // 0-based, the site's own paging pageSize: number; total: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/listSavedArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.listSavedArticles();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.listSavedArticles())curl -X POST https://api.bowmark.ai/v1/sites/bbc/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.bbc.listSavedArticles();listSectionsThe BBC's own section list, read off the bbc.com top navigation.Arguments
Name Type Required args{ parent?: string }No Returns
BbcListSectionsResultinterface BbcSection { title: string; path: string; // site-relative, e.g. "/news/world/europe", what listHeadlines takes url: string; children: BbcSection[]; // sub-sections in the site's order; [] when none } interface BbcListSectionsResult { sections: BbcSection[]; // top-level sections, or the parent's sub-sections }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/listSectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.listSections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.listSections())curl -X POST https://api.bowmark.ai/v1/sites/bbc/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.bbc.listSections();listSportsThe sports BBC Sport covers (football, cricket, rugby union, tennis, formula 1, golf, …) with each one's path.Arguments
None.
Returns
BbcListSportsResultinterface BbcSport { title: string; path: string; // site-relative, e.g. "/sport/football", what listCompetitions takes url: string; } interface BbcListSportsResult { sports: BbcSport[]; // the sports BBC Sport covers, in the site's own order }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/listSportsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.listSports();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.listSports())curl -X POST https://api.bowmark.ai/v1/sites/bbc/listSports \ -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.bbc.listSports();listTopicStoriesThe stories on one BBC topic page (/news/topics/<id>).Arguments
Name Type Required args{ topicId: string; page?: number }Yes Returns
BbcListTopicStoriesResultinterface BbcHeadline { headline: string; summary: string; url: string; articleId: string; image?: string; section: string; lastUpdated?: string; } interface BbcListTopicStoriesResult { headlines: BbcHeadline[]; // the topic page's own order, newest first }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/listTopicStoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.listTopicStories({ topicId: "cx1m7zg0gzdt" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.listTopicStories({"topicId": "cx1m7zg0gzdt"}))curl -X POST https://api.bowmark.ai/v1/sites/bbc/listTopicStories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"topicId":"cx1m7zg0gzdt"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.listTopicStories({ topicId: "cx1m7zg0gzdt" });listVideosThe videos the BBC's video hub shows: title, summary, duration, url, video id, section and date.Arguments
None.
Returns
BbcListVideosResultinterface BbcVideo { title: string; summary: string; duration?: string; url: string; videoId: string; section: string; date?: string; image?: string; } interface BbcListVideosResult { videos: BbcVideo[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/listVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.listVideos();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.listVideos())curl -X POST https://api.bowmark.ai/v1/sites/bbc/listVideos \ -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.bbc.listVideos();searchArticlesSearch the BBC the way its search box does: headline, summary, url, article id, section and date for each result, with paging.Arguments
Name Type Required args{ query: string; page?: number }Yes Returns
BbcSearchArticlesResultinterface BbcSearchResultRow { headline: string; summary: string; url: string; articleId: string; image?: string; section: string; lastUpdated?: string; } interface BbcSearchArticlesResult { results: BbcSearchResultRow[]; total: number; // the site's own match count, not results.length page: number; // 1-based, matching the `page` argument pageSize: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/searchArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.searchArticles({ query: "news" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.searchArticles({"query": "news"}))curl -X POST https://api.bowmark.ai/v1/sites/bbc/searchArticles \ -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.bbc.searchArticles({ query: "news" });searchWeatherLocationsFind BBC Weather locations by place name or postcode: name, region, country and the location id every weather function takes.Arguments
Name Type Required querystringYes Returns
BbcSearchWeatherLocationsResultinterface BbcWeatherLocation { locationId: string; name: string; region?: string; country: string; } interface BbcSearchWeatherLocationsResult { locations: BbcWeatherLocation[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/searchWeatherLocationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.searchWeatherLocations("London");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.searchWeatherLocations("London"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/searchWeatherLocations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"London"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.searchWeatherLocations("London");
followPodcastFollow a BBC podcast or series for the signed-in reader.Arguments
Name Type Required podcastIdOrUrlstringYes Returns
BbcFollowStatusinterface BbcFollowStatus { id: string; following: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/followPodcastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.followPodcast("<podcastIdOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.followPodcast("<podcastIdOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/followPodcast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"podcastIdOrUrl":"<podcastIdOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.followPodcast("<podcastIdOrUrl>");removeSavedArticleRemove an article from the signed-in reader's saved list.Arguments
Name Type Required articleIdOrUrlstringYes Returns
BbcSavedArticleStatusinterface BbcSavedArticleStatus { id: string; saved: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/removeSavedArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.removeSavedArticle("<articleIdOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.removeSavedArticle("<articleIdOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/removeSavedArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"articleIdOrUrl":"<articleIdOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.removeSavedArticle("<articleIdOrUrl>");saveArticleSave a BBC article to the signed-in reader's saved list (the page's bookmark button).Arguments
Name Type Required articleIdOrUrlstringYes Returns
BbcSavedArticleStatusinterface BbcSavedArticleStatus { id: string; saved: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/saveArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.saveArticle("<articleIdOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.saveArticle("<articleIdOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/saveArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"articleIdOrUrl":"<articleIdOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.saveArticle("<articleIdOrUrl>");subscribeNewsletterSign the signed-in reader up to a BBC newsletter.Arguments
Name Type Required newsletterIdstringYes Returns
BbcNewsletterStatusinterface BbcNewsletterStatus { newsletterId: string; subscribed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/subscribeNewsletterCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.subscribeNewsletter("<newsletterId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.subscribeNewsletter("<newsletterId>"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/subscribeNewsletter \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"newsletterId":"<newsletterId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.subscribeNewsletter("<newsletterId>");unfollowPodcastStop following a BBC podcast or series for the signed-in reader.Arguments
Name Type Required podcastIdOrUrlstringYes Returns
BbcFollowStatusinterface BbcFollowStatus { id: string; following: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/unfollowPodcastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.unfollowPodcast("<podcastIdOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.unfollowPodcast("<podcastIdOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/unfollowPodcast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"podcastIdOrUrl":"<podcastIdOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.unfollowPodcast("<podcastIdOrUrl>");unsubscribeNewsletterTake the signed-in reader off a BBC newsletter.Arguments
Name Type Required newsletterIdstringYes Returns
BbcNewsletterStatusinterface BbcNewsletterStatus { newsletterId: string; subscribed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bbc/unsubscribeNewsletterCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bbc.unsubscribeNewsletter("<newsletterId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bbc.unsubscribeNewsletter("<newsletterId>"))curl -X POST https://api.bowmark.ai/v1/sites/bbc/unsubscribeNewsletter \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"newsletterId":"<newsletterId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bbc.unsubscribeNewsletter("<newsletterId>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/bbc/<function> - OpenAPI
/v1/sites/bbc/openapi.json