Skip to main content

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. These are direct named operations. The explicit legacy wrapper profile retains web_research_tool_list, web_research_tool_get and web_research_tool_call; it is not the current public surface. Prediction-market tools and the Alpha Vantage proxy are retired.

Economic data

Use the native macro_search_series, macro_get_series and macro_observations 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.

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.

extract_source_pages

Use Pattern

  1. Anchor the analysis in GDELT Cloud structured Events, Stories, and Entities.
  2. Use native macro series for supported FX, rates, commodity, or economic-indicator questions; use filings for reported company financials. Live equity quotes are unavailable.
  3. When useful, use web research for official language, corroboration, specialist sources, and source-article extraction.