Developer

Geopolitical Intelligence for AI Agents

March 22, 2026  ·  Global Perspectives

Most AI agents know a lot about code, language, and reasoning. They know very little about what is happening in the world right now.

If your agent needs to reason about current events — to brief a user, inform a decision, or understand a geopolitical context — it has to either ask the user, search the web unstructured, or hallucinate. None of those are good options.

Global Perspectives publishes structured, AI-analyzed geopolitical intelligence updated hourly. The data is available via a CLI package that any agent can call and pipe directly into its context.

Install

npm install -g global-perspectives

No account required. No API key for the free tier. Works immediately.

What an agent gets

Every command supports a --json flag that returns clean, structured JSON — no terminal formatting, no ANSI codes.

Today's global topics

gp today --json

Returns the current cycle of AI-clustered topics — updated hourly from 20+ international sources. Each topic includes:

• title — what the story is
• category — conflict, politics, economy, diplomacy, etc.
• regions — which countries and regions are involved
• summary — AI-generated key takeaways
• prediction — where this story is likely going next
• traceCause — root cause analysis: how we got here
• threadId — links this topic to prior coverage of the same story
• sources — named source articles the analysis is based on

// Sample shape of a topic object
{
  "title": "Ceasefire Talks Stall as Regional Powers Take Sides",
  "category": "conflict",
  "regions": ["Middle East", "Iran", "United States"],
  "summary": "Negotiations broke down after...",
  "prediction": "Escalation likely within 72 hours if...",
  "traceCause": "The underlying tension traces back to...",
  "threadId": "thread-mideast-ceasefire-a3f9",
  "sources": ["Al Jazeera", "Reuters", "SCMP"]
}

Country intelligence briefing

gp country "Iran" --json
gp country "Germany" --json

Returns a daily AI briefing for a specific country:

• headline — one-line situation summary
• situationSummary — what is happening across all active story threads
• crossThreadInsight — how different stories interact and compound
• trajectory — escalating / stable / de-escalating
• riskLevel — low / moderate / high / critical
• riskSignals — specific indicators worth watching

Active countries

gp countries --json

Returns the list of currently active countries ranked by coverage volume — useful for knowing which parts of the world the platform is tracking most closely right now.

Narrative thread

gp thread thread-mideast-ceasefire-a3f9 --json

Returns the full thread intelligence for a story arc:

• threadTitle — the name of the ongoing story
• storyArc — how the narrative has developed from origin to today
• trajectory — where the story is heading
• rootCauseChain — the structural forces that produced this situation
• watchQuestions — signals that will indicate how the story breaks
• entries — the individual topics that make up this thread, in chronological order

Example: wiring it into an agent

The simplest integration is a system prompt injection. Before your agent responds to any geopolitics-related query, pull current context:

import { execSync } from 'child_process';

function getGeopoliticalContext() {
  const raw = execSync('gp today --json', { encoding: 'utf8' });
  const topics = JSON.parse(raw);
  return topics.map(t => `
## ${t.title} [${t.category}]
Regions: ${t.regions.join(', ')}
Summary: ${t.summary}
Prediction: ${t.prediction}
Root cause: ${t.traceCause}
  `).join('\n---\n');
}

const systemPrompt = `
You are a geopolitical intelligence assistant.
Current world context (updated hourly):

${getGeopoliticalContext()}

Answer the user's question using this context where relevant.
`;

For country-specific queries, pull the briefing on demand:

function getCountryBriefing(country) {
  const raw = execSync(`gp country "${country}" --json`, { encoding: 'utf8' });
  return JSON.parse(raw);
}

// Returns: { headline, situationSummary, trajectory, riskLevel, riskSignals }
const briefing = getCountryBriefing('Germany');

What the data covers

Command	What it returns	Updated
gp today --json	~13 AI-clustered global topics with 3-layer analysis	Hourly
gp country <name> --json	Country situation briefing, trajectory, risk signals	Daily
gp countries --json	Active countries ranked by coverage volume	Hourly
gp thread <id> --json	Full narrative arc, root cause chain, watch questions	Daily

Sources span 20+ international outlets across 6 continents — Al Jazeera, SCMP, Dawn, Japan Times alongside Western wire services. The non-Western sourcing is deliberate: geopolitical blind spots are usually geographic.