External Enrichment Tools

Overview

The GDELT Cloud MCP server exposes non-GDELT Cloud categories as enrichment. Keep GDELT Cloud structured data central. Web research is optional initial orientation, corroboration, or source-page reading for a GDELT-supported task; it is not a standalone search service.

Category	Wrapper Tools	Use
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.

Economic data

Use the native macro_tool_list, macro_tool_get, and macro_tool_call tools for FRED/ALFRED series, including CPI, Treasury yields, policy rates, Brent, WTI, Henry Hub gas, and supported exchange rates. Inspect the series’ observation date, frequency, and vintage before comparing it with an event. Use the filings tools for supported reported company financials and the gdelt_cloud tools for company identity and news context. Live stock quotes, adjusted equity prices, options, and technical indicators are unavailable. Native macro observations are not substitutes for those capabilities.

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

Both operations require purpose (orientation, corroboration, or source_extraction) and a nonempty task_context describing the GDELT-supported task. Agents should use at most two searches and one extraction batch per task, stopping earlier when sufficient. This task budget is guidance; the depth and request-size limits are enforced before provider billing. Keep provider sources and extraction failures visible, and separate corroboration from GDELT evidence.

`SEARCH_WEB`

Parameter	Required	Description
`query`	yes	Web search query.
`search_depth`	no	`basic` only; other depths are rejected before provider billing.
`max_results`	no	Search results to return, 1–5; excessive requests are rejected before provider billing.
`time_range`	no	Recency window such as `day`, `week`, `month`, `year`, `7d`, or `30d`.

`EXTRACT_WEB_PAGES`

Parameter	Required	Description
`urls`	yes	1–3 relevant source URLs; excessive batches are rejected before provider billing.
`query`	no	Optional reranking query.
`extract_depth`	no	`basic` only.
`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 native macro series for supported FX, rates, commodity, or economic-indicator questions; use filings for reported company financials. Live equity quotes are unavailable.
Use prediction markets when the question involves odds, policy, elections, escalation, or whether a tradable market exists.
When useful, use web research for official language, corroboration, specialist sources, and source-article extraction.

​Overview

​Shared Wrapper Parameters

​Economic data

​Prediction Markets

​SEARCH_RELEVANT_MARKETS

​SEARCH_EVENTS

​SEARCH_MARKETS

​GET_MARKET

​Web Research

​SEARCH_WEB

​EXTRACT_WEB_PAGES

​Use Pattern