GDELT Cloud Docs — Global Event Data API & MCP

Overview

The GDELT Cloud MCP server exposes non-GDELT Cloud categories as enrichment. Use them after GDELT Cloud Events, Stories, or Entities establish the core signal.

Category	Wrapper Tools	Use
Macro finance	`macro_finance_tool_list`, `macro_finance_tool_get`, `macro_finance_tool_call`	Quotes, historical series, FX, commodities, rates, economic indicators, and symbol/search/catalog helpers.
Prediction markets	`prediction_market_tool_list`, `prediction_market_tool_get`, `prediction_market_tool_call`	Scenario markets, event pages, contract records, probabilities, status, and public market URLs when available.
Web research	`web_research_tool_list`, `web_research_tool_get`, `web_research_tool_call`	Search and extraction for official statements, specialist context, corroboration, and source-article reading.

Shared Wrapper Parameters

Wrapper	Parameter	Required	Description
`*_tool_list`	none	no	Lists available nested tools in that category.
`*_tool_get`	`tool_name`	conditional	Single nested tool name to inspect.
`*_tool_get`	`tool_names`	conditional	List of nested tool names to inspect together.
`*_tool_call`	`tool_name`	yes	Exact nested tool name to execute.
`*_tool_call`	`tool_arguments`	no	Object containing the selected nested tool’s parameters.

Macro Finance

Macro-finance nested tools are discovered dynamically through macro_finance_tool_list and macro_finance_tool_get. Use for:

equity and index quotes
historical price series
FX pairs
commodities
rates
economic indicators
provider symbol/search/catalog helpers when exposed

Provider symbols are not interchangeable across data vendors. Inspect the target schema first, then resolve provider-supported symbols through a search/catalog helper or web research. If a provider error returns retry guidance, change the lookup instead of retrying unchanged. When a selected macro-finance tool returns a recognizable historical payload, the wrapper normalizes it into top-level chart fields:

symbol / instrument
latest_value and latest_date
series: recent { label, date, value } points, usually daily observations
series_observation_count

Brief agents should prefer real provider series from these fields over synthetic two-point lines. Current quote fields are useful context, but they are not factual confirmation that a geopolitical or operational event caused the market move.

Prediction Markets

`SEARCH_RELEVANT_MARKETS`

Use when starting from a plain-language scenario and looking for likely matching contracts.

Parameter	Required	Description
`query`	yes	Signal, scenario, or event description to match against prediction markets.
`category`	no	Optional category filter.
`status`	no	Optional status filter. Default `open`.
`limit`	no	Candidate markets to return, 1-25. Default 10.
`include_history`	no	Attach recent daily probability history to top returned contracts when available. Default `true`.
`history_days`	no	Probability-history window, 2-30 days. Default 14.

`SEARCH_EVENTS`

Use for higher-level event pages that group related contracts.

Parameter	Required	Description
`search`	no	Free-text search string.
`category`	no	Optional event category filter.
`status`	no	Optional status filter.
`series_ticker`	no	Optional series ticker filter.
`limit`	no	Maximum events, 1-100. Default 10.
`with_nested_markets`	no	Include nested markets. Default `true`.

`SEARCH_MARKETS`

Use for direct contract search by text or known identifiers.

Parameter	Required	Description
`search`	no	Free-text search string.
`status`	no	Optional status filter.
`event_ticker`	no	Optional event ticker filter.
`series_ticker`	no	Optional series ticker filter.
`limit`	no	Maximum markets, 1-100. Default 10.
`include_history`	no	Attach recent daily probability history to top returned contracts when available. Default `true`.
`history_days`	no	Probability-history window, 2-30 days. Default 14.

`GET_MARKET`

Parameter	Required	Description
`ticker`	yes	Prediction-market ticker returned by a search tool.
`include_history`	no	Attach recent daily probability history when available. Default `true`.
`history_days`	no	Probability-history window, 2-30 days. Default 14.

Prediction-market records may include normalized probability_yes, probability_source, yes_bid, yes_ask, bid_ask_spread, volume, open_interest, liquidity, rules_primary, settlement_sources, series, probability_series, and series_observation_count. Read rules_primary before reporting a probability. Treat these as market-implied scenario context only; they can support a probability-context plot, but they never confirm that an event occurred.

Web Research

`SEARCH_WEB`

Parameter	Required	Description
`query`	yes	Web search query.
`search_depth`	no	`basic` or `advanced`. Defaults to `basic`.
`max_results`	no	Search results to return, 1-20. Wrapper normalizes provider fallback to a smaller safe value when needed.
`time_range`	no	Recency window such as `day`, `week`, `month`, `year`, `7d`, or `30d`.

`EXTRACT_WEB_PAGES`

Parameter	Required	Description
`urls`	yes	One or more URLs to extract.
`query`	no	Optional reranking query.
`extract_depth`	no	Extraction depth. Default `basic`.
`format`	no	Output format. Default `markdown`.
`include_images`	no	Include image URLs. Default `false`.
`include_favicon`	no	Include favicon URLs. Default `false`.

Use Pattern

Anchor the analysis in GDELT Cloud structured Events, Stories, and Entities.
Use macro finance when there are price, FX, rates, commodity, or economic-indicator implications.
Use prediction markets when the question involves odds, policy, elections, escalation, or whether a tradable market exists.
Use web research for official language, corroboration, specialist sources, and source-article extraction.

Overview

Tools

Resources

Skills

Prompts

Integrations

External Enrichment Tools

Overview

Shared Wrapper Parameters

Macro Finance

Prediction Markets

`SEARCH_RELEVANT_MARKETS`

`SEARCH_EVENTS`

`SEARCH_MARKETS`

`GET_MARKET`

Web Research

`SEARCH_WEB`

`EXTRACT_WEB_PAGES`

Use Pattern

​Overview

​Shared Wrapper Parameters

​Macro Finance

​Prediction Markets

​SEARCH_RELEVANT_MARKETS

​SEARCH_EVENTS

​SEARCH_MARKETS

​GET_MARKET

​Web Research

​SEARCH_WEB

​EXTRACT_WEB_PAGES

​Use Pattern

Overview

Shared Wrapper Parameters

Macro Finance

Prediction Markets

`SEARCH_RELEVANT_MARKETS`

`SEARCH_EVENTS`

`SEARCH_MARKETS`

`GET_MARKET`

Web Research

`SEARCH_WEB`

`EXTRACT_WEB_PAGES`

Use Pattern