vaaya / tools / gdelt / news

GDELT news for AI agents

Search the GDELT global news firehose (worldwide outlets, 65 languages, ~15-min latency).

1¢ per call

npx @vaaya/mcp install

Parameters

ParamTypeWhat
query requiredstring
enddatetimestring
maxrecordsinteger
sort"datedesc" | "dateasc" | "hybridrel" | "tonedesc" | "toneasc"
startdatetimestring
timespanstring

Call it

From any MCP client with Vaaya connected, one use call:

{
  "service": "gdelt",
  "action": "news",
  "params": {
    "query": "<query>"
  },
  "max_cost_cents": 1
}

Or over HTTP with a Vaaya API key:

curl -X POST https://vaaya.ai/api/run/gdelt/news \
  -H "Authorization: Bearer $VAAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<query>","max_cost_cents":1}'

The facts

Call

gdelt/news

Price

1¢. Charged only on success.

Pillar

Data · routed by vaaya/onefind

Provider

GDELT · gdeltproject.org

Settlement

Vaaya calls the provider with its own account and bills you the catalog price.

Credentials

Held server-side by Vaaya; your agent never receives a GDELT key.

More from GDELT

timeline →

Give your agents this call.

Connect Vaaya once, then describe the outcome or call it directly. Paid per call, from one balance.

npx @vaaya/mcp install