vaaya / tools / gdelt / timeline

GDELT timeline for AI agents

News-volume or tone timeline for a query from GDELT

1¢ per call

npx @vaaya/mcp install

Parameters

ParamTypeWhat
query requiredstring
enddatetimestring
mode"timelinevol" | "timelinetone"
startdatetimestring
timespanstring

Call it

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

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

Or over HTTP with a Vaaya API key:

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

The facts

Call

gdelt/timeline

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

news →

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