Guardian MCP Server

Guardian Open Platform — search and retrieve full article text from The Guardian archive.

Local serverstdio

What is the Guardian MCP Server?

Guardian Open Platform — search and retrieve full article text from The Guardian archive.

What it actually does

  • Declarative tool definitions — single file per tool, framework handles registration and validation
  • Unified error handling — handlers throw, framework catches, classifies, and formats
  • Pluggable auth: none, jwt, oauth
  • Swappable storage backends: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1
  • Structured logging with optional OpenTelemetry tracing
  • STDIO and Streamable HTTP transports

Configuration

A free Guardian Open Platform API key is required. Register at https://open-platform.theguardian.com/access — the non-commercial developer tier is free. Set it as GUARDIAN_API_KEY in your MCP client config or .env file. The server will not start without it. > > Rate limits (free tier): 5,000 requests/day, 12 calls/second. The server

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
guardian_searchFull-text search across The Guardian's archive (1999–present) with optional section, tag, contributor, and date filters. Returns articles with full body text (HTML stripped, truncated at 2,000 words).
guardian_get_articleFetch a single Guardian article by its ID (path slug) with full body text and all metadata. Use after guardian_search to retrieve the complete untruncated text.
guardian_browseBrowse The Guardian's content by section or tag, or discover available sections and tags. Four modes: section_latest, tag_latest, list_sections, list_tags.

How to install the Guardian MCP Server

{
  "mcpServers": {
    "guardian-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/guardian-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "GUARDIAN_API_KEY": "your-api-key"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

A free Guardian Open Platform API key is required. Register at https://open-platform.theguardian.com/access — the non-commercial developer tier is free. Set it as GUARDIAN_API_KEY in your MCP client config or .env file. The server will not start without it. > > Rate limits (free tier): 5,000 requests/day, 12 calls/second. The server

VariableDescriptionRequired
MCP_TRANSPORT_TYPEConfiguration value read at startup.Optional
MCP_LOG_LEVELConfiguration value read at startup.Optional
GUARDIAN_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • “Use Guardian to guardian search.”
  • “Use Guardian to guardian get article.”
  • “Use Guardian to guardian browse.”

Frequently asked questions

Guardian Open Platform — search and retrieve full article text from The Guardian archive. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.