| name | fetch-country-brief |
| version | 1 |
| description | Retrieve the current AI-generated strategic intelligence brief for a country, keyed by ISO 3166-1 alpha-2 code. |
fetch-country-brief
Use this skill when the user asks for a summary of the current geopolitical, economic, or security situation in a specific country. The endpoint returns a fresh AI-generated brief composed from the latest news, market, conflict, and infrastructure signals World Monitor tracks for that country.
Authentication
Server-to-server callers (agents, scripts, SDKs) MUST present an API key in the X-WorldMonitor-Key header. Authorization: Bearer … is for MCP/OAuth or Clerk JWTs — not raw API keys.
X-WorldMonitor-Key: wm_live_...
Browser requests from worldmonitor.app get a free pass via CORS Origin trust, but agents will never hit that path. Issue a key at https://www.worldmonitor.app/pro.
Endpoint
GET https://api.worldmonitor.app/api/intelligence/v1/get-country-intel-brief
Parameters
| Name | In | Required | Shape | Notes |
|---|
country_code | query | yes | ISO 3166-1 alpha-2, uppercase (e.g. US, IR, KE) | Case-sensitive server-side. Lowercase is rejected with 400. |
framework | query | no | free text, ≤ 2000 chars | Optional analytical framing appended to the system prompt (e.g. "focus on energy security"). |
Response shape
{
"countryCode": "IR",
"countryName": "Iran",
"brief": "Multi-paragraph AI-generated brief …",
"model": "gpt-4o-mini",
"generatedAt": 1745421600000
}
generatedAt is Unix epoch milliseconds. model identifies which LLM produced the text.
Worked example
curl -s -H "X-WorldMonitor-Key: $WM_API_KEY" \
'https://api.worldmonitor.app/api/intelligence/v1/get-country-intel-brief?country_code=IR' \
| jq -r '.brief'
With an analytical framework:
curl -s --get -H "X-WorldMonitor-Key: $WM_API_KEY" \
'https://api.worldmonitor.app/api/intelligence/v1/get-country-intel-brief' \
--data-urlencode 'country_code=TR' \
--data-urlencode 'framework=focus on energy corridors and Black Sea shipping'
Errors
400 — country_code missing, not 2 letters, or not uppercase.401 — missing X-WorldMonitor-Key (server-to-server callers).429 — rate limited; retry with backoff.5xx — transient upstream model failure; retry once after 2s.
When NOT to use
- For rankings or comparisons across countries, use
fetch-resilience-score per country and aggregate client-side, or call the GetResilienceRanking RPC directly.
- For raw news events rather than synthesized narrative, use
SearchGdeltDocuments (/api/intelligence/v1/search-gdelt-documents).
References
