`editions`

Pack: the-guardian · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/editions for the schema, then POST the same URL with its arguments for the data.

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.

Parameters

Name	Type	Required	Description
`q`	string	no

Example call

Arguments

{
  "q": "uk"
}

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

TypeScript (@pipeworx/sdk)

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

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

Response shape

Field	Type	Description
`response`	object

Full JSON Schema

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

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the the-guardian pack

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

See Getting Started for client-specific install steps.

editions