---
summary: "Initial release — 9 tools for GDELT DOC and TV API search, timelines, tone analysis, and TV transcript coverage"
breaking: false
security: false
---

# 0.1.0 — 2026-05-25

## Added

- **`gdelt_search_articles`** — full-text search across the last 3 months of global news (65 languages, up to 250 results) with DOC API query syntax: phrases, boolean OR, `sourcecountry:`, `sourcelang:`, `domain:`, `theme:`, `tone<`/`tone>`, `near:`, `repeat:`
- **`gdelt_get_coverage_timeline`** — coverage volume and tone time series with three modes: `volume`, `volume_with_articles` (top articles per timestep), and `tone`
- **`gdelt_get_tone_distribution`** — tone histogram (~−30 to +30 bins) with `peakNegativeBin`, `peakPositiveBin`, and `neutralPct` summary fields
- **`gdelt_get_coverage_breakdown`** — multi-series coverage timeline broken down by source `language` or `country`; top 10 series plus aggregated "Other" bucket
- **`gdelt_search_tv`** — US TV transcript search (2009–Oct 2024, 150+ stations) with per-station normalized airtime time series
- **`gdelt_get_tv_clips`** — retrieves up to 3,000 TV clips with 15-second transcript excerpts and Internet Archive viewing links
- **`gdelt_get_tv_context`** — top 200 co-occurring words/phrases from TV clips matching a query, with relative frequency scores
- **`gdelt_get_tv_trending`** — zero-argument tool returning trending topics across national TV networks (updated every 15 minutes)
- **`gdelt_list_tv_stations`** — station metadata (market, network, date range, `isActive` flag) for verifying availability before querying
- **`GdeltDocService`** — wraps the DOC API (`/api/v2/doc/doc`); used by article search, timeline, tone, and breakdown tools
- **`GdeltTvService`** — wraps the TV API (`/api/v2/tv/tv`); used by TV search, clips, context, trending, and station list tools
- **`GdeltRateLimiter`** singleton — shared 1 req/5s queue across both services, enforcing GDELT's published rate limit
- `bunfig.toml` for Bun runtime configuration