The Guardian MCP server for AI agents
Let Claude, ChatGPT or your own agent read The Guardian: 24 typed functions through one MCP server. No The Guardian API key needed.
- Site
- theguardian.com
- Functions
- 24
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for The Guardian 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/theguardian_comOne MCP server for The Guardian 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.
getArticleRead the full text of one article given its URL or ID.Arguments
Name Type Required articleUrlOrIdstringYes Returns
GuardianArticleinterface GuardianArticle { id: string; url: string; headline: string; standfirst: string | null; byline: string | null; published: string | null; section: string | null; tags: { id: string; title: string; type: string }[]; /** The article body, one entry per paragraph or subheading, tags stripped. */ paragraphs: string[]; body: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/getArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.getArticle("world/2026/sep/27/mass-shootings-south-africa-johannesburg-cape-town");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.getArticle("world/2026/sep/27/mass-shootings-south-africa-johannesburg-cape-town"))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/getArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"articleUrlOrId":"world/2026/sep/27/mass-shootings-south-africa-johannesburg-cape-town"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.getArticle("world/2026/sep/27/mass-shootings-south-africa-johannesburg-cape-town");getArticleCommentsReader comments on one Guardian article.Arguments
Name Type Required articleUrlOrIdstringA theguardian.com article URL or the id getArticle/listArticlesBySection returns.Yes limitnumberNo Returns
GuardianArticleCommentsResultinterface GuardianComment { id: number; /** HTML stripped. */ body: string; author: string; published: string; recommends: number; } interface GuardianArticleCommentsResult { /** The article path these comments belong to. */ articleId: string; commentCount: number; /** Whether the thread is closed to new comments, existing ones are still readable. */ closedForComments: boolean; comments: GuardianComment[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/getArticleCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.getArticleComments("commentisfree/2026/oct/23/tory-party-kemi-badenoch-quit-andrew-boff");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.getArticleComments("commentisfree/2026/oct/23/tory-party-kemi-badenoch-quit-andrew-boff"))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/getArticleComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"commentisfree/2026/oct/23/tory-party-kemi-badenoch-quit-andrew-boff"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.getArticleComments("commentisfree/2026/oct/23/tory-party-kemi-badenoch-quit-andrew-boff");getContributorArticlesList articles written by a specific journalist or contributor.Arguments
Name Type Required contributorstringThe profile slug from a byline or a theguardian.com/profile/<slug> URL, e.g. "marinahyde".Yes limitnumberNo Returns
GuardianListArticlesResultinterface GuardianArticleSummary { title: string; url: string; /** The path getArticle takes, e.g. "world/2026/sep/27/some-slug". */ id: string; summary: string | null; byline: string | null; published: string | null; } interface GuardianListArticlesResult { /** The feed's path, e.g. "world", "tone/minutebyminute", "profile/marinahyde", what listArticlesBySection takes. */ section: string; title: string | null; articles: GuardianArticleSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/getContributorArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.getContributorArticles("marinahyde");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.getContributorArticles("marinahyde"))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/getContributorArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"marinahyde"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.getContributorArticles("marinahyde");getCrosswordOne Guardian crossword puzzle's full grid and clues.Arguments
Name Type Required kindstringThe puzzle type, e.g. "quick", "cryptic", "mini", "quick-cryptic", "prize", "quiptic".No numbernumberA specific puzzle number.No Returns
GuardianCrosswordinterface GuardianCrosswordClue { id: string; number: number; clue: string; direction: "across" | "down"; length: number; /** Null when the puzzle has not been solved yet (future prize crosswords). */ solution: string | null; } interface GuardianCrossword { /** The path getCrossword took, e.g. "crosswords/quick/17618". */ id: string; number: number; name: string; date: string; kind: string; solutionAvailable: boolean; dimensions: { rows: number; cols: number }; entries: GuardianCrosswordClue[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/getCrosswordCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.getCrossword();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.getCrossword())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/getCrossword \ -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.theguardian_com.getCrossword();getFootballTableThe current league table for one football competition.Arguments
Name Type Required competitionstringA competition slug from the table's competition.url, e.g. "premierleague", "championsleague", "laligafootball".No Returns
GuardianGetFootballTableResultinterface GuardianFootballTableRow { rank: number; team: string; teamUrl: string; played: number; won: number; drawn: number; lost: number; goalsFor: number; goalsAgainst: number; goalDifference: number; points: number; } interface GuardianGetFootballTableResult { competition: string; competitionName: string; table: GuardianFootballTableRow[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/getFootballTableCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.getFootballTable();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.getFootballTable())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/getFootballTable \ -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.theguardian_com.getFootballTable();getLiveBlogRead a live blog covering a news event.Arguments
Name Type Required liveBlogUrlOrIdstringThe live blog article's URL or the path from listLiveBlogs, e.g. "world/live/2026/sep/27/breaking-news-updates".Yes Returns
GuardianLiveBloginterface GuardianLiveBlogBlock { /** The block's publication timestamp. */ blockFirstPublished: string | null; /** The block's last-updated timestamp. */ blockLastUpdated: string | null; /** Optional title for this update within the live blog. */ title: string | null; /** The update content, one entry per paragraph, tags stripped. */ paragraphs: string[]; body: string; /** Whether this block is pinned to the top. */ pinned: boolean; /** Whether this block marks a key event. */ keyEvent: boolean; } interface GuardianLiveBlog { id: string; url: string; headline: string; standfirst: string | null; byline: string | null; published: string | null; section: string | null; tags: { id: string; title: string; type: string }[]; /** Array of update blocks, newest first. */ blocks: GuardianLiveBlogBlock[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/getLiveBlogCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.getLiveBlog({ liveBlogUrlOrId: "<liveBlogUrlOrId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.getLiveBlog({"liveBlogUrlOrId": "<liveBlogUrlOrId>"}))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/getLiveBlog \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"liveBlogUrlOrId":"<liveBlogUrlOrId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.getLiveBlog({ liveBlogUrlOrId: "<liveBlogUrlOrId>" });getMostReadThe Guardian's current site-wide most-read list.Arguments
None.
Returns
GuardianMostReadResultinterface GuardianArticleSummary { title: string; url: string; /** The path getArticle takes, e.g. "world/2026/sep/27/some-slug". */ id: string; summary: string | null; byline: string | null; published: string | null; } interface GuardianMostReadResult { mostRead: GuardianArticleSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/getMostReadCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.getMostRead();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.getMostRead())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/getMostRead \ -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.theguardian_com.getMostRead();getPhotoGalleryView images in a photo gallery with captions.Arguments
Name Type Required galleryUrlOrIdstringA theguardian.com gallery URL or the path listPhotos returns as id, e.g. "artanddesign/gallery/2026/oct/02/the-week-around-the-world-in-20-pictures".Yes Returns
GuardianPhotoGalleryinterface GuardianGalleryImage { /** The full-resolution original rendition's URL. */ url: string; alt: string | null; /** The caption, tags stripped. */ caption: string | null; credit: string | null; } interface GuardianPhotoGallery { id: string; url: string; headline: string; standfirst: string | null; byline: string | null; published: string | null; section: string | null; tags: { id: string; title: string; type: string }[]; images: GuardianGalleryImage[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/getPhotoGalleryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.getPhotoGallery("artanddesign/gallery/2026/oct/02/the-week-around-the-world-in-20-pictures");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.getPhotoGallery("artanddesign/gallery/2026/oct/02/the-week-around-the-world-in-20-pictures"))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/getPhotoGallery \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"artanddesign/gallery/2026/oct/02/the-week-around-the-world-in-20-pictures"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.getPhotoGallery("artanddesign/gallery/2026/oct/02/the-week-around-the-world-in-20-pictures");getReviewRead a full review given its URL or ID.Arguments
Name Type Required reviewUrlOrIdstringThe review article's URL or the path from listReviews, e.g. "books/2026/sep/30/...".Yes Returns
GuardianArticleinterface GuardianArticle { id: string; url: string; headline: string; standfirst: string | null; byline: string | null; published: string | null; section: string | null; tags: { id: string; title: string; type: string }[]; /** The article body, one entry per paragraph or subheading, tags stripped. */ paragraphs: string[]; body: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/getReviewCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.getReview("books/2026/oct/01/the-mercy-step-by-marcia-hutchinson-audiobook-review-a-caribbean-childs-eye-view-of-60s-bradford");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.getReview("books/2026/oct/01/the-mercy-step-by-marcia-hutchinson-audiobook-review-a-caribbean-childs-eye-view-of-60s-bradford"))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/getReview \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"books/2026/oct/01/the-mercy-step-by-marcia-hutchinson-audiobook-review-a-caribbean-childs-eye-view-of-60s-bradford"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.getReview("books/2026/oct/01/the-mercy-step-by-marcia-hutchinson-audiobook-review-a-caribbean-childs-eye-view-of-60s-bradford");getTopicArticlesGet articles tagged with a specific topic or collection.Arguments
Name Type Required sectionstringA section or tag path from listSections, e.g. "world", "sport", "environment/climate-crisis".No limitnumberNo Returns
GuardianListArticlesResultinterface GuardianArticleSummary { title: string; url: string; /** The path getArticle takes, e.g. "world/2026/sep/27/some-slug". */ id: string; summary: string | null; byline: string | null; published: string | null; } interface GuardianListArticlesResult { /** The feed's path, e.g. "world", "tone/minutebyminute", "profile/marinahyde", what listArticlesBySection takes. */ section: string; title: string | null; articles: GuardianArticleSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/getTopicArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.getTopicArticles("environment/climate-crisis");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.getTopicArticles("environment/climate-crisis"))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/getTopicArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":"environment/climate-crisis"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.getTopicArticles("environment/climate-crisis");getVideoWatch a video and read its description.Arguments
Name Type Required videoUrlOrIdstringYes Returns
GuardianVideointerface GuardianVideo { id: string; url: string; headline: string; standfirst: string | null; byline: string | null; published: string | null; section: string | null; tags: { id: string; title: string; type: string }[]; duration: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/getVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.getVideo("<videoUrlOrId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.getVideo("<videoUrlOrId>"))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/getVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"videoUrlOrId":"<videoUrlOrId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.getVideo("<videoUrlOrId>");listArticlesBySectionList recent articles from a section (world, politics, culture, sport, business, environment, lifeandstyle, fashion, arts, technology, education…Arguments
Name Type Required sectionstringA section or tag path from listSections, e.g. "world", "sport", "environment/climate-crisis".No limitnumberNo Returns
GuardianListArticlesResultinterface GuardianArticleSummary { title: string; url: string; /** The path getArticle takes, e.g. "world/2026/sep/27/some-slug". */ id: string; summary: string | null; byline: string | null; published: string | null; } interface GuardianListArticlesResult { /** The feed's path, e.g. "world", "tone/minutebyminute", "profile/marinahyde", what listArticlesBySection takes. */ section: string; title: string | null; articles: GuardianArticleSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listArticlesBySectionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listArticlesBySection({ section: "world" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listArticlesBySection({"section": "world"}))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/listArticlesBySection \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"section":"world"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.listArticlesBySection({ section: "world" });listBreakingNewsGet the latest breaking news stories.Arguments
None.
Returns
GuardianListArticlesResultinterface GuardianArticleSummary { title: string; url: string; /** The path getArticle takes, e.g. "world/2026/sep/27/some-slug". */ id: string; summary: string | null; byline: string | null; published: string | null; } interface GuardianListArticlesResult { /** The feed's path, e.g. "world", "tone/minutebyminute", "profile/marinahyde", what listArticlesBySection takes. */ section: string; title: string | null; articles: GuardianArticleSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listBreakingNewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listBreakingNews();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listBreakingNews())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/listBreakingNews \ -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.theguardian_com.listBreakingNews();listContributorsLists journalists and contributors whose surname starts with one letter, with each one's profile slug.Arguments
Name Type Required letterstringA single letter (a-z): contributors whose surname starts with it.Yes limitnumberNo Returns
GuardianListContributorsResultinterface GuardianContributor { name: string; slug: string; url: string; } interface GuardianListContributorsResult { letter: string; contributors: GuardianContributor[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listContributorsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listContributors({ letter: "h" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listContributors({"letter": "h"}))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/listContributors \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"letter":"h"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.listContributors({ letter: "h" });listFootballMatchesUpcoming fixtures or played results for one football competition (or every competition at once).Arguments
Name Type Required competitionstringA competition slug from getFootballTable's competition, e.g. "premierleague".No kind"fixtures" | "results""fixtures" (upcoming) or "results" (played).No Returns
GuardianListFootballMatchesResultinterface GuardianFootballMatch { id: string; date: string; competition: string; competitionName: string; homeTeam: string; homeTeamUrl: string; homeScore: number | null; awayTeam: string; awayTeamUrl: string; awayScore: number | null; venue: string | null; played: boolean; } interface GuardianListFootballMatchesResult { competition: string | null; kind: "fixtures" | "results"; matches: GuardianFootballMatch[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listFootballMatchesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listFootballMatches({ kind: "results" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listFootballMatches({"kind": "results"}))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/listFootballMatches \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"kind":"results"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.listFootballMatches({ kind: "results" });listLiveBlogsList live blogs covering breaking news and events.Arguments
Name Type Required limitnumberNo Returns
GuardianListArticlesResultinterface GuardianArticleSummary { title: string; url: string; /** The path getArticle takes, e.g. "world/2026/sep/27/some-slug". */ id: string; summary: string | null; byline: string | null; published: string | null; } interface GuardianListArticlesResult { /** The feed's path, e.g. "world", "tone/minutebyminute", "profile/marinahyde", what listArticlesBySection takes. */ section: string; title: string | null; articles: GuardianArticleSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listLiveBlogsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listLiveBlogs();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listLiveBlogs())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/listLiveBlogs \ -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.theguardian_com.listLiveBlogs();listNewslettersEvery email newsletter The Guardian publishes.Arguments
None.
Returns
GuardianListNewslettersResultinterface GuardianNewsletter { /** The newsletter's own slug, e.g. "first-edition" or "bookmarks". */ id: string; name: string; description: string; frequency: string; theme: string; /** The grouping The Guardian lists it under, e.g. "News in depth", "Culture". */ group: string; /** The edition it targets, e.g. "UK", "US", "AU", when the site declares one. */ regionFocus: string | null; /** A page showing a recent issue, when the site publishes one. */ exampleUrl: string | null; } interface GuardianListNewslettersResult { newsletters: GuardianNewsletter[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listNewslettersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listNewsletters();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listNewsletters())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/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.theguardian_com.listNewsletters();listOpinionPiecesGet opinion and comment articles from The Guardian.Arguments
Name Type Required limitnumberNo Returns
GuardianListArticlesResultinterface GuardianArticleSummary { title: string; url: string; /** The path getArticle takes, e.g. "world/2026/sep/27/some-slug". */ id: string; summary: string | null; byline: string | null; published: string | null; } interface GuardianListArticlesResult { /** The feed's path, e.g. "world", "tone/minutebyminute", "profile/marinahyde", what listArticlesBySection takes. */ section: string; title: string | null; articles: GuardianArticleSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listOpinionPiecesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listOpinionPieces();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listOpinionPieces())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/listOpinionPieces \ -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.theguardian_com.listOpinionPieces();listPhotosList photo galleries by date and topic.Arguments
Name Type Required limitnumberNo Returns
GuardianListPhotosResultinterface GuardianPhotoGallerySummary { title: string; url: string; /** The path getPhotoGallery takes, e.g. "artanddesign/gallery/2026/oct/02/the-week-around-the-world-in-20-pictures". */ id: string; summary: string | null; byline: string | null; published: string | null; } interface GuardianListPhotosResult { galleries: GuardianPhotoGallerySummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listPhotosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listPhotos();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listPhotos())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/listPhotos \ -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.theguardian_com.listPhotos();listPodcastEpisodesEpisodes of one Guardian podcast, newest first.Arguments
Name Type Required seriesstringA podcast series path or URL, e.g. "news/series/todayinfocus" (default), "politics/series/politicsweekly", "football/series/footballweekly", "science/series/science", "news/series/the-audio-long-read".No limitnumberNo Returns
GuardianListPodcastEpisodesResultinterface GuardianPodcastEpisode { /** The feed's own guid for the episode. */ id: string | null; title: string; /** HTML stripped. */ summary: string | null; /** RFC 822 date, verbatim from the feed. */ published: string | null; /** Direct audio file URL. */ audioUrl: string | null; /** "HH:MM:SS", verbatim from itunes:duration. */ duration: string | null; image: string | null; } interface GuardianListPodcastEpisodesResult { series: string; title: string | null; description: string | null; episodes: GuardianPodcastEpisode[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listPodcastEpisodesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listPodcastEpisodes();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listPodcastEpisodes())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/listPodcastEpisodes \ -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.theguardian_com.listPodcastEpisodes();listReviewsGet reviews of film, TV, theatre, books, etc.Arguments
Name Type Required categorystringA category path for reviews: "books", "film", "music", "stage", "art", or similar.No limitnumberNo Returns
GuardianListArticlesResultinterface GuardianArticleSummary { title: string; url: string; /** The path getArticle takes, e.g. "world/2026/sep/27/some-slug". */ id: string; summary: string | null; byline: string | null; published: string | null; } interface GuardianListArticlesResult { /** The feed's path, e.g. "world", "tone/minutebyminute", "profile/marinahyde", what listArticlesBySection takes. */ section: string; title: string | null; articles: GuardianArticleSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listReviews({ category: "books" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listReviews({"category": "books"}))curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/listReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"category":"books"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.theguardian_com.listReviews({ category: "books" });listSectionsList all available sections on the site.Arguments
None.
Returns
GuardianListSectionsResultinterface GuardianSection { title: string; /** The path listArticlesBySection takes, e.g. "world" or "environment/climate-crisis". */ path: string; url: string; children: GuardianSection[]; } interface GuardianListSectionsResult { sections: GuardianSection[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listSectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listSections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listSections())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/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.theguardian_com.listSections();listTopicsList trending topics and tagged collections (climate crisis, Ukraine, US elections, etc).Arguments
None.
Returns
GuardianListTopicsResultinterface GuardianTopic { /** The path getTopicArticles takes, e.g. "environment/climate-crisis". */ path: string; title: string; url: string; } interface GuardianListTopicsResult { topics: GuardianTopic[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listTopicsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listTopics();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listTopics())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/listTopics \ -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.theguardian_com.listTopics();listVideosList videos by topic and date.Arguments
Name Type Required categorystringA section to scope the videos to, e.g. "sport" or "football".No limitnumberNo Returns
GuardianListVideosResultinterface GuardianVideoSummary { title: string; url: string; /** The path getVideo takes, e.g. "world/video/2026/oct/03/video-slug". */ id: string; summary: string | null; byline: string | null; published: string | null; duration: number | null; } interface GuardianListVideosResult { category: string; title: string | null; videos: GuardianVideoSummary[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/theguardian_com/listVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.theguardian_com.listVideos();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.theguardian_com.listVideos())curl -X POST https://api.bowmark.ai/v1/sites/theguardian_com/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.theguardian_com.listVideos();
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/theguardian_com/<function> - OpenAPI
/v1/sites/theguardian_com/openapi.json