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 gives AI agents access to generated GDELT Cloud products through a Progressive Discovery interface:- structured Events: Conflict and CAMEO+
- clustered Stories with top article evidence
- Entities linked to Events and Stories
- admin1 geography discovery
- dashboard-ready summaries
- macro-finance, prediction-market, and web-research enrichment tools
MCP Server URL:
https://gdelt-cloud-mcp.fastmcp.app/mcpProgressive Discovery
Agents see wrapper tools first. They discover a category, inspect schemas, then execute a nested tool through*_tool_call.
For GDELT Cloud, agents use three wrapper tools:
| Tool | Purpose |
|---|---|
gdelt_cloud_tool_list | Discover the public v2 GDELT Cloud catalog. |
gdelt_cloud_tool_get | Inspect exact schemas, descriptions, enum values, and parameter guidance. |
gdelt_cloud_tool_call | Execute one v2 GDELT tool using nested tool_arguments. |
| Category | Wrapper Tools Agents See |
|---|---|
| Macro finance | macro_finance_tool_list, macro_finance_tool_get, macro_finance_tool_call |
| Prediction markets | prediction_market_tool_list, prediction_market_tool_get, prediction_market_tool_call |
| Web research | web_research_tool_list, web_research_tool_get, web_research_tool_call |
GDELT v2 Tool Catalog
| v2 Tool | Purpose |
|---|---|
search_events | Structured Conflict and CAMEO+ Event cards. |
summarize_events | Event rollups and trends for dashboards. |
get_event | Fetch a known Event by ID. |
search_stories | Clustered Stories with narrative and article evidence. |
summarize_stories | Story rollups and coverage trends. |
get_story | Fetch a known Story by ID. |
get_story_articles | Paginated source articles for a Story. |
search_entities | Discover linked people and organizations. |
get_entity | Fetch an Entity profile with linked Stories and Events. |
list_admin1 | Discover valid admin1 values for one country. |
Tool Selection
Use summaries for dashboards and trend detection. Use Events when the user needs structured incidents, actors, geo, fatalities, Goldstein scale, or CAMEO+ metrics. Use Stories when the user needs narrative evidence, article clusters, and source URLs. Use Entities when actors are the analytical object or when an Event/Story points to important people or organizations. Geography is documented as plain English country names. ISO-3 and legacy FIPS codes are accepted as aliases, but examples should lead with names such asUnited States, Lebanon, or South Korea.
External Categories
| Category | Use |
|---|---|
macro_finance_* | macro-finance provider-backed quotes, historical series, FX, commodities, rates, and economic indicators. |
prediction_market_* | Kalshi-backed market and event search, contract records, probabilities, status, and public URLs when available. |
web_research_* | Tavily-backed SEARCH_WEB and EXTRACT_WEB_PAGES for corroboration, official statements, specialist sources, and source-article reading. |
Skills And Prompt
The MCP server includes:gdelt_system_prompt: the canonical analyst/system prompt.- Task skills for general research, geopolitical strategy, financial/sanctions risk, supply-chain risk, and location operational risk.
Getting Started
Quickstart
Connect and make your first Progressive Discovery call.
GDELT v2 Tools
Learn the public v2 GDELT MCP catalog.
External Tools
Learn when to use macro finance, prediction markets, and web research.
Skills
Learn how agent task skills guide analyst workflows.