Do I need an API key for GDELT?

No, GDELT is a free open platform, and this MCP handles the connection for you.

Which AI clients can use this MCP?

You can use this with any MCP-compatible client, including Claude, Cursor, and Windsurf.

Can I search for news in languages other than English?

Yes, the MCP supports searches across more than 100 different languages.

Does this include television news?

Yes, you can search transcripts from major networks like CNN, BBC, Fox News, and MSNBC.

How do I track sentiment changes?

You can use the tone timeline capabilities to see if coverage is trending positive or negative over a specific period.

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.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Stanford Gdelt to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Track media trends and sentiment across the world in real time.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 16 capabilities

We ship only the actions that matter.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 16 available through GDELT Project.

01
Get geo data
This capability provides geographic coordinates and location names for news events. You can request individual points or heatmap data for spatial analysis.
02
Get themes
This capability retrieves GDELT's standardized theme classifications. It breaks down news into categories like politics, health, and the environment.
03
Get timeline lang
This capability tracks how interest in a topic moves across different linguistic communities over time.
04
Get timeline tone
This capability pulls sentiment data to show if coverage of a subject is trending positive or negative.

Capability set02 / 04

05-08

4 capabilities in this set.

Part of 16 available through GDELT Project.

05
Get timeline volume
This capability monitors the lifecycle of a news story by tracking media attention spikes.
06
Get word cloud
This capability extracts the most frequent terms and concepts used in coverage of a specific topic.
07
Search articles
This capability searches global news articles using filters for language, country, date, and topic.
08
Search by country
This capability filters news articles based on specific ISO 2-letter country codes.

Capability set03 / 04

09-12

4 capabilities in this set.

Part of 16 available through GDELT Project.

09
Get tv channels
This capability provides an inventory of available TV news channels for analysis.
10
Get timeline country
This capability shows how media interest in a topic shifts between different nations over time.
11
Get tv timeline
This capability tracks the volume of mentions for a topic specifically within TV news broadcasts.
12
Search tv
This capability searches TV news transcripts from major networks like CNN and BBC for specific keywords.

Capability set04 / 04

13-16

4 capabilities in this set.

Part of 16 available through GDELT Project.

13
Search by language
This capability finds news articles within a specific language across 100+ different linguistic groups.
14
Search by theme
This capability pulls articles categorized under standardized GDELT themes like climate change or elections.
15
Search nearby
This capability finds articles where two specific terms appear close to each other in the text.
16
Get tone chart
This capability generates data regarding the emotional intensity and sentiment distribution of news coverage.

Real work

What teams actually run

Crisis Management

Monitor real-time sentiment shifts to see how a brand or event is being perceived during a crisis.

Geopolitical Research

Track how different countries report on the same international conflict or treaty.

Trend Spotting

Use volume timelines to find emerging topics before they hit mainstream saturation.

Media Auditing

Compare how much airtime a topic gets on TV versus how it is covered in digital news.

Automate a task

Put GDELT Project to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

GDELT Project works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put GDELT Project to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1081ms average. Fast in production.

GDELT Project is checked daily against the live service.

Daily averagePeak 1395ms

Oct 3Today

Fastest day: 911ms
Slowest day: 1395ms
14-day trend: Improving-16%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 16 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of GDELT Project, so you can see the experience inside your AI.

It does not authenticate your account with GDELT Project. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

GDELT Project Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_4kP3UCMR7zNOY2ILH70ZycCW8T37vI6wXTojR5rv/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — GDELT Project capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "stanford-gdelt-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_4kP3UCMR7zNOY2ILH70ZycCW8T37vI6wXTojR5rv/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up GDELT Project in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work GDELT Project owners hand off.

This MCP is built for professionals who need to monitor global narratives and public discourse in real time.

01
Journalists
They use the agent to track breaking stories and evolving media narratives.
02
Political Scientists
They use the agent to analyze geopolitical shifts and public discourse patterns.
03
PR Professionals
They use the agent to monitor brand reputation and manage crisis communications.
04
Policy Analysts
They use the agent to see how specific issues are covered across different nations.

FAQ

Questions GDELT Project owners ask.

01
Do I need an API key for GDELT?
No, GDELT is a free open platform, and this MCP handles the connection for you.
02
Which AI clients can use this MCP?
You can use this with any MCP-compatible client, including Claude, Cursor, and Windsurf.
03
Can I search for news in languages other than English?
Yes, the MCP supports searches across more than 100 different languages.
04
Does this include television news?
Yes, you can search transcripts from major networks like CNN, BBC, Fox News, and MSNBC.
05
How do I track sentiment changes?
You can use the tone timeline capabilities to see if coverage is trending positive or negative over a specific period.
06
Do I need an API key?
No. The GDELT API is completely free and requires no authentication or registration.
07
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.
08
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.

Explore

More in Data Analytics

Connect GDELT Project to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get geo data

Get themes

Get timeline lang

Get timeline tone

05-08

Get timeline volume

Get word cloud

Search articles

Search by country

09-12

Get tv channels

Get timeline country

Get tv timeline

Search tv

13-16

Search by language

Search by theme

Search nearby

Get tone chart

What teams actually run

Crisis Management

Geopolitical Research

Trend Spotting

Media Auditing

Building your own app? The connector is yours to use.

GDELT Project Connector

Claude Desktop

Journalists

Political Scientists

PR Professionals

Policy Analysts

Do I need an API key for GDELT?

Which AI clients can use this MCP?

Can I search for news in languages other than English?

Does this include television news?

How do I track sentiment changes?

Do I need an API key?

How often is GDELT updated?

Can I search TV news transcripts?

News AI Connector

Mediastack AI Connector

Currents AI Connector

Meltwater AI Connector

Suggestions

Newslit AI Connector

Mention AI Connector

NewsAPI AI Connector

WorldNewsAPI AI Connector