# Stanford GDELT MCP for AI Agents AI Agent Connect > Stanford GDELT MCP lets you pull real-time global news data into your AI client. It covers everything from sentiment shifts and geographic mapping to TV news transcripts and language distribution. It's the fastest way to see how a story is moving across the globe, what people are saying about it, and where it's actually happening. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_4kP3UCMR7zNOY2ILH70ZycCW8T37vI6wXTojR5rv/ai-agent-connect - **Tags:** gdelt, global-news, sentiment-analysis, media-monitoring, geopolitics, tv-news, multilingual ## Description The Stanford GDELT MCP connects your agent to the world's largest open platform for monitoring global news media in real time. Instead of jumping between dozens of news sites and translating headlines, you can ask your agent to pull data directly from the GDELT Project API. You can track how media attention to a specific topic changes over time, see which nations are producing the most coverage, and identify which linguistic communities are paying attention to an issue. This Connector also lets you pull closed-caption transcripts from major TV networks like CNN and the BBC. It’s designed for people who need to see the big picture without the noise. By integrating this into your workflow via Vinkius, you turn a mountain of global news into a structured set of data points. You can see sentiment shifts, geographic hotspots, and dominant themes across geopolitics, health, and economics without the manual copy-pasting. ## Tools ### get_geo_data Get geographic point data for news events including coordinates and location names. Use this to map where events occur. ### get_tv_channels View the full inventory of available TV news channels. Use this to see the scope of available TV coverage. ### get_tv_timeline See which stories are dominating TV airtime compared to online news. This helps track TV-specific coverage patterns. ### get_themes Get the distribution of GDELT themes like politics or economics for a topic. Use this to see how news is categorized. ### get_timeline_country See which nations are most interested in a story and when it goes global. This reveals geographic patterns in media attention. ### get_timeline_lang Find out which linguistic communities are paying attention to a specific issue. This shows how interest spreads across languages. ### get_timeline_tone Track positive and negative sentiment shifts in media coverage over time. This is essential for monitoring public opinion. ### get_word_cloud Extract dominant terms and concepts from a specific topic's media coverage. This reveals key terms in media discourse. ### search_articles Search global news articles across 100+ languages with filters for date and country. This returns titles, URLs, and domains. ### search_by_country Find news articles from a specific country using standard ISO codes. Use this to understand country-specific perspectives. ### search_by_theme Find articles based on standardized categories like environmental issues or elections. Use this for precise topic monitoring. ### search_nearby Find articles where two specific terms appear near each other in the text. Use this for more precise proximity searching. ### search_tv Search TV news transcripts from networks like CNN and BBC for specific keywords. This returns clips with timestamps and station names. ### get_timeline_volume Identify news spikes and understand the lifecycle of a story over time. Use this to track overall media attention. ### get_tone_chart See a distribution chart of positive, negative, and neutral coverage for a topic. This shows the overall emotional intensity. ### search_by_language Search for news articles in specific languages like Spanish or Chinese. Use this to monitor different linguistic communities. ## Prompt Examples **Prompt:** ``` What's the current global sentiment on the new lithium mining regulations? ``` **Response:** ``` I've analyzed the GDELT data for "lithium mining regulations." Here is the current sentiment breakdown: | Region | Sentiment | Trend | | :--- | :--- | :--- | | North America | Neutral | Stable | | South America | Negative | Increasing | | East Asia | Positive | Rising | **Key Insights:** * **South America:** High volume of coverage regarding environmental concerns. * **East Asia:** Focus on supply chain security and manufacturing growth. ``` **Prompt:** ``` Show me a summary of TV news coverage for the recent earthquake in Japan. ``` **Response:** ``` I've pulled the latest TV news transcripts regarding the earthquake in Japan. **Major Networks Coverage:** * **CNN:** Focused on humanitarian aid efforts and rescue operations. * **BBC:** Highlighted the infrastructure damage and local government response. * **Fox News:** Reported on the economic impact on local industries. *Note: Coverage is currently peaking in the last 48 hours.* ``` **Prompt:** ``` How has the media volume for 'electric vehicles' changed in the last 3 months? ``` **Response:** ``` The media volume for "electric vehicles" has shown a steady upward trend over the last 3 months. * **Month 1:** 1.2M mentions (Baseline) * **Month 2:** 1.5M mentions (+25%) * **Month 3:** 2.1M mentions (+40%) **Key Drivers:** * New government subsidies announced in the EU. * Major automaker announcements regarding battery production. ``` ## Capabilities ### Track news volume spikes See how media attention to a specific topic fluctuates over time. ### Map news events to coordinates Get geographic point data to see exactly where news events are happening. ### Analyze sentiment shifts Monitor whether coverage of a subject is turning positive, negative, or neutral. ### Pull TV news transcripts Access closed-caption transcripts from major networks like CNN and Fox News. ### Identify dominant themes Explore standardized categories like politics, health, and economics in global news. ### Filter news by country Identify which nations are producing the most coverage of specific issues. ## Use Cases ### Crisis Reputation Monitoring A PR lead asks the agent to find negative sentiment regarding a product recall in specific countries using `get_timeline_tone` and `search_by_country`. ### Geopolitical Trend Analysis A researcher asks for a timeline of how a specific trade agreement is being covered in China vs the US using `get_timeline_country`. ### Breaking News Summary A journalist asks for a word cloud and theme analysis on a sudden protest in a specific region using `get_word_cloud` and `search_by_theme`. ### Media Volume Tracking A marketing lead wants to see the volume of news regarding 'renewable energy' over the last 3 months using `get_timeline_volume`. ## Benefits - Get a bird's-eye view of global news with `search_articles` and `get_timeline_volume` to see where stories are peaking. - Track public opinion shifts accurately using `get_timeline_tone` and `get_tone_chart` to monitor sentiment. - Identify geographic hotspots for events using `get_geo_data` and `get_timeline_country` to see where news is breaking. - Access transcripts from major networks like CNN and BBC via `search_tv` to see what's on the air. - Understand deep narrative trends using `get_themes` and `get_word_cloud` to see the most common topics. - Reach global audiences by filtering coverage with `search_by_language` and `search_by_country`. ## How It Works The bottom line is you get a real-time global news feed that your AI can actually reason over. 1. Subscribe to the Stanford GDELT MCP on Vinkius. 2. Connect the Connector to your preferred AI client like Claude or Cursor. 3. Ask your agent to search for news, analyze sentiment, or map events. ## Frequently Asked Questions **Can I use Stanford GDELT MCP to track news in different languages?** Yes, it covers over 100 different languages. You can filter by specific languages like Spanish, Chinese, or Arabic to see how different linguistic communities are covering the same event. **Does Stanford GDELT MCP include TV news transcripts?** Yes, it includes transcripts from major networks like CNN, Fox News, MSNBC, and the BBC. You can search these transcripts for specific keywords to see what's on the air. **Is there a cost to using Stanford GDELT MCP?** No, the GDELT project is completely free to use. You only need to subscribe to the Connector via Vinkius to connect it to your AI client. **Can I see where news events are happening geographically?** Yes, the Connector provides geographic point data. This includes coordinates and location names, allowing you to see where news events are breaking around the world. **Can I use Stanford GDELT MCP for brand monitoring?** Absolutely. It's a powerful tool for tracking sentiment shifts and media volume. You can monitor how the public mood changes regarding your brand or a specific product launch in real time. **Does Stanford GDELT MCP provide theme analysis?** Yes, it categorizes news into standardized themes such as politics, economics, health, and environment. This helps you understand the core topics driving global discourse. **Do I need an API key?** No. The GDELT API is completely free and requires no authentication or registration. **How often is GDELT updated?** GDELT updates every 15 minutes, making it one of the most real-time global news monitoring platforms available. It processes news from virtually every country on Earth in over 100 languages. **Can I search TV news transcripts?** Yes. GDELT provides access to closed caption transcripts from major TV news networks including CNN, Fox News, MSNBC, BBC, and many international broadcasters. You can search by keyword and get clip galleries with timestamps.