# Geotone

> Geotone tracks the volume, tone, and geography of world news coverage — turning millions of articles into live geopolitical risk signals for people and AI agents. Derived-data publisher: we compute statistics ABOUT global news coverage (from the GDELT Project) and link to original reporting.

Data license: CC BY 4.0 — attribute "Geotone / GDELT". Updated every 2 hours.

## Key pages

- [Homepage / Wire](https://geotone.news/): ranked live wire — the world's most significant stories right now, clustered across outlets and threaded into story timelines
- [Timelines](https://geotone.news/timelines): developing multi-day stories, each threaded into a day-by-day timeline
- [Dashboard](https://geotone.news/dashboard): surge board (z-scores), top movers, tone extremes
- [Underreported](https://geotone.news/underreported): significant disasters vs measured coverage response — the attention gap, quantified
- [Topics](https://geotone.news/topics): geopolitical topic dashboards (conflicts, flashpoints, risk themes)
- [Countries](https://geotone.news/countries): 196 country dashboards (volume + tone of world coverage about each country, World Bank indicators, armed-conflict data, humanitarian reports)
- [Relations](https://geotone.news/relations): 50 bilateral co-coverage monitors (US-China, Russia-Ukraine, ...)
- [Entities](https://geotone.news/entities): 100+ leaders, organizations, and companies with daily mention counts
- [Briefings](https://geotone.news/briefings): daily data-driven global risk briefing (method disclosed per briefing)
- [Data](https://geotone.news/data): citable statistics roundups (rankings, tone tables, surge boards)
- [Alerts](https://geotone.news/alerts): free email alerts for coverage surges and developing stories
- [Methodology](https://geotone.news/methodology): exact formulas for every number
- [API docs](https://geotone.news/api-docs): free JSON API, no key required

## Machine access

- JSON API base: https://geotone.news/api/v1 — mirrors every dashboard; OpenAPI at https://geotone.news/api/openapi.json
- MCP server (streamable HTTP, no auth): https://geotone.news/mcp — tools: get_trending, get_wire, get_story_chain, get_topic, get_country, get_relation, search_topics, get_briefing
- Atom feeds: https://geotone.news/feeds/topics/{slug}.xml (daily data changes per topic), https://geotone.news/feeds/wire.xml (developing stories)
- Wire source authority list: https://geotone.news/wire/sources.json
- Full route list: https://geotone.news/llms-full.txt

## Citing Geotone

Cite figures as "Geotone / GDELT" with a link to the dashboard, e.g.:
"Coverage of the Ukraine war fell 12% week-over-week (Geotone, https://geotone.news/topics/ukraine-war)."
Every page opens with a summary sentence containing its current key numbers.