Guardian MCP Server

@cyanheads/guardian-mcp-server Search, browse, and retrieve full article text from The Guardian's journalism archive (1999–present) via MCP. STDIO or Streamable HTTP. Its README documents 3 tools, including guardian_search, guardian_get_article, guardian_browse.

People who work with articles, guardian and journalism and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-22 · ★ 2 · #422 OF 998 MAINTAINED OTHER · VERIFIED 2026-09-30

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install Guardian MCP Server

before you install - you'll need

Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, GUARDIAN_API_KEY before connecting.

Claude Code

claude mcp add cyanheads-guardian-mcp-server -- npx -y @cyanheads/guardian-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "cyanheads-guardian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/guardian-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package @cyanheads/guardian-mcp-server - published under the repo owner's npm scope (@cyanheads)

registry namespace io.github.cyanheads is GitHub-verified and matches the repo owner

03 · What Guardian MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can fetch a single Guardian article by ID with full untruncated body text and metadata, and browse by section or tag, or discover available sections and tags, across four modes.

The 3 tools it gives your agent

Extracted from the project's README - what guardian-mcp-server lets an agent do.

guardian_search
- Full-text search across The Guardian's archive with optional section, tag, contributor, and date filters
guardian_get_article
- Fetch a single Guardian article by ID with full untruncated body text and metadata
guardian_browse
- Browse by section or tag, or discover available sections and tags, across four modes

Latest releases

v0.1.4 · 2026-09-22

Framework 0.13.6, stateless session default, entity decode fix · @cyanheads/mcp-ts-core ^0.12.3 → ^0.13.6 - argument rejections return a -32602 envelope with reason: invalid_arguments and a recovery hint naming…

v0.1.3 · 2026-08-21

Framework 0.12.3 adoption: SDK v2 runtime, recovery hints on the wire · @cyanheads/mcp-ts-core ^0.10.6 → ^0.12.3 - MCP SDK v2 runtime serving protocol revision 2026-07-28 alongside the 2025 era, strict tool inputs…

v0.1.2 · 2026-06-12

mcp-ts-core ^0.10.6 adoption · Framework adoption pass bringing total-count enrichment, explicit server identity, a Docker healthcheck, and MCPB bundle cleaning. · Added: · totalCount enrichment on guardian_search and…

04 · Who maintains Guardian MCP Server

guardian-mcp-server is maintained by cyanheads. We track 137 MCP servers from cyanheads - 131 actively maintained, 1,856 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from cyanheads.

  1. obsidian-mcp-server Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP. ★ 690
  2. mcp-ts-core Agent-native TypeScript framework for MCP servers. ★ 152
  3. git-mcp-server Comprehensive Git MCP server enabling native git tools including clone, commit, worktree, & more. ★ 240
  4. clinicaltrialsgov-mcp-server Search ClinicalTrials.gov - find studies, retrieve results, match patients to eligible trials. ★ 96
  5. openalex-mcp-server Access the OpenAlex academic research catalog - 270M+ publications. ★ 14
  6. mcp-ts-template TypeScript template for building MCP servers with declarative tooling, observability, and auth. ★ 152

05 · Facts

category
other - ranked #422 of 998 actively-maintained other servers as of 2026-09-30.
release cadence
2 releases in the last 90 days (latest 2026-09-22)
registry
io.github.cyanheads/guardian-mcp-server (active, first published 2026-06-01 · 4 versions)
packages
npm:@cyanheads/guardian-mcp-server · npm:@cyanheads/guardian-mcp-server

06 · Guardian MCP Server FAQ

Is Guardian MCP Server still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-22 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Guardian MCP Server do?

With this server connected, an agent can fetch a single Guardian article by ID with full untruncated body text and metadata, and browse by section or tag, or discover available sections and tags, across four modes.

How do I install Guardian MCP Server?

Run `npx -y @cyanheads/guardian-mcp-server`. The README documents 3 environment variables (MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, GUARDIAN_API_KEY) to set first. Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, GUARDIAN_API_KEY before connecting. You can also paste the ready-made client config above.

Does Guardian MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Guardian MCP Server

More MCP servers to compare · Gutenberg MCP Server · Hn MCP Server · Internet Archive MCP Server · Libofcongress MCP Server · Ntfy MCP Server

More TypeScript MCP servers · Macos MCP Server · see all