The Guardian

liveNewsMedia

The Guardian Open Platform — search and retrieve articles, sections, tags, and editions from The Guardian newspaper.

5tools
0msauth
free tier50 calls/day
🔑Authentication

BYO key only — free developer key from the Guardian Open Platform. Pass _apiKey on the gateway URL.

Config with credentials
{
  "mcpServers": {
    "pipeworx-the-guardian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/the-guardian/mcp?_apiKey=your_guardian_key"
      ]
    }
  }
}

Get an API key →

Tools

item

Fetch a single Guardian article by its content ID (e.g. "world/2024/jan/15/..."). Returns full body text, tags, related elements, and references. Use after search returns an article you want the full

No parameters required.

▶Try it
sections

List The Guardian's content sections (Politics, World, Sport, Culture, Environment, etc.). Optionally filter by name substring via q. Returns section IDs and titles for use as filters in search().

No parameters required.

▶Try it
tags

Browse The Guardian's content tags (topics, series, contributors, and keywords like "climate-change" or "long-read"). Filter by q substring, type (keyword/series/contributor), or section. Returns tag

No parameters required.

▶Try it
editions

List The Guardian's geographic editions (UK, US, Australia, International). Returns edition IDs and hostnames. Use to discover edition-specific content streams before filtering search() by edition.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/the-guardian/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/the-guardian/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("the guardian open platform — search and retrieve articles, sections, tags, and editions from the guardian newspaper");