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.

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

Connect

Just The Guardian

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_com
Every site

One 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/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 24
  • getArticleRead the full text of one article given its URL or ID.

    Arguments

    NameTypeRequired
    articleUrlOrIdstringYes

    Returns GuardianArticle

    interface 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/getArticle

    Call 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");
  • getArticleCommentsReader comments on one Guardian article.

    Arguments

    NameTypeRequired
    articleUrlOrIdstring
    A theguardian.com article URL or the id getArticle/listArticlesBySection returns.
    Yes
    limitnumberNo

    Returns GuardianArticleCommentsResult

    interface 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/getArticleComments

    Call 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");
  • getContributorArticlesList articles written by a specific journalist or contributor.

    Arguments

    NameTypeRequired
    contributorstring
    The profile slug from a byline or a theguardian.com/profile/<slug> URL, e.g. "marinahyde".
    Yes
    limitnumberNo

    Returns GuardianListArticlesResult

    interface 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/getContributorArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.getContributorArticles("marinahyde");
  • getCrosswordOne Guardian crossword puzzle's full grid and clues.

    Arguments

    NameTypeRequired
    kindstring
    The puzzle type, e.g. "quick", "cryptic", "mini", "quick-cryptic", "prize", "quiptic".
    No
    numbernumber
    A specific puzzle number.
    No

    Returns GuardianCrossword

    interface 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/getCrossword

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.getCrossword();
  • getFootballTableThe current league table for one football competition.

    Arguments

    NameTypeRequired
    competitionstring
    A competition slug from the table's competition.url, e.g. "premierleague", "championsleague", "laligafootball".
    No

    Returns GuardianGetFootballTableResult

    interface 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/getFootballTable

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.getFootballTable();
  • getLiveBlogRead a live blog covering a news event.

    Arguments

    NameTypeRequired
    liveBlogUrlOrIdstring
    The live blog article's URL or the path from listLiveBlogs, e.g. "world/live/2026/sep/27/breaking-news-updates".
    Yes

    Returns GuardianLiveBlog

    interface 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/getLiveBlog

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.getLiveBlog({ liveBlogUrlOrId: "<liveBlogUrlOrId>" });
  • getMostReadThe Guardian's current site-wide most-read list.

    Arguments

    None.

    Returns GuardianMostReadResult

    interface 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/getMostRead

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.getMostRead();
  • getPhotoGalleryView images in a photo gallery with captions.

    Arguments

    NameTypeRequired
    galleryUrlOrIdstring
    A 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 GuardianPhotoGallery

    interface 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/getPhotoGallery

    Call 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");
  • getReviewRead a full review given its URL or ID.

    Arguments

    NameTypeRequired
    reviewUrlOrIdstring
    The review article's URL or the path from listReviews, e.g. "books/2026/sep/30/...".
    Yes

    Returns GuardianArticle

    interface 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/getReview

    Call 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");
  • getTopicArticlesGet articles tagged with a specific topic or collection.

    Arguments

    NameTypeRequired
    sectionstring
    A section or tag path from listSections, e.g. "world", "sport", "environment/climate-crisis".
    No
    limitnumberNo

    Returns GuardianListArticlesResult

    interface 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/getTopicArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.getTopicArticles("environment/climate-crisis");
  • getVideoWatch a video and read its description.

    Arguments

    NameTypeRequired
    videoUrlOrIdstringYes

    Returns GuardianVideo

    interface 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/getVideo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    sectionstring
    A section or tag path from listSections, e.g. "world", "sport", "environment/climate-crisis".
    No
    limitnumberNo

    Returns GuardianListArticlesResult

    interface 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/listArticlesBySection

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listArticlesBySection({ section: "world" });
  • listBreakingNewsGet the latest breaking news stories.

    Arguments

    None.

    Returns GuardianListArticlesResult

    interface 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/listBreakingNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listBreakingNews();
  • listContributorsLists journalists and contributors whose surname starts with one letter, with each one's profile slug.

    Arguments

    NameTypeRequired
    letterstring
    A single letter (a-z): contributors whose surname starts with it.
    Yes
    limitnumberNo

    Returns GuardianListContributorsResult

    interface GuardianContributor {
      name: string;
      slug: string;
      url: string;
    }
    
    interface GuardianListContributorsResult {
      letter: string;
      contributors: GuardianContributor[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/theguardian_com/listContributors

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listContributors({ letter: "h" });
  • listFootballMatchesUpcoming fixtures or played results for one football competition (or every competition at once).

    Arguments

    NameTypeRequired
    competitionstring
    A competition slug from getFootballTable's competition, e.g. "premierleague".
    No
    kind"fixtures" | "results"
    "fixtures" (upcoming) or "results" (played).
    No

    Returns GuardianListFootballMatchesResult

    interface 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/listFootballMatches

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listFootballMatches({ kind: "results" });
  • listLiveBlogsList live blogs covering breaking news and events.

    Arguments

    NameTypeRequired
    limitnumberNo

    Returns GuardianListArticlesResult

    interface 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/listLiveBlogs

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listLiveBlogs();
  • listNewslettersEvery email newsletter The Guardian publishes.

    Arguments

    None.

    Returns GuardianListNewslettersResult

    interface 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/listNewsletters

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listNewsletters();
  • listOpinionPiecesGet opinion and comment articles from The Guardian.

    Arguments

    NameTypeRequired
    limitnumberNo

    Returns GuardianListArticlesResult

    interface 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/listOpinionPieces

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listOpinionPieces();
  • listPhotosList photo galleries by date and topic.

    Arguments

    NameTypeRequired
    limitnumberNo

    Returns GuardianListPhotosResult

    interface 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/listPhotos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listPhotos();
  • listPodcastEpisodesEpisodes of one Guardian podcast, newest first.

    Arguments

    NameTypeRequired
    seriesstring
    A 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 GuardianListPodcastEpisodesResult

    interface 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/listPodcastEpisodes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listPodcastEpisodes();
  • listReviewsGet reviews of film, TV, theatre, books, etc.

    Arguments

    NameTypeRequired
    categorystring
    A category path for reviews: "books", "film", "music", "stage", "art", or similar.
    No
    limitnumberNo

    Returns GuardianListArticlesResult

    interface 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/listReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listReviews({ category: "books" });
  • listSectionsList all available sections on the site.

    Arguments

    None.

    Returns GuardianListSectionsResult

    interface 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/listSections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listSections();
  • listTopicsList trending topics and tagged collections (climate crisis, Ukraine, US elections, etc).

    Arguments

    None.

    Returns GuardianListTopicsResult

    interface 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/listTopics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listTopics();
  • listVideosList videos by topic and date.

    Arguments

    NameTypeRequired
    categorystring
    A section to scope the videos to, e.g. "sport" or "football".
    No
    limitnumberNo

    Returns GuardianListVideosResult

    interface 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/listVideos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.theguardian_com.listVideos();

Use it from code