@pipeworx/gdelt

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/gdelt’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 5

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

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).
• tone_distribution(query, timespan?) — sentiment histogram (bins + % negative/neutral/positive).
• gkg_summary(query, minutes?, max_records?) — top GDELT Global Knowledge Graph themes and entities (persons + organizations) co-occurring with a query, plus the tone distribution across the same articles, from GDELT’s most recent coding batch(es) (15–60 minutes back).

Data source

The GDELT Project’s DOC 2.0 API — public, no key required.

gkg_summary reads the GDELT Project’s Global Knowledge Graph (GKG) 2.1 dataset instead: there is no live query API for it any more (GDELT’s original GKG query API stopped returning data years ago), so this fetches and aggregates the same per-article theme/entity/tone records GDELT still publishes as a dataset file every 15 minutes, read fresh on every call rather than stored.

Tools

• search_articles — News coverage of a topic from ~100k sources in 65 languages, via GDELT.
• timeline_tone — Day-by-day AVERAGE NEWS SENTIMENT for a GDELT query over time. Returns datapoints with timestamp + tone value (-100 very negative .. +100 very positive, computed from GDELT’s sentiment scoring of ever
• timeline_volume — Day-by-day SHARE OF GLOBAL NEWS attention for a query — what % of all worldwide articles mentioned this topic each day. Returns datapoints with timestamp and intensity (% of total news volume). Use to
• tone_distribution — Sentiment DISTRIBUTION (histogram) of global news coverage for a GDELT query — how many articles fall at each tone level from very negative to very positive over the window. PREFER OVER WEB SEARCH for
• gkg_summary — Top GDELT Knowledge Graph themes, entities and tone for a topic, from the most recent coding batch(es).