io.github.cyanheads/gdelt-mcp-server
v0.7.0Search and analyze global news coverage and US TV transcripts via the GDELT Project APIs.
Endpoint health
online- Last checked
- 11/20/2026, 9:18:01 AM
- Latency
- 263 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Fgdelt-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/gdelt-mcp-server": {
"url": "https://gdelt.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
11 shown · authentication unknown
Get GDELT Coverage Breakdown
gdelt_get_coverage_breakdown
Break down news coverage volume over time by source language or source country, returning a multi-series time series (one series per language or country). Shows which countries or languages drove early vs. late coverage — useful for tracing how a story propagated geographically or across language communities. Ranks every series by the sum of its values and returns limit of them per page (default 10, cap 75); when more remain it returns nextOffset — pass it back as offset with otherwise identical inputs for the next page. otherSeriesLabels names every series not on the page — pass any labels as the series input to get only those series, complete. Every series carries sum (its ranking key), pointCount, and peak; includePoints: false leaves out its data points for a lighter ranking. GDELT answers a timestep without matching coverage with 0 and leaves out a timestep its own data lacks; missingTimesteps counts those left out between the first and last returned. Each series whose name maps to one GDELT source code carries operator (sourcecountry:<FIPS> or sourcelang:<language>) — add it to a gdelt_search_articles or gdelt_get_coverage_timeline query to read that source's articles or volume. Values are normalized: each point is the topic's share of that source's media output, not an absolute article count, so values from different sources do not add up to a share. Small media markets with concentrated coverage therefore rank above large markets with diverse output — a high value means the topic dominated that source's coverage, not that it published the most articles. Use breakdownBy "country" with the signal-detection chain to map geographic attention, or "language" to detect non-English media surges.
Schema valid · SHA-256 2f4a0af7c47b…
View input schema
{ "type": "object", "properties": { "query": { "type": "string", "pattern": "\\S", "description": "Search query using GDELT syntax. Same operators as gdelt_search_articles: phrases, boolean OR, sourcecountry:, sourcelang:, domain:, theme: (GKG theme identifiers come from gdelt_search_themes)." }, "breakdownBy": { "type": "string", "enum": [ "language", "country" ], "description": "Breakdown dimension: \"language\" for source language time series, \"country\" for source country time series." }, "timespan": { "description": "Time window relative to now, a number followed by its unit, minimum \"15min\"; other examples: \"24h\", \"7d\", \"1m\". Ignored when startDatetime/endDatetime are set. Maximum 3 months.", "type": "string" }, "startDatetime": { "description": "Start datetime in GDELT format YYYYMMDDHHMMSS — exactly 14 digits, no separators (e.g. 20240101000000). Must pair with endDatetime; supplying only one of the two is rejected. The window may predate the last 3 months. The window must span at least 30 minutes, the shortest the GDELT DOC API accepts; a shorter one is answered from the server's local GKG mirror where one runs, and refused otherwise.", "type": "string", "pattern": "^\\d{14}$" }, "endDatetime": { "description": "End datetime in GDELT format YYYYMMDDHHMMSS — exactly 14 digits, no separators (e.g. 20240131235959). Must pair with startDatetime; supplying only one of the two is rejected. The window may predate the last 3 months. The window must span at least 30 minutes, the shortest the GDELT DOC API accepts; a shorter one is answered from the server's local GKG mirror where one runs, and refused otherwise.", "type": "string", "pattern": "^\\d{14}$" }, "smoothing": { "description": "Trailing moving-average width in timesteps (0–30; 0 or 1 leaves values unsmoothed). Width N needs N source steps, omitting leading steps without a full window and potentially shifting peaks later.", "type": "integer", "minimum": 0, "maximum": 30 }, "series": { "description": "Exact series labels to return instead of the ranked overview, e.g. [\"Portuguese Volume Intensity\", \"Vietnamese Volume Intensity\"]. Take them verbatim from otherSeriesLabels or topSeries[].label in a response, or from the label list an unknown_series error prints — labels, not operators, which go in query. Each one comes back complete under selectedSeries (its points left out only under includePoints: false), in the order requested (every series carrying it, when several do); a label that matches nothing is rejected rather than silently skipped. Omit to get the ranked overview.", "type": "array", "items": { "type": "string" } }, "includePoints": { "default": true, "description": "Whether each series carries its data points. false returns every series of topSeries or selectedSeries without data, keeping its label, operator, sum, pointCount, and peak; ranking, paging, otherSeriesLabels, and every other field are unchanged. Default true.", "type": "boolean" }, "limit": { "description": "Maximum series per page (default 10, cap 75). Larger counts clamp with limitClamp; strict deployments reject them.", "default": 10, "type": "number", "minimum": 1, "multipleOf": 1 }, "offset": { "default": 0, "description": "Zero-based series offset — into the ranked overview, or into the series named in series. Pass nextOffset from the preceding response, with otherwise identical inputs, to get the next page.", "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "query", "breakdownBy" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }
Connections
streamable-http
https://gdelt.caseyjhand.com/mcp