Back to Browse

Gdelt MCP Server

Developer ToolsLow Risk8.2MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

GDELT MCP — Global Database of Events, Language, and Tone (free, no auth)

About

GDELT MCP — Global Database of Events, Language, and Tone (free, no auth)

Remote endpoints: streamable-http: https://gateway.pipeworx.io/gdelt/mcp

Security Report

8.2
Low Risk8.2Low Risk

This is a well-structured MCP server for querying the GDELT public news database API. The server requires no authentication (GDELT is free and public), implements proper input validation with constrained parameters, and safely constructs API requests without command injection risks. No hardcoded credentials, malicious patterns, or dangerous operations detected. Minor code quality observations around error handling do not materially impact security.

3 files analyzed · 3 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

@pipeworx/gdelt

GDELT 2.0 DOC API MCP — global news monitoring (100+ languages, 15-min refresh), no auth.

Part of Pipeworx — an MCP gateway connecting AI agents to 1394+ live data sources.

Tools

  • search_articles(query, timespan?, sort?, max_records?) — recent matching articles.
  • timeline_tone(query, timespan?) — daily average tone (-100..+100).
  • timeline_volume(query, timespan?) — daily article volume (% of news).

Data source

https://api.gdeltproject.org/api/v2/doc/doc — public, no key required.

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "gdelt": {
      "url": "https://gateway.pipeworx.io/gdelt/mcp"
    }
  }
}

Or connect to the full Pipeworx gateway for access to all 1394+ data sources:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Using with ask_pipeworx

Instead of calling tools directly, you can ask questions in plain English:

ask_pipeworx({ question: "your question about Gdelt data" })

The gateway picks the right tool and fills the arguments automatically.

More

License

MIT

Reviews

No reviews yet

Be the first to review this server!