The Guardian Connector for AI agents.
10 live capabilities
Research global news archives and pull full-text journalism stories.
Waiting for input…
Why people use The Guardian
The Guardian for Journalists: Stop Manual News Archiving
This Connector changes that by letting you ask for the data directly. You get full-text articles and metadata pulled into your chat in seconds, letting you focus on the analysis instead of the hunting.
What Vinkius changes
You get a direct line to a global news archive without the manual searching.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Historical Trend Analysis
A researcher asks for articles on renewable energy from 2010 to 2015 to see how the narrative shifted.
- Real-world use case 02
Competitor Monitoring
A brand manager asks for the latest technology news in the US edition to see how rivals are being mentioned.
- Real-world use case 03
Content Briefing
A writer asks for the most viewed stories in the Sport section to find inspiration for a new column.
Complete set · 10capabilities
The complete The Guardian capability set.
These are the exact actions your AI can choose when you ask it to work with The Guardian.
01—04
4 capabilities in this set.
Part of 10 available through The Guardian.
- 01 Capability
Search by tag
Browse content tagged with a specific keyword or tone. This is useful for finding stories on very niche topics.
- 02 Capability
Get item
Get the full content of a specific Guardian article, including the body and metadata. This is perfect for reading long-form pieces.
- 03 Capability
Get latest content
Pull the most recent articles from The Guardian, ordered by the newest first. Use this to see what is happening right now.
- 04 Capability
Get section details
Get editorial highlights and the most-viewed content for a specific section. This helps you see what is trending in a category.
05—07
3 capabilities in this set.
Part of 10 available through The Guardian.
- 05 Capability
List editions
List the available regional editions like UK, US, and Australia. Use this to ensure you are looking at the right geography.
- 06 Capability
List sections
List all editorial sections available on The Guardian, such as technology and sport. This helps you explore the full scope of coverage.
- 07 Capability
List tags
List tags used to categorize content, including keywords, series, and contributors. This is great for understanding the news taxonomy.
08—10
3 capabilities in this set.
Part of 10 available through The Guardian.
- 08 Capability
Search by date range
Search Guardian content within a specific date range for historical research. Use this to track events over time.
- 09 Capability
Search by section
Browse content within a specific section like world news or sport. This limits your search to specific editorial categories.
- 10 Capability
Search content
Search articles and content on The Guardian using filters like section, tag, and date. It helps you find specific stories quickly.
Set up in minutes
One URL. Then ask The Guardian to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use The Guardian from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_a1LLzfJa2PGS3eoVSY27IyjfLXslA0HlLkM52F2r/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it The Guardian, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable The Guardian for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_a1LLzfJa2PGS3eoVSY27IyjfLXslA0HlLkM52F2r/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the The Guardian URL.
- Step 03
Save and start
Save the connection and enable The Guardian in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"the-guardian": {
"url": "https://edge.vinkius.com/vk_preview_a1LLzfJa2PGS3eoVSY27IyjfLXslA0HlLkM52F2r/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using The Guardian
Open Agent mode in chat and ask: "Using The Guardian, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"the-guardian": {
"url": "https://edge.vinkius.com/vk_preview_a1LLzfJa2PGS3eoVSY27IyjfLXslA0HlLkM52F2r/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using The Guardian
Ask Copilot: "Using The Guardian, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"the-guardian": {
"url": "https://edge.vinkius.com/vk_preview_a1LLzfJa2PGS3eoVSY27IyjfLXslA0HlLkM52F2r/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using The Guardian
Open Cascade and ask: "Using The Guardian, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"the-guardian": {
"url": "https://edge.vinkius.com/vk_preview_a1LLzfJa2PGS3eoVSY27IyjfLXslA0HlLkM52F2r/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using The Guardian
Ask Cline: "Using The Guardian, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add the-guardian --transport http "https://edge.vinkius.com/vk_preview_a1LLzfJa2PGS3eoVSY27IyjfLXslA0HlLkM52F2r/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using The Guardian
Ask Claude: "Using The Guardian, show me...". 10 tools are ready
Where the request belongs
Work The Guardian can move forward.
This is for researchers who need to verify facts, journalists who need to surface related coverage quickly, and data scientists who want to feed high-quality journalism into their models.
Media Researcher
Pulling decades of reporting to track how a specific political topic has evolved over 20 years.
Content Strategist
Identifying trending tags and sections to plan a week's worth of social media posts.
Data Scientist
Scraping historical news data to train a sentiment analysis model or a niche knowledge base.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsMediastack
Access real-time and historical news articles from over 7,500 sources worldwide directly through your AI agent.
News
Search millions of articles and track breaking headlines from over 150,000 global news sources in real-time.
Newslit
Track news coverage, analyze media impact, and discover press opportunities with media intelligence capabilities for communications teams.
NewsAPI
Search breaking news and historical articles from 150,000+ sources via NewsAPI.org.
WorldNewsAPI
Search world news. audit articles, top stories, and sources via AI.
NewsCatcher
Search millions of news articles in real-time with AI clustering and topic tracking.
Bring your own AI
Change the model, client or framework. Keep The Guardian connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about The Guardian.
The practical details behind the request, access and result.
Can The Guardian MCP find stories from 10 years ago?
Yes, it can access the full archive. You can ask your agent to search for specific topics within a date range to find historical reporting.
Does The Guardian MCP work for international news?
Yes, it supports multiple regional editions. You can ask your agent to switch between UK, US, Australia, and International news.
Can I get the full text of an article?
Yes, the Connector can pull the complete body of a story, including the byline and publication date, so you can read it directly in your chat.
Is there a way to see what is currently trending?
Yes, you can ask your agent to show you the most-viewed content in any specific editorial section like Sport or Politics.
Can I search by specific topics or tags?
Yes, you can browse content by specific tags, which include keywords, contributors, and even the tone of the journalism.
How does The Guardian MCP help with research?
It allows you to quickly surface related coverage and verify publication history without manually searching through multiple websites.
Can I retrieve the full text of a Guardian article, not just the headline?
Yes. Use the get_item capability with the article's path ID. The response includes the full body text, byline, standfirst, publication date, section, tags, and thumbnail image when available.
How far back does the Guardian Content API archive go?
The Guardian Content API provides access to articles dating back to 1999. You can use search_by_date_range with specific start and end dates to query historical content from any period covered by the archive.
Is a paid subscription required to use this integration?
No. The Guardian Open Platform offers a free developer API key that supports up to 12 calls per second and 5,000 calls per day. This is sufficient for most research and automation workflows.
Can I filter articles by topic, section, or contributor?
Yes. The search_content capability accepts section, tag, and date filters. Use list_sections to discover available sections and list_tags to find keywords, contributors, and series to refine your queries.
One connection away
Give your agent a direct line to The Guardian.
Connect The Guardian once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available