# The Guardian MCP for AI Agents AI Agent Connect > The Guardian MCP gives your AI agent direct access to the complete archives of one of the world's most respected newsrooms. You can search for specific stories, browse different editorial sections like Technology or Sport, and pull full-text articles with all their metadata. It is the fastest way to turn a massive news archive into a searchable knowledge base for your research or content planning. ## Overview - **Category:** knowledge-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_a1LLzfJa2PGS3eoVSY27IyjfLXslA0HlLkM52F2r/ai-agent-connect - **Tags:** journalism, content-archive, news-api, article-search, media-intelligence, data-retrieval ## Description This Connector connects your AI client to The Guardian Open Platform, letting you pull world-class journalism into your workspace without manually digging through websites. Instead of jumping between tabs to find historical reporting or specific regional news, you can just ask your agent to find the facts. It handles the heavy lifting of filtering by date, tag, and section, providing you with clean, full-text stories and editorial metadata. Whether you are looking for a deep dive into a specific topic or just want to see what is trending in the UK edition today, this tool brings that data straight to your prompt. It is a major win for anyone who needs to ground their work in high-quality reporting. You can find this among the 4,000+ integrations in the Vinkius catalog to get your setup running in minutes. It turns a massive archive into a conversational source of truth for your projects, allowing you to surface related coverage and verify publication history without leaving your writing environment. ## Tools ### search_by_tag Browse content tagged with a specific keyword or tone. This is useful for finding stories on very niche topics. ### get_item Get the full content of a specific Guardian article, including the body and metadata. This is perfect for reading long-form pieces. ### 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. ### 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. ### list_editions List the available regional editions like UK, US, and Australia. Use this to ensure you are looking at the right geography. ### list_sections List all editorial sections available on The Guardian, such as technology and sport. This helps you explore the full scope of coverage. ### list_tags List tags used to categorize content, including keywords, series, and contributors. This is great for understanding the news taxonomy. ### search_by_date_range Search Guardian content within a specific date range for historical research. Use this to track events over time. ### search_by_section Browse content within a specific section like world news or sport. This limits your search to specific editorial categories. ### search_content Search articles and content on The Guardian using filters like section, tag, and date. It helps you find specific stories quickly. ## Prompt Examples **Prompt:** ``` Find some recent articles about the impact of AI on the UK job market. ``` **Response:** ``` I found several recent pieces regarding AI and the labor market in the UK. Here are the highlights: * **AI and the UK Workforce** (Technology Section) * **Automation Trends in Manufacturing** (Business Section) Would you like me to pull the full text for any of these? ``` **Prompt:** ``` What are the most viewed stories in the Technology section right now? ``` **Response:** ``` The most-viewed stories in the **Technology** section currently include: | Rank | Headline | Section | | :--- | :--- | :--- | | 1 | New breakthroughs in quantum computing | Technology | | 2 | The ethics of generative media | Technology | | 3 | Global chip shortage updates | Technology | Let me know if you want to dive into any of these. ``` **Prompt:** ``` Search for any Guardian articles about climate change from early 2020. ``` **Response:** ``` I retrieved 14 articles regarding **climate change** from between January and March 2020. Key themes include: * Policy shifts in the EU * Extreme weather events in Australia * Renewable energy investment trends I can fetch the full body of any specific article from this list for you. ``` ## Capabilities ### Search the entire news archive Query full-text stories with specific filters like dates, sections, and tags. ### Pull full article text Get the complete body, byline, and publication date of any story. ### Browse editorial sections See the latest content from specific categories like Politics, Sport, or Technology. ### Explore news tags Discover keywords, contributors, and tones used to categorize journalism. ### Access regional editions Switch between UK, US, Australia, and International news editions. ### Track historical data Retrieve articles from specific time windows for trend analysis or event tracking. ## Use Cases ### Historical Trend Analysis A researcher asks for articles on renewable energy from 2010 to 2015 to see how the narrative shifted. The agent uses search_by_date_range to pull the data. ### Competitor Monitoring A brand manager asks for the latest technology news in the US edition to see how rivals are being mentioned. The agent uses list_editions and search_by_section. ### Content Briefing A writer asks for the most viewed stories in the Sport section to find inspiration for a new column. The agent uses get_section_details to find the highlights. ### Fact Checking A journalist asks for the full text of a specific archived piece to verify a quote from a previous year. The agent uses get_item to pull the complete body. ## Benefits - Stop manual searching. Use search_content to find exactly what you need in seconds instead of scrolling through pages of results. - Get full context instantly. get_item pulls the entire body of an article so your agent can summarize the whole story without missing details. - Stay on top of trends. get_latest_content lets you see what is happening right now across all news categories in one simple request. - Deep dive into history. search_by_date_range makes it easy to pull archives from specific years for academic or professional research. - Understand the taxonomy. list_tags helps you see how different topics are categorized by professional editors to improve your own content organization. - Access regional variety. list_editions lets you quickly switch between UK, US, and Australian news to get a global perspective. ## How It Works The bottom line is you get a direct line to a global news archive without the manual searching. 1. Get a free API key from The Guardian Open Platform. 2. Connect this Connector to your AI client via the Vinkius dashboard. 3. Ask your agent to find specific news, summarize headlines, or pull historical archives. ## Frequently Asked Questions **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` tool 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` tool 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.