`search`

Pack: the-guardian · Endpoint: https://gateway.pipeworx.io/the-guardian/mcp

Search The Guardian newspaper archive (UK-based international news outlet) for articles by keyword, section, tag, or date range. Returns headlines with author, section, publication date, web URL, and optional full body text. Use for “Guardian coverage of X” or UK/EU-perspective news on world events.

Parameters

Name	Type	Required
`q`	string	no
`section`	string	no
`tag`	string	no
`from_date`	string	no
`to_date`	string	no
`page`	number	no
`page_size`	number	no
`order_by`	string	no
`show_fields`	string	no
`show_tags`	string	no
`show_elements`	string	no

Example call

Arguments

{
  "q": "climate change",
  "section": "environment",
  "page_size": 10
}

curl

curl -X POST https://gateway.pipeworx.io/the-guardian/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"q":"climate change","section":"environment","page_size":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search', {
  "q": "climate change",
  "section": "environment",
  "page_size": 10
});

More examples

{
  "q": "artificial intelligence",
  "from_date": "2024-01-01",
  "to_date": "2024-12-31",
  "order_by": "newest",
  "show_fields": "byline,standfirst",
  "page": 1
}

Response shape

Field	Type	Description
`response`	object

Full JSON Schema

{
  "type": "object",
  "description": "Content search results from The Guardian",
  "properties": {
    "response": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "description": "Response status"
        },
        "userTier": {
          "type": "string",
          "description": "User tier level"
        },
        "total": {
          "type": "number",
          "description": "Total number of results"
        },
        "startIndex": {
          "type": "number",
          "description": "Start index of current page"
        },
        "pageSize": {
          "type": "number",
          "description": "Number of results per page"
        },
        "currentPage": {
          "type": "number",
          "description": "Current page number"
        },
        "pages": {
          "type": "number",
          "description": "Total number of pages"
        },
        "results": {
          "type": "array",
          "description": "Array of article results",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Article ID"
              },
              "type": {
                "type": "string",
                "description": "Content type"
              },
              "sectionId": {
                "type": "string",
                "description": "Section ID"
              },
              "sectionName": {
                "type": "string",
                "description": "Section name"
              },
              "webPublicationDate": {
                "type": "string",
                "description": "Web publication date ISO string"
              },
              "webTitle": {
                "type": "string",
                "description": "Article web title"
              },
              "webUrl": {
                "type": "string",
                "description": "Article web URL"
              },
              "apiUrl": {
                "type": "string",
                "description": "API endpoint for this article"
              },
              "fields": {
                "type": "object",
                "description": "Additional fields if requested"
              },
              "tags": {
                "type": "array",
                "description": "Associated tags if requested",
                "items": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

search