GDELT Project Connector for AI agents.
16 live capabilities
Monitor global news events and media sentiment in real time.
Waiting for input…
Why people use GDELT Project
Stanford GDELT for Real-Time Media Monitoring
This Connector puts that entire dataset into your agent. You can ask for a summary of global sentiment or a country-by-country breakdown of coverage in seconds. You get the full picture without the manual labor.
What Vinkius changes
You get a real-time global news feed that your AI can actually reason over.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
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`.
- Real-world use case 02
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`.
- Real-world use case 03
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`.
Complete set · 16capabilities
The complete GDELT Project capability set.
These are the exact actions your AI can choose when you ask it to work with GDELT Project.
01—04
4 capabilities in this set.
Part of 16 available through GDELT Project.
- 01 Capability
Get geo data
Get geographic point data for news events including coordinates and location names. Use this to map where events occur.
- 02 Capability
Get tv channels
View the full inventory of available TV news channels. Use this to see the scope of available TV coverage.
- 03 Capability
Get tv timeline
See which stories are dominating TV airtime compared to online news. This helps track TV-specific coverage patterns.
- 04 Capability
Get themes
Get the distribution of GDELT themes like politics or economics for a topic. Use this to see how news is categorized.
05—08
4 capabilities in this set.
Part of 16 available through GDELT Project.
- 05 Capability
Get timeline country
See which nations are most interested in a story and when it goes global. This reveals geographic patterns in media attention.
- 06 Capability
Get timeline lang
Find out which linguistic communities are paying attention to a specific issue. This shows how interest spreads across languages.
- 07 Capability
Get timeline tone
Track positive and negative sentiment shifts in media coverage over time. This is essential for monitoring public opinion.
- 08 Capability
Get word cloud
Extract dominant terms and concepts from a specific topic's media coverage. This reveals key terms in media discourse.
09—12
4 capabilities in this set.
Part of 16 available through GDELT Project.
- 09 Capability
Search articles
Search global news articles across 100+ languages with filters for date and country. This returns titles, URLs, and domains.
- 10 Capability
Search by country
Find news articles from a specific country using standard ISO codes. Use this to understand country-specific perspectives.
- 11 Capability
Search by theme
Find articles based on standardized categories like environmental issues or elections. Use this for precise topic monitoring.
- 12 Capability
Search nearby
Find articles where two specific terms appear near each other in the text. Use this for more precise proximity searching.
13—16
4 capabilities in this set.
Part of 16 available through GDELT Project.
- 13 Capability
Search tv
Search TV news transcripts from networks like CNN and BBC for specific keywords. This returns clips with timestamps and station names.
- 14 Capability
Get timeline volume
Identify news spikes and understand the lifecycle of a story over time. Use this to track overall media attention.
- 15 Capability
Get tone chart
See a distribution chart of positive, negative, and neutral coverage for a topic. This shows the overall emotional intensity.
- 16 Capability
Search by language
Search for news articles in specific languages like Spanish or Chinese. Use this to monitor different linguistic communities.
Set up in minutes
One URL. Then ask GDELT Project to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use GDELT Project 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_4kP3UCMR7zNOY2ILH70ZycCW8T37vI6wXTojR5rv/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 GDELT Project, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable GDELT Project for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_4kP3UCMR7zNOY2ILH70ZycCW8T37vI6wXTojR5rv/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 GDELT Project URL.
- Step 03
Save and start
Save the connection and enable GDELT Project in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"stanford-gdelt": {
"url": "https://edge.vinkius.com/vk_preview_4kP3UCMR7zNOY2ILH70ZycCW8T37vI6wXTojR5rv/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 GDELT Project
Open Agent mode in chat and ask: "Using GDELT Project, help me...". 16 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"stanford-gdelt": {
"url": "https://edge.vinkius.com/vk_preview_4kP3UCMR7zNOY2ILH70ZycCW8T37vI6wXTojR5rv/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 GDELT Project
Ask Copilot: "Using GDELT Project, help me...". 16 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"stanford-gdelt": {
"url": "https://edge.vinkius.com/vk_preview_4kP3UCMR7zNOY2ILH70ZycCW8T37vI6wXTojR5rv/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 GDELT Project
Open Cascade and ask: "Using GDELT Project, help me...". 16 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"stanford-gdelt": {
"url": "https://edge.vinkius.com/vk_preview_4kP3UCMR7zNOY2ILH70ZycCW8T37vI6wXTojR5rv/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 GDELT Project
Ask Cline: "Using GDELT Project, help me...". 16 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add stanford-gdelt --transport http "https://edge.vinkius.com/vk_preview_4kP3UCMR7zNOY2ILH70ZycCW8T37vI6wXTojR5rv/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 GDELT Project
Ask Claude: "Using GDELT Project, show me...". 16 tools are ready
Where the request belongs
Work GDELT Project can move forward.
This is for researchers, journalists, and analysts who need to monitor global narratives without getting buried in raw data. It's for the person who needs to know what's happening in 50 countries simultaneously.
Journalist
Tracking breaking stories and identifying narrative shifts across different media outlets.
Political Scientist
Analyzing geopolitical events and public discourse across various linguistic communities.
PR Manager
Monitoring brand reputation and tracking sentiment shifts during a crisis.
Policy Analyst
Understanding how different nations are covering specific policy issues like climate change or trade.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsNewslit
Track news coverage, analyze media impact, and discover press opportunities with media intelligence capabilities for communications teams.
WorldNewsAPI
Search world news. audit articles, top stories, and sources via AI.
News
Search millions of articles and track breaking headlines from over 150,000 global news sources in real-time.
Meltwater
Media intelligence and social monitoring via Meltwater. track news, mentions, and analytics.
NewsCatcher
Search millions of news articles in real-time with AI clustering and topic tracking.
Currents
Access real-time global news and search millions of articles directly from your AI agent using the Currents API.
Bring your own AI
Change the model, client or framework. Keep GDELT Project 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 GDELT Project.
The practical details behind the request, access and result.
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 capability 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.
One connection away
Give your agent a direct line to GDELT Project.
Connect GDELT Project once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available