Geopolitics — Global conflict, defense news & sentiment analysis

Tools / Geopolitics

Search Events

Search global news for geopolitical events. Monitors media in 100+ languages in real-time. Supports boolean queries, source country filtering, and time ranges. Powered by GDELT.

Returns: Articles with titles, URLs, sources, dates, languages, and source countries

Parameters

query *stringSearch terms (e.g. "Russia Ukraine", "defense spending", "NATO expansion"). Supports boolean: "term1 OR term2", sourcecountry:US, sourcelang:english

timespanstringTime range: "24hours", "7days", "1month", "3months", "6months", "1year"

source_countrystringFilter by source country FIPS code (e.g. "US", "UK", "CH" for China, "RS" for Russia)

max_resultsnumberMaximum articles to return (default: 20, max: 250)

Example

Russia-Ukraine conflict news

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "geopolitics",
  "skill": "search_events",
  "input": {
    "query": "Russia Ukraine military"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Trend Analysis

Track media coverage volume of a geopolitical topic over time. See if coverage is increasing, decreasing, or stable. Identifies peak coverage dates. Useful for monitoring escalation and de-escalation.

Returns: Coverage volume timeline with trend direction (increasing/decreasing/stable) and peak date

Parameters

query *stringTopic to track (same query syntax as search_events)

timespanstringTime range for the trend (e.g. "3months", "6months", "1year")

Example

Ukraine conflict coverage trend

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "geopolitics",
  "skill": "trend_analysis",
  "input": {
    "query": "Ukraine war"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Sentiment Analysis

Analyze global media sentiment around a geopolitical topic over time. Returns tone score (-10 very negative to +10 very positive), sentiment label, trend direction, and extremes.

Returns: Sentiment timeline with average tone, direction (improving/worsening/stable), and extremes

Parameters

query *stringTopic to analyze sentiment for

timespanstringTime range (e.g. "1month", "3months", "6months")

Example

Sentiment around China military

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "geopolitics",
  "skill": "sentiment_analysis",
  "input": {
    "query": "China military"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Get Context

Get article snippets and context passages about a geopolitical topic. Returns actual text excerpts from articles — useful for getting detailed context without reading full articles.

Returns: Articles with context text snippets, titles, URLs, sources, and dates

Parameters

query *stringTopic to get context for

max_resultsnumberMaximum articles to return (default: 10, max: 75)

Example

Context on Iran nuclear program

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "geopolitics",
  "skill": "get_context",
  "input": {
    "query": "Iran nuclear weapons"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"geopolitics","skill":"search_events","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Frequently Asked Questions

How do I search a conflict or country issue?

`search_events` finds GDELT coverage across 100+ languages and supports boolean queries, source-country filters, and time ranges.

Can I tell whether coverage is rising or cooling off?

`trend_analysis` shows whether coverage volume is increasing, decreasing, or stable, and points to peak dates.

Can I measure sentiment around a topic?

`sentiment_analysis` returns a tone score from -10 to +10, plus a label and trend direction.

Can I pull article snippets without reading full stories?

`get_context` returns snippets and quoted passages for a topic so you can inspect the wording quickly.