> ## 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. # External Enrichment Tools > Complete MCP parameter reference for macro finance, prediction markets, and web research ## 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 1. Anchor the analysis in GDELT Cloud structured Events, Stories, and Entities. 2. Use macro finance when there are price, FX, rates, commodity, or economic-indicator implications. 3. Use prediction markets when the question involves odds, policy, elections, escalation, or whether a tradable market exists. 4. Use web research for official language, corroboration, specialist sources, and source-article extraction.