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. Exposed over MCP by the guardian mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

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

Its toolset

Everything the assistant can do here goes through one of these:

  • guardian_search — Full-text search across The Guardian's archive (1999–present) with optional section, tag, contributor, and date filters. Returns articles with full
  • guardian_get_article — Fetch a single Guardian article by its ID (path slug) with full body text and all metadata. Use after guardian_search to retrieve the complete
  • guardian_browse — Browse The Guardian's content by section or tag, or discover available sections and tags. Four modes: section_latest, tag_latest, list_sections
  • Prerequisites — The Prerequisites tool exposed by this server
  • Installation — The Installation tool exposed by this server

Configuration

You will need 3 environment variables: MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, GUARDIAN_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

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

Adding it to your client

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

When to reach for it

Among the file and storage access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Guardian's toolset — guardian_search, guardian_get_article, guardian_browse and 2 more — is a fair guide to whether it matches your workflow. It is maintained by cyanheads; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Guardian's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the guardian mcp server does with a few real requests.

Available tools

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.
PrerequisitesThe Prerequisites tool exposed by this server.
InstallationThe Installation tool exposed by this server.

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

It connects Guardian to MCP-compatible AI assistants such as Claude and Cursor, exposing 5 tools (guardian_search, guardian_get_article, guardian_browse, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Guardian directly.