`sections`

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

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().

Parameters

Name	Type	Required	Description
`q`	string	no

Example call

Arguments

{
  "q": "world"
}

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":"sections","arguments":{"q":"world"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('sections', {
  "q": "world"
});

Response shape

Field	Type	Description
`response`	object

Full JSON Schema

{
  "type": "object",
  "description": "List of Guardian sections",
  "properties": {
    "response": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "description": "Response status"
        },
        "userTier": {
          "type": "string",
          "description": "User tier level"
        },
        "results": {
          "type": "array",
          "description": "Array of section results",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Section ID"
              },
              "webTitle": {
                "type": "string",
                "description": "Section web title"
              },
              "webUrl": {
                "type": "string",
                "description": "Section web URL"
              },
              "apiUrl": {
                "type": "string",
                "description": "Section API endpoint"
              }
            }
          }
        }
      }
    }
  }
}

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.

sections