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

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

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

Service details

Call

gdelt/timeline

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

news →

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