Skip to main content

​
What Are Skills?

Skills are MCP resources that provide the GDELT Cloud research agent with domain-specific workflow guidance. Each skill defines how to approach a category of analytical task — what tools to use, in what order, how to interpret signals, how to structure outputs, and how to cite sources. Skills are served from the MCP server’s skills/ directory and are loaded by agents at runtime as resources. The agent reads the relevant skill at the start of a task to guide its reasoning and tool selection.
Skills complement the system prompt. The system prompt establishes analyst voice, citation standards, and adaptive output depth. A skill provides the domain-specific workflow for a particular task type.

​
Available Skills

General Task

Baseline approach for any GDELT Cloud query — tool selection, country codes, scan-zoom-enrich workflow

Geopolitical Strategic Analysis

Multi-actor analysis of strategic windows, opportunistic positioning, and diplomatic flanking

Financial & Sanctions Risk

Sanctions contagion, energy corridor stress, bypass node activity, and alliance cohesion signals

Supply Chain Risk

Three-layer supply chain risk: input materials, production concentration, and access controls

Location & Operational Risk

PM-ready location risk brief across labor, security, infrastructure, regulatory, and environmental dimensions

​
Skill Selection Logic

The agent selects a skill based on the user’s request:
User RequestSkill
General news research, entity tracking, conflict monitoringgeneral-task
What is Country X doing while Country Y is distracted?geopolitical-strategic-analysis
Sanctions regime effects, energy markets, bypass nodesfinancial-sanctions-risk
Export controls, supply chain disruption, circumventionsupply-chain-risk
Is City X safe for a new office? Location risk assessmentlocation-operational-risk
When no specialized skill matches, the agent falls back to general-task.

​
How Skills Are Loaded

Skills are served as MCP resources with URIs in the format skill://{name}. An agent loads a skill by reading the resource at the start of a relevant task. 
# Example: load a skill resource via FastMCP client
from fastmcp import Client
from fastmcp.client.auth import BearerAuth

async with Client(
    "https://gdelt-cloud-mcp.fastmcp.app/mcp",
    auth=BearerAuth(token=api_key)
) as client:
    # List available skills
    resources = await client.list_resources()
    skill_resources = [r for r in resources if str(r.uri).startswith("skill://")]
    
    # Load a specific skill
    skill = await client.read_resource("skill://geopolitical-strategic-analysis")
    print(skill[0].text)
For agents using the LangGraph or LangChain integration, skills are loaded automatically when the agent is initialized with the GDELT Cloud MCP server.