Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use GDELT Project with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Analyze global news events and media coverage in real time with the world largest open dataset of human society.

Included with plan

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.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 16 capabilities

The complete GDELT Project capability set.

These are the exact actions your AI can choose when you ask it to work with GDELT Project.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 16 available through GDELT Project.

  1. 01

    Get geo data

    Each point includes coordinates, location name, and article metadata. Use modes: "PointData" for individual points, "PointHeat" for heatmap data. Get geographic point data for news events

  2. 02

    Get themes

    GDELT uses hundreds of themes from politics, economics, health, environment, technology, and more to classify news content. Get GDELT theme distribution for a topic

  3. 03

    Get timeline lang

    Reveals which linguistic communities are paying attention to an issue and when interest spreads across language barriers. Get language distribution timeline for a topic

  4. 04

    Get timeline tone

    Positive values indicate positive coverage, negative values indicate negative coverage. Essential for tracking public opinion shifts, crisis communications, and brand reputation monitoring. Get sentiment and tone timeline for a topic

Capability set02 / 04

05-08

4 capabilities in this set.

Part of 16 available through GDELT Project.

  1. 05

    Get timeline volume

    Essential for tracking media attention, identifying news spikes, and understanding the lifecycle of a story. Default timespan is 3 months. Get news volume timeline for any topic

  2. 06

    Get word cloud

    Reveals the dominant themes, entities, and concepts associated with a topic in media discourse. Get word cloud data showing key terms for a topic

  3. 07

    Search articles

    Returns article titles, URLs, dates, source domains, languages, and source countries. Use timespan like "1d" (1 day), "1w" (1 week), "3m" (3 months). Use sourcelang codes like "english", "spanish", "portuguese", "french", "chinese", "arabic". Use sourcecountry codes like "US", "BR", "UK", "FR", "DE". Search globalThis news articles across 100+ languages

  4. 08

    Search by country

    Country codes follow ISO 2-letter format: US (United States), BR (Brazil), UK (United Kingdom), FR (France), DE (Germany), CN (China), JP (Japan), IN (India), RU (Russia), AU (Australia), CA (Canada), etc. Essential for understanding country-specific media perspectives on globalThis events. Search news articles from a specific country

Capability set03 / 04

09-12

4 capabilities in this set.

Part of 16 available through GDELT Project.

  1. 09

    Get tv channels

    Use this to understand the scope of TV news coverage available for analysis. Get available TV news channels inventory

  2. 10

    Get timeline country

    Reveals geographic patterns in media attention, identifies when a story goes globalThis, and shows which nations are most interested in specific issues. Get source country distribution timeline

  3. 11

    Get tv timeline

    Reveals which stories dominate TV airtime and how TV coverage patterns differ from online news. Get TV news mention volume timeline

  4. 12

    Search tv

    Returns clips with timestamps, station names, transcript snippets, and video preview URLs. Covers CNN, Fox News, MSNBC, BBC, and more. Modes: "ClipGallery" for clips, "StationChart" for station comparison. Search TV news transcripts by keyword

Capability set04 / 04

13-16

4 capabilities in this set.

Part of 16 available through GDELT Project.

  1. 13

    Search by language

    Covers 100+ languages. Language codes include: english, spanish, portuguese, french, german, italian, chinese, japanese, korean, arabic, russian, hindi, turkish, dutch, swedish, polish, and many more. Essential for monitoring how different linguistic communities cover the same event. Search news articles in a specific language

  2. 14

    Search by theme

    Themes are standardized topic categories like TAX_FNCACT (financial actions), HEALTH_PANDEMIC, ENV_CLIMATECHANGE, TERROR, PROTEST, ELECTION, ECON_BANKRUPTCY, etc. Use this for precise topic-based monitoring. Search articles by GDELT standardized theme

  3. 15

    Search nearby

    More precise than simple keyword search. Use distance parameter to control proximity (default 10 words). Example: term1="climate", term2="migration", distance=15. Search articles where two terms appear near each other

  4. 16

    Get tone chart

    Shows whether coverage is predominantly positive, negative, or neutral, and the overall emotional intensity of the coverage. Get tone distribution chart for a topic

Observed, not estimated

1015ms average. Fast in production.

GDELT Project is checked daily against the live service.

Daily averagePeak 1227ms
Aug 20Today
Fastest day
859ms
Slowest day
1227ms
14-day trend
Slowing+14%

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.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 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

FAQ

Questions GDELT Project owners ask.

  • 01

    Do I need an API key?

    No. The GDELT API is completely free and requires no authentication or registration.

  • 02

    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.

  • 03

    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

Suggestions