Overview
LangChain agents can connect to the GDELT Cloud MCP server throughlangchain-mcp-adapters. The MCP server exposes Progressive Discovery wrappers plus macro-finance, prediction-market, and web-research categories.
Installation
Complete Example
Expected Tool Behavior
The agent should use:gdelt_cloud_tool_listgdelt_cloud_tool_getgdelt_cloud_tool_call
gdelt_cloud_tool_call, it should call v2 tools such as summarize_events, search_events, search_stories, get_story, get_story_articles, search_entities, get_entity, and list_admin1.
It should also use:
macro_finance_*for market, commodity, FX, rates, and indicator contextprediction_market_*for market-implied probabilitiesweb_research_*for corroboration and official/source-page reading
Good Test Prompts
Best Practices
- Always include
gdelt_research_system_prompt. - Let the model inspect schemas before tool calls.
- Ask for concise output when building chat UX.
- Ask for a full brief only when the user wants a report.
- Preserve IDs, normalized geo, metrics, GDELT Cloud URLs, and article URLs in final answers.
Related
Progressive Discovery
How agents discover and call v2 GDELT Cloud tools.
External Tools
Macro finance, prediction markets, and web research.

