# The Guardian

> The Guardian is a freemium MCP server for news and media. MCP server giving AI clients search access to The Guardian's articles, sections, tags. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/the-guardian
- **Repository:** https://github.com/pipeworx-io/mcp-the-guardian
- **MCP Registry name:** io.github.pipeworx-io/the-guardian
- **Categories:** [news and media](https://ai-powered.com/categories/news-and-media)
- **Listing updated:** 2026-11-18

## About

The Guardian's own content API is wrapped here as a set of MCP tools, so an assistant can search the newspaper's archive by keyword, section, tag or date range and open a full article by its ID. Lookup tools list sections, tags and geographic editions so a client can discover valid filter values before searching.

The server is hosted on the Pipeworx gateway, which also exposes shared meta-tools such as ask_pipeworx for routing questions across other data sources. A Guardian Open Platform developer key can be passed as a parameter on the gateway URL; without one, calls are anonymous and capped daily. The README describes the upstream key as free for developers, with rate limits of 12 requests per second and 5,000 per day.

The project is an independent, unofficial integration and is not affiliated with The Guardian. It is aimed at developers and researchers building AI workflows that need recent or archived news coverage.

## Features

- **Keyword and filter search:** Searches Guardian content by keyword, section, tag, date range and edition, with pagination and ordering.
- **Full article retrieval:** Fetches a single article by its content ID, including body text, tags and references.
- **Section listing:** Lists Guardian sections such as Politics, World, Sport and Culture, with IDs usable as search filters.
- **Tag browsing:** Finds tags by substring, type (keyword, series or contributor) or section.
- **Edition discovery:** Lists UK, US, Australian and International editions for edition-specific searches.

## Good for

- Pulling recent news on a topic into an AI assistant's answer
- Researching how a subject was covered across Guardian sections over time
- Retrieving full article text for summarisation or analysis
- Building a news monitor filtered by section, tag or edition

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http the-guardian https://gateway.pipeworx.io/the-guardian/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/the-guardian/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "the-guardian": {
      "url": "https://gateway.pipeworx.io/the-guardian/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "the-guardian": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/the-guardian/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "the-guardian": {
      "serverUrl": "https://gateway.pipeworx.io/the-guardian/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "the-guardian": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/the-guardian/mcp"
    }
  }
}
```

## Tools

- `search`: Search Guardian content by keyword, section, tag, date range and other filters.
- `item`: Fetch a single Guardian article by its content ID.
- `sections`: List Guardian content sections.
- `tags`: List and filter Guardian content tags.
- `editions`: List Guardian geographic editions.

## FAQ

### Is a Guardian API key required?

The README says the pack takes your own Guardian Open Platform key, and calls without one are anonymous and capped daily.

### How do I run it locally?

The README describes a stdio bridge started with npx, using the package @pipeworx/mcp-the-guardian, which forwards calls to the hosted gateway endpoint and requires network access.

### Is this an official Guardian product?

No. The README states it is an independent, unofficial integration not affiliated with or endorsed by The Guardian.

### Is The Guardian free?

The Guardian has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add The Guardian to Claude Code?

Run this command in your terminal: claude mcp add --transport http the-guardian https://gateway.pipeworx.io/the-guardian/mcp

### What are the best alternatives to The Guardian?

The closest alternatives to The Guardian are Newsapi, Tech Feeds, Crypto Feeds, World News Feeds and Gaming Feeds.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Newsapi](https://ai-powered.com/mcp/newsapi): Newsapi is a freemium MCP server for news and media.
- [Tech Feeds](https://ai-powered.com/mcp/tech-feeds): Tech Feeds is a freemium MCP server for news and media.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [World News Feeds](https://ai-powered.com/mcp/world-news-feeds): World News Feeds is a freemium MCP server for news and media.
- [Gaming Feeds](https://ai-powered.com/mcp/gaming-feeds): Gaming Feeds is a freemium MCP server for news and media.
- [Finance Feeds](https://ai-powered.com/mcp/finance-feeds): Finance Feeds is a freemium MCP server for finance and payments.
- [World Feed Monitor](https://ai-powered.com/mcp/world-feed-monitor): World Feed Monitor is a freemium MCP server for news and media.
- [Science Feeds](https://ai-powered.com/mcp/science-feeds): Science Feeds is a freemium MCP server for news and media.

---
Source: https://ai-powered.com/mcp/the-guardian
