Documentation Index
Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt
Use this file to discover all available pages before exploring further.
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 / instrumentlatest_value and latest_dateseries: recent { label, date, value } points, usually daily observationsseries_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. |
series, probability_series, and series_observation_count. 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. |
| 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.
