{"data":{"name":"io.github.cyanheads/gdelt-mcp-server","title":null,"description":"Search and analyze global news coverage and US TV transcripts via the GDELT Project APIs.","version":"0.7.0","websiteUrl":null,"repositoryUrl":"https://github.com/cyanheads/gdelt-mcp-server","remotes":[{"url":"https://gdelt.caseyjhand.com/mcp","type":"streamable-http"}],"packages":[{"version":"0.7.0","identifier":"@cyanheads/gdelt-mcp-server","runtimeHint":"stdio","registryType":"npm","runtimeArguments":null,"environmentVariables":null},{"version":"0.7.0","identifier":"@cyanheads/gdelt-mcp-server","runtimeHint":"streamable-http","registryType":"npm","runtimeArguments":null,"environmentVariables":null}],"status":"active","isLatest":true,"publishedAt":"2026-10-14T18:24:50.877Z","updatedAt":"2026-10-14T18:24:50.877Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":null,"source":"official-registry","sourceId":"io.github.cyanheads/gdelt-mcp-server","updatedAt":"2026-10-14T18:24:50.877Z","confidence":100,"websiteUrl":null,"description":"Search and analyze global news coverage and US TV transcripts via the GDELT Project APIs.","verification":"official","repositoryUrl":"https://github.com/cyanheads/gdelt-mcp-server"}],"toolIndex":{"tools":[{"serverName":"io.github.cyanheads/gdelt-mcp-server","endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","name":"gdelt_get_coverage_breakdown","title":"Get GDELT Coverage Breakdown","description":"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.","inputSchema":{"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},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"2f4a0af7c47bf8360ebcd7098bbc7edc7c31420d2bee6e24b4efc397c367c208","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:43.098Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/gdelt-mcp-server","endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","name":"gdelt_get_coverage_timeline","title":"Get GDELT Coverage Timeline","description":"Retrieve a time series showing when news coverage of a topic spiked, or how average tone shifted over time. Use mode \"volume\" for normalized coverage intensity (% of all global coverage per timestep). Use \"volume_raw\" for distinct matching-article counts per timestep and norm, the unsmoothed monitored-article denominator; smoothed counts are moving averages. Use mode \"volume_with_articles\" for the same signal plus the top articles that drove each spike — this is the primary signal-detection mode: a single call reveals both the spike and its cause, avoiding a follow-up gdelt_search_articles call. Use mode \"tone\" for average sentiment score per timestep (negative = hostile/fearful, positive = celebratory). Date resolution is the one GDELT reports, or else inferred from returned intervals: 15 minutes or hours for short windows, days for longer ones. 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. In volume_with_articles mode each timestep carries its first 3 article links and referenceCount, the number of references GDELT supplied (up to ten), not all matching articles; name timesteps' dates in points to get only those timesteps, each with its full supplied list. A response carries limit timesteps (default 10, cap 400); when more remain it returns nextOffset — pass it back as offset with otherwise identical inputs for the next page. Explicit startDatetime/endDatetime windows may predate the last 3 months in \"volume\" and \"tone\" modes; \"volume_raw\" and \"volume_with_articles\" cover only the last 3 months.","inputSchema":{"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), tone<."},"mode":{"default":"volume","description":"Timeline mode: \"volume\" returns normalized coverage % per timestep, \"volume_raw\" returns distinct matching-article counts (moving averages when smoothed) and the unsmoothed monitored denominator norm, \"volume_with_articles\" returns volume plus top articles per spike (best for signal detection), \"tone\" returns average sentiment score per timestep.","type":"string","enum":["volume","volume_raw","volume_with_articles","tone"]},"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. In \"volume\" and \"tone\" modes the window may predate the last 3 months; \"volume_raw\" and \"volume_with_articles\" cover only 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. In \"volume\" and \"tone\" modes the window may predate the last 3 months; \"volume_raw\" and \"volume_with_articles\" cover only 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},"points":{"description":"Timestep dates to return alone, e.g. [\"2024-01-05T12:00:00Z\"]. Take them verbatim from series[].data[].date in a prior response, or from the list an unknown_point error prints. The response then carries only these timesteps, in timeline order, and in volume_with_articles mode each carries its complete article list instead of the first 3. A date matching no timestep is rejected rather than silently ignored.","type":"array","items":{"type":"string"}},"limit":{"description":"Maximum timesteps per page (default 10, cap 400). Larger counts clamp with limitClamp; strict deployments reject them.","default":10,"type":"number","minimum":1,"multipleOf":1},"offset":{"default":0,"description":"Zero-based timestep offset — into the timeline, or into the timesteps named in points. Pass nextOffset from the preceding response, with otherwise identical inputs, to get the next page.","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["query"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"df339cdfada3598a2f7b9914e7cacda344bac6e7f5f8d7ebb715f0a17cb9ceea","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:43.098Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/gdelt-mcp-server","endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","name":"gdelt_get_tone_distribution","title":"Get GDELT Tone Distribution","description":"Get the tonal distribution of articles matching a query as a histogram (bins approximately -30 to +30). Unlike a single average tone score, the histogram reveals whether coverage is uniformly negative, bimodal (some articles extremely positive and some extremely negative), or clustered near neutral. Each bin carries its first 3 representative article links and referenceCount, how many GDELT returned; name bins in the bins input to get only those bins, each with every link. A response carries limit bins (default 10, cap 400); when more remain it returns nextOffset — pass it back as offset with otherwise identical inputs for the next page. Distinct from gdelt_get_coverage_timeline (mode: tone) — this is a snapshot distribution across all matching articles, not a time series. Use gdelt_get_coverage_timeline with mode \"tone\" to see how sentiment shifted over time.","inputSchema":{"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)."},"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}$"},"bins":{"description":"Tone bins to return alone, e.g. [-7, 4]. Take them from histogram[].bin in a prior response, or from the list an unknown_bin error prints. The response then carries only these bins, in histogram order, each with every representative article link instead of the first 3. A value matching no bin is rejected rather than silently ignored.","type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"limit":{"description":"Maximum bins per page (default 10, cap 400). Larger counts clamp with limitClamp; strict deployments reject them.","default":10,"type":"number","minimum":1,"multipleOf":1},"offset":{"default":0,"description":"Zero-based bin offset — into the histogram, or into the bins named in bins. Pass nextOffset from the preceding response, with otherwise identical inputs, to get the next page.","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["query"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"89d3d9692961bb9ced505496f8082b6c0f862d98ac1cdc38220812e58b992ec5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:43.098Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/gdelt-mcp-server","endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","name":"gdelt_get_tv_breakdown","title":"Get GDELT TV Breakdown","description":"Rank TV stations or shows mentioning a query. Station values are percentages of each station’s monitored airtime, or raw matching 15-second clip counts with normalize=false. Show values always represent percentages of matching clips, even with normalize=false. Labels are preserved exactly; ellipsized show labels may not work as exact show: selectors. Returns 25 rows by default, up to 10,000 per page. Archive coverage varies by station; use gdelt_list_tv_stations for station IDs, network and market selectors, and monitoring date ranges.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"TV transcript query. Supports phrases, Boolean OR, station:CNN, network:CBS, market:\"National\", show:\"Bloomberg Best\", and context:\"vaccine\"."},"stations":{"description":"Station IDs to select (e.g. [\"CNN\", \"FOXNEWS\"]) — the stationId values gdelt_list_tv_stations returns, not display labels such as \"FOX News\"; every supplied ID is forwarded. Alternatively select station:, network:, or quoted market: in query. A selector is required; obtain network and market values from gdelt_list_tv_stations.","type":"array","items":{"type":"string"}},"breakdownBy":{"type":"string","enum":["station","show"],"description":"Rank stations by their airtime share or matching clip count, or shows by percentage of matching clips."},"normalize":{"default":true,"description":"Station rankings: true returns station-airtime percentages; false returns matching 15-second clip counts. Show rankings always return matching-clip percentages.","type":"boolean"},"timespan":{"description":"Relative window counting back from now (a number and unit such as d, m, or y). Now is past the end of most stations' monitoring, so for archived periods set startDatetime/endDatetime inside a station's range from gdelt_list_tv_stations. Ignored when startDatetime/endDatetime are set.","type":"string"},"startDatetime":{"description":"UTC start in YYYYMMDDHHMMSS format. Must pair with a later endDatetime. Rankings count whole UTC periods at the resolution GDELT picks from the window length — clock hours up to 7 days, days under 3 years, months beyond — so GDELT widens the window outward to them; notice then names the window the values cover.","type":"string","pattern":"^\\d{14}$"},"endDatetime":{"description":"UTC end in YYYYMMDDHHMMSS format. Must pair with an earlier startDatetime. An end exactly on the clock hour counts as the second before it, so it adds no period starting there. Rankings count whole UTC periods at the resolution GDELT picks from the window length — clock hours up to 7 days, days under 3 years, months beyond — so GDELT widens the window outward to them; notice then names the window the values cover.","type":"string","pattern":"^\\d{14}$"},"limit":{"description":"Maximum ranking rows per page (default 25, cap 10,000). Larger counts clamp with limitClamp; strict deployments reject them.","default":25,"type":"number","minimum":1,"multipleOf":1},"offset":{"default":0,"description":"Zero-based row offset after descending-value and exact-label sorting. Use nextOffset with the same query inputs for the next page.","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["query","breakdownBy"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"c8dc3ba42cceb6776012ab9980d22ee47f7a6e56fcd42a71f0bdcc17a6062d23","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:43.098Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/gdelt-mcp-server","endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","name":"gdelt_get_tv_clips","title":"Get GDELT TV Clips","description":"Retrieve the top matching TV news clips for a query from the Internet Archive's Television News Archive: returns every fetched in-window clip, up to 3,000. Each clip includes show name, the station's display name — with its station ID when that name resolves to one — air timestamp, a 15-second transcript excerpt, and a direct link to view the full one-minute clip. Use after gdelt_search_tv to read the actual transcript content driving a coverage spike — pass a series' station value as stations here. GDELT answers a TV window in whole clock hours when it spans up to 7 days, whole UTC days when shorter than 3 years, and whole UTC months beyond, so clips it returns from outside an explicit startDatetime/endDatetime window are dropped — though they still spend maxRecords. 3,000 is a hard per-call ceiling and GDELT offers no cursor: when a query fills it, re-query narrower startDatetime/endDatetime windows — the response hands back the exact windows to use. Archive coverage varies by station; use gdelt_list_tv_stations for station IDs and monitoring date ranges.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Search query for TV transcript content. Same TV operators as gdelt_search_tv: station:CNN, network:CBS, market:\"National\", show:\"Anderson Cooper\", context:\"vaccine\"."},"stations":{"description":"Station IDs to filter to (e.g. [\"CNN\", \"FOXNEWS\"]) — the stationId values gdelt_list_tv_stations returns, not display labels such as \"FOX News\". Alternatively use station:, network:, or quoted market: selectors in query. A selector is required; use gdelt_list_tv_stations for networks, markets, and monitoring dates.","type":"array","items":{"type":"string"}},"timespan":{"description":"Relative window counting back from now (a number and unit such as d, m, or y). Now is past the end of most stations' monitoring, so for archived periods set startDatetime/endDatetime inside a station's range from gdelt_list_tv_stations. Ignored when startDatetime/endDatetime are set.","type":"string"},"startDatetime":{"description":"Start datetime in GDELT format YYYYMMDDHHMMSS — exactly 14 digits, no separators (e.g. 20200101000000). Must pair with endDatetime; supplying only one of the two is rejected.","type":"string","pattern":"^\\d{14}$"},"endDatetime":{"description":"End datetime in GDELT format YYYYMMDDHHMMSS — exactly 14 digits, no separators (e.g. 20200131235959). Must pair with startDatetime; supplying only one of the two is rejected.","type":"string","pattern":"^\\d{14}$"},"maxRecords":{"description":"Maximum number of clips to fetch. Defaults to 50; values above 3000 run at 3000 with a limitClamp disclosure unless clamping is disabled. Every fetched in-window record is returned. 3000 is GDELT's hard per-call ceiling, with no cursor; split a query that fills it into narrower startDatetime/endDatetime windows.","default":50,"type":"number","minimum":1,"multipleOf":1},"sort":{"default":"relevance","description":"Sort order: relevance (default), dateDesc (newest first), dateAsc (oldest first).","type":"string","enum":["relevance","dateDesc","dateAsc"]}},"required":["query"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"6d2b0dee5cbce8cfbefd3a7aac450efb3d81cc41b3d17d4934694bd64b8bfbf2","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:43.098Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/gdelt-mcp-server","endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","name":"gdelt_get_tv_context","title":"Get GDELT TV Context","description":"Get the top co-occurring words and phrases from TV news clips matching a query — the vocabulary framing a topic on television. Returns the most frequent non-stopword terms with relative frequency scores (0–100, where 100 = the query term itself). Terms and scores come from GDELT's relevance-ranked sample of matching clips, documented as the 200 most relevant, not all matching coverage — compare windows or stations with a separate, narrower call for each. Use to understand narrative framing, identify related concepts mentioned alongside a topic, or generate follow-up search terms. Returns 25 terms by default, with count pages up to 25,000 terms. Archive coverage varies by station; check gdelt_list_tv_stations for each station’s monitoring date range.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Search query for TV transcript content. Same TV operators as gdelt_search_tv: station:CNN, network:CBS, market:\"National\", show:\"Anderson Cooper\", context:\"vaccine\"."},"stations":{"description":"Station IDs to filter to (e.g. [\"CNN\", \"FOXNEWS\"]) — the stationId values gdelt_list_tv_stations returns, not display labels such as \"FOX News\". Alternatively use station:, network:, or quoted market: selectors in query; a selector is required. Obtain network and market values and per-station archive ranges from gdelt_list_tv_stations.","type":"array","items":{"type":"string"}},"limit":{"description":"Maximum score-sorted terms returned per page (default 25, cap 25,000). Larger counts clamp with limitClamp; strict deployments reject them.","default":25,"type":"number","minimum":1,"multipleOf":1},"offset":{"default":0,"description":"Zero-based term offset in descending score order, ties broken by exact label. Use nextOffset with the same query inputs for the next page.","type":"integer","minimum":0,"maximum":9007199254740991},"timespan":{"description":"Relative window counting back from now (a number and unit such as d, m, or y). Now is past the end of most stations' monitoring, so for archived periods set startDatetime/endDatetime inside a station's range from gdelt_list_tv_stations. Ignored when startDatetime/endDatetime are set.","type":"string"},"startDatetime":{"description":"Start datetime in GDELT format YYYYMMDDHHMMSS — exactly 14 digits, no separators (e.g. 20200101000000). Must pair with endDatetime; supplying only one of the two is rejected. Check station monitoring dates with gdelt_list_tv_stations. Terms and scores count whole UTC periods at the resolution GDELT picks from the window length — clock hours up to 7 days, days under 3 years, months beyond — so GDELT widens the window outward to them; notice then names the window the terms and scores cover.","type":"string","pattern":"^\\d{14}$"},"endDatetime":{"description":"End datetime in GDELT format YYYYMMDDHHMMSS — exactly 14 digits, no separators (e.g. 20200131235959). Must pair with startDatetime; supplying only one of the two is rejected. An end exactly on the clock hour counts as the second before it, so it adds no period starting there. Terms and scores count whole UTC periods at the resolution GDELT picks from the window length — clock hours up to 7 days, days under 3 years, months beyond — so GDELT widens the window outward to them; notice then names the window the terms and scores cover.","type":"string","pattern":"^\\d{14}$"}},"required":["query"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"613143f4569089627076ba3bc1cdefa12bbb47ced5b5719ae3a35c048b22b4bd","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:43.098Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/gdelt-mcp-server","endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","name":"gdelt_list_tv_stations","title":"List GDELT TV Stations","description":"List the television stations available for TV search with their market, network, monitoring start date, and monitoring end date — every station by default, or only those matching the optional stations, network, and market filters (each an exact, case-insensitive match; combined with AND). activeCount and totalCount count the returned stations. Stations with an end date within the last 24 hours are flagged as active; stations with earlier end dates are discontinued. Use before querying to verify a station was active during the target time period, or to discover valid station IDs for the stations parameter in other TV tools. Archive coverage varies by station; check each station’s monitoring date range. Use the returned network values with network: and market values with quoted market: selectors in TV queries.","inputSchema":{"type":"object","properties":{"stations":{"description":"Station IDs to return (e.g. [\"CNN\", \"FOXNEWS\", \"MSNBC\"]) — the IDs the stations parameter of the other TV tools takes. Matches any listed ID, exactly and case-insensitively after trimming; IDs that match no station are named in the notice. Blank entries are ignored; omit it or pass [] to include every station.","type":"array","items":{"type":"string"}},"network":{"description":"Network to narrow to (e.g. \"CNN\", \"ABC\"), matched as a whole value case-insensitively after trimming — \"FOX\" does not match \"FOXNEWS\". Values come from the network field of the unfiltered list. Blank is ignored.","type":"string"},"market":{"description":"Market to narrow to (e.g. \"National\", \"San Francisco\"), matched as a whole value case-insensitively after trimming — \"National\" does not match \"NationalSpecialty\". Values come from the market field of the unfiltered list. Blank is ignored.","type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"a5d966dd0e8d2b6264163fb6058b8a50f6e377657cb584ed5e609746ccb538e4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:43.098Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/gdelt-mcp-server","endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","name":"gdelt_search_articles","title":"Search GDELT Articles","description":"Search the last 3 months of global news coverage (65+ languages) using the GDELT DOC API. Fetches up to 250 articles with URL, title, source domain, language, country, the date GDELT saw each one, and social image URL, and returns every fetched article inside the requested window. Query supports full GDELT syntax: phrases (\"bird flu\"), boolean OR ((flu OR pandemic)), source country (sourcecountry:china), source language (sourcelang:spanish), domain (domain:who.int), GKG theme (theme:TAX_DISEASE_OUTBREAK — find identifiers with gdelt_search_themes), tone filter (tone<-5 for negative), proximity (near20:\"flu virus\"), and repeat (repeat3:\"outbreak\"). 250 is a hard per-call ceiling and GDELT offers no cursor: when a query fills it, re-query narrower startDatetime/endDatetime windows — the response hands back the exact windows to use. Note: this API covers only the most recent 3 months — use gdelt_search_tv for historical TV transcripts back to 2009.","inputSchema":{"type":"object","properties":{"query":{"type":"string","pattern":"\\S","description":"Search query. Supports GDELT operators: phrases (\"bird flu\"), boolean OR ((flu OR pandemic)), sourcecountry:china, sourcelang:spanish, domain:who.int, theme:TAX_DISEASE_OUTBREAK (GKG theme identifiers come from gdelt_search_themes), tone<-5, near20:\"flu virus\", repeat3:\"outbreak\"."},"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. Article search reaches back 3 months, the full DOC API window: a longer timespan is sent as given and runs on 3 months, disclosed in windowClamp. Defaults to the full 3-month window.","type":"string"},"startDatetime":{"description":"Start of date range in GDELT format YYYYMMDDHHMMSS — exactly 14 digits, no separators (e.g. 20240101000000). Must be supplied together with endDatetime; supplying only one of the two is rejected. 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 of date range in GDELT format YYYYMMDDHHMMSS — exactly 14 digits, no separators (e.g. 20240131235959). Must be supplied together with startDatetime; supplying only one of the two is rejected. 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}$"},"maxRecords":{"description":"Maximum number of articles to fetch. Defaults to 75; values above 250 run at 250 with a limitClamp disclosure unless clamping is disabled. Every fetched in-window record is returned. 250 is GDELT's hard per-call ceiling, with no cursor; split a query that fills it into narrower startDatetime/endDatetime windows.","default":75,"type":"number","minimum":1,"multipleOf":1},"sort":{"default":"relevance","description":"Sort order: relevance (default), dateDesc/dateAsc, toneDesc/toneAsc, or hybridRel (GDELT hybrid relevance and recency).","type":"string","enum":["relevance","dateDesc","dateAsc","toneDesc","toneAsc","hybridRel"]}},"required":["query"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"72de15d62a694eca93a0eefb7523c922a809376b9e1f53db8c6104af4f29919c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:43.098Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/gdelt-mcp-server","endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","name":"gdelt_search_sentences","title":"Search GDELT Sentences","description":"Search the sentences of the last 72 hours of English-language news coverage with the GDELT Context 2.0 API, to read what coverage actually said. Every query term must fall inside one sentence; each match returns that sentence, the text around it, and its article URL, title, domain, and seen date — one sentence per article. Matches come newest first (dateDesc) or oldest first (dateAsc); there is no relevance ranking. maxRecords counts matching sentences before GDELT keeps one per article, so pages run short, and a page that is not every match hands back continuationWindow, the startDatetime/endDatetime that reaches the next matches. GDELT reads window bounds only to the minute, so a page whose matches all fall in one minute cannot be continued inside it: raise maxRecords, and at its 200 ceiling continuationWindow skips past that minute. Query operators: phrases (\"bird flu\"), OR groups ((ukraine OR gaza) ceasefire), -term to exclude an exact word, near5:\"trump putin\", and repeat2:\"ukraine\"; quotesOnly keeps sentences holding a quotation mark. For the DOC-only filters (sourcecountry:, sourcelang:, theme:, tone), domain filtering, other languages, or coverage older than 72 hours, use gdelt_search_articles.","inputSchema":{"type":"object","properties":{"query":{"type":"string","pattern":"\\S","description":"Words and phrases that must all appear in one sentence. Supports phrases (\"bird flu\"), OR groups ((ukraine OR gaza) ceasefire), -term to exclude an exact word (-russia still matches \"Russian\"), near5:\"trump putin\" (words within about five words of each other), and repeat2:\"ukraine\" (a word at least twice). GDELT refuses the DOC-only operators sourcecountry:, sourcelang:, theme:, and tone here."},"timespan":{"description":"Window counting back from now: a whole number followed by min, h, hours, d, or days, in any case, from 31min to 72h (e.g. \"6h\", \"3days\"). A longer one runs as 72h with a windowClamp disclosure; a shorter one, or another unit such as w or m, is refused. Defaults to 72h. Ignored when startDatetime/endDatetime are set.","type":"string"},"startDatetime":{"description":"Start of an explicit window in GDELT format YYYYMMDDHHMMSS (UTC, exactly 14 digits). Must pair with endDatetime. A start older than 72 hours runs from 5 minutes inside the reach, disclosed in windowClamp. A window under 60 minutes goes upstream widened, and matches outside it are dropped.","type":"string","pattern":"^\\d{14}$"},"endDatetime":{"description":"End of an explicit window in GDELT format YYYYMMDDHHMMSS (UTC, exactly 14 digits). Must pair with startDatetime. A window ending before the last 72 hours is refused.","type":"string","pattern":"^\\d{14}$"},"maxRecords":{"description":"Matching sentences to request. Defaults to 25. GDELT counts sentences before keeping one per article, so a page usually holds fewer matches; follow continuationWindow for the rest. Values above 200 run at 200 with a limitClamp disclosure unless clamping is disabled.","default":25,"type":"number","minimum":1,"multipleOf":1},"sort":{"default":"dateDesc","description":"dateDesc (default) returns the newest matches first, dateAsc the oldest. The Context API has no relevance order.","type":"string","enum":["dateDesc","dateAsc"]},"quotesOnly":{"default":false,"description":"Keep only sentences holding a quotation mark. The sentence may hold only part of a longer quotation.","type":"boolean"}},"required":["query"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"d2852f9a4a5c71aee0097609e264bb483b04e778946d8dfd9a2d79637d9b326e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:43.098Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/gdelt-mcp-server","endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","name":"gdelt_search_themes","title":"Search GDELT GKG Themes","description":"Find GDELT Global Knowledge Graph (GKG) theme identifiers for the theme: operator that gdelt_search_articles, gdelt_get_coverage_timeline, gdelt_get_tone_distribution, and gdelt_get_coverage_breakdown accept in query. Searches the identifiers in the GDELT GKG theme lookup, which carries no labels or descriptions: every query word must begin one of the _-separated parts of an identifier or run across consecutive parts, or all the words joined must, so \"drought\" finds NATURAL_DISASTER_DROUGHT, \"cyberattack\" finds CYBER_ATTACK, \"plant disease\" finds TAX_PLANTDISEASE, and \"wb water\" narrows to World Bank water themes. There is no stemming or synonym matching — \"displacement\" does not reach DISPLACED — except one fallback: when nothing matches, the search retries once with a trailing s dropped from each word of four or more letters, and says so. Matches rank an exact identifier first, then by the count the lookup lists — a static prevalence figure, not a live article total — and each carries a paste-ready operator such as theme:TAX_DISEASE_OUTBREAK. Page with offset and limit (up to 100 matches per page; a larger limit runs at 100).","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Words to find in theme identifiers (e.g. \"drought\", \"cyber attack\", \"refugee\"), a family prefix with a word (\"wb water\", \"crisislex\"), or a whole identifier to confirm it is listed (\"TAX_DISEASE_OUTBREAK\"). Case-insensitive; a leading theme: is ignored; every word must match, or all the words joined must (\"plant disease\" matches TAX_PLANTDISEASE). Must contain at least one letter or digit."},"offset":{"default":0,"description":"Zero-based offset into the ranked matches. Use nextOffset from the preceding response with the same query to retrieve the next page.","type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"description":"Maximum matches returned in this response. Values above 100 run at 100 with a limitClamp disclosure when clamping is enabled.","default":25,"type":"number","minimum":1,"multipleOf":1}},"required":["query"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"0f1792556186ecd5ffc0a17db0904ed9659b28291c5392f35ef751b775cd48b1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:43.098Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/gdelt-mcp-server","endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","name":"gdelt_search_tv","title":"Search GDELT TV News","description":"Search television news closed captions for spoken mentions of a query. Returns a bounded, paged per-station time series showing airtime devoted to the topic — 500 points by default, up to 20,000 per page. Each series carries GDELT's display name for the station and, when that name resolves to one, the station ID gdelt_get_tv_clips takes as stations. Use stations to select station IDs (e.g. [\"CNN\", \"FOXNEWS\", \"MSNBC\"]), or select with station:, network:, or quoted market: operators in query. TV query also supports in-query operators: station:CNN, network:CBS, market:\"National\", show:\"Anderson Cooper 360\", context:\"vaccine\". Archive coverage varies by station; use gdelt_list_tv_stations for station IDs, network and market values, and monitoring date ranges.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Search query for TV transcript content. Supports TV operators: station:CNN, network:CBS, market:\"National\", show:\"Anderson Cooper\", context:\"vaccine\". Boolean OR and phrase operators also work."},"stations":{"description":"Station IDs to filter to (e.g. [\"CNN\", \"FOXNEWS\", \"MSNBC\"]) — the stationId values gdelt_list_tv_stations returns, not display labels such as \"FOX News\". Every supplied ID is forwarded. Alternatively use station:, network:, or quoted market: selectors in query; a selector is required. Obtain network and market values and per-station archive ranges from gdelt_list_tv_stations.","type":"array","items":{"type":"string"}},"timespan":{"description":"Relative window counting back from now (a number and unit such as d, m, or y). Now is past the end of most stations' monitoring, so for archived periods set startDatetime/endDatetime inside a station's range from gdelt_list_tv_stations. Ignored when startDatetime/endDatetime are set.","type":"string"},"startDatetime":{"description":"Start datetime in GDELT format YYYYMMDDHHMMSS — exactly 14 digits, no separators (e.g. 20200101000000). Must pair with endDatetime; supplying only one of the two is rejected. GDELT widens it back to the start of its UTC period at the response resolution; notice then names the window the values cover.","type":"string","pattern":"^\\d{14}$"},"endDatetime":{"description":"End datetime in GDELT format YYYYMMDDHHMMSS — exactly 14 digits, no separators (e.g. 20200131235959). Must pair with startDatetime; supplying only one of the two is rejected. GDELT extends it through the end of its UTC period at the response resolution — an end exactly on the clock hour counts as the second before it, so it adds no period starting there; notice then names the window the values cover.","type":"string","pattern":"^\\d{14}$"},"smoothing":{"description":"Trailing moving-average width in timesteps, 0–30 (0 or 1 = none). Width N needs N source steps; leading steps cannot produce averages and peaks may appear later.","type":"integer","minimum":0,"maximum":30},"normalize":{"default":true,"description":"When true (default), values are normalized as % of total airtime, enabling cross-station comparison. When false, returns raw matching 15-second clip counts.","type":"boolean"},"combined":{"default":false,"description":"Pool selected stations into one Combined timeline. Normalized values divide pooled matching clips by pooled monitored clips; false keeps separate station series.","type":"boolean"},"dateres":{"description":"Optional GDELT aggregation resolution. Omit to let GDELT choose from the window length — hourly up to 7 days, daily under 3 years, monthly beyond; the effective recognized or inferred resolution is returned as dateResolution. Each point counts one whole UTC period: a clock hour, day, Sunday–Saturday week, month, or year.","type":"string","enum":["hour","day","week","month","year"]},"offset":{"default":0,"description":"Zero-based point offset into the deterministic date-then-station-name ordering. Use nextOffset from the preceding response with the same query inputs to retrieve the next page.","type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"description":"Maximum timeline points returned per page (default 500, cap 20,000). Larger counts clamp with limitClamp; strict deployments reject them.","default":500,"type":"number","minimum":1,"multipleOf":1}},"required":["query"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"96db12af1a11ac8e337ffe66641f1f27ec401e8b879fb56febc43a003492f905","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:43.098Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"7c273fdfa930c1ed782d278a514fa92b965fd3eb544ccff58383e451729dec89","protocol":"streamable-http","status":"indexed","toolCount":11,"observedAt":"2026-11-19T07:46:43.098Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.cyanheads/gdelt-mcp-server":{"url":"https://gdelt.caseyjhand.com/mcp"}}},"Cursor":{"mcpServers":{"io.github.cyanheads/gdelt-mcp-server":{"url":"https://gdelt.caseyjhand.com/mcp"}}},"VS Code":{"servers":{"io.github.cyanheads/gdelt-mcp-server":{"type":"http","url":"https://gdelt.caseyjhand.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://gdelt.caseyjhand.com/mcp"},{"protocol":"mcp","package":"@cyanheads/gdelt-mcp-server","registryType":"npm","version":"0.7.0"},{"protocol":"mcp","package":"@cyanheads/gdelt-mcp-server","registryType":"npm","version":"0.7.0"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.cyanheads%2Fgdelt-mcp-server","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.cyanheads%2Fgdelt-mcp-server","name":"io.github.cyanheads/gdelt-mcp-server","description":"Search and analyze global news coverage and US TV transcripts via the GDELT Project APIs.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://gdelt.caseyjhand.com/mcp"},{"protocol":"mcp","package":"@cyanheads/gdelt-mcp-server","registryType":"npm","version":"0.7.0"},{"protocol":"mcp","package":"@cyanheads/gdelt-mcp-server","registryType":"npm","version":"0.7.0"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":null,"repositoryUrl":"https://github.com/cyanheads/gdelt-mcp-server","version":"0.7.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.cyanheads/gdelt-mcp-server","status":"online","lastCheckedAt":"2026-11-20T09:18:01.841Z","lastSuccessfulCheck":"2026-11-20T09:18:01.841Z","latencyMs":263,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T09:18:01.841Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T09:18:01.841Z"},"security":null,"timestamps":{"createdAt":"2026-10-14T18:24:50.877Z","updatedAt":"2026-10-14T18:24:50.877Z","observedAt":"2026-11-20T09:18:01.841Z"},"compatibility":{"serverVersion":"0.7.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}