Skip to main content

Overview

LangChain agents can connect to the GDELT Cloud MCP server through langchain-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_list
  • gdelt_cloud_tool_get
  • gdelt_cloud_tool_call
Inside 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 context
  • prediction_market_* for market-implied probabilities
  • web_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.

Progressive Discovery

How agents discover and call v2 GDELT Cloud tools.

External Tools

Macro finance, prediction markets, and web research.