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

In a connected MCP client, pass the service, action, and inputs to use:

{
  "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}'

Service details

Call

gdelt/news

Price

1¢. Provider errors are not charged.

Category

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 →

Try this action.

Use the example above in your application, or connect an agent and describe the task. Charges appear in your Vaaya account.

npx @vaaya/mcp install