Server definition
- Hash
- sha256:c81298acd01b14766ad0f921367a3065567dea34cfde9f6a8e4a3d43ad805fbc
- What it is
- What a remote MCP server returned when asked what it offers: 8 tools
The blob, as servednamed by its sha256
{
"instructions": "Geotone provides live media-intelligence signals derived from GDELT: news coverage volume, tone, and surge z-scores for geopolitical topics and 196 countries, updated every 3 hours. Start with get_trending for what's surging now, get_wire for the ranked top stories (get_story_chain expands a story into its multi-day timeline), search_topics to find topic slugs, get_topic/get_country for daily series (30 days by default, response_format='detailed' for 90), get_briefing for the daily analytical briefing. Every result's meta carries a canonical page URL, an as-of date, and a ready-made citation. Data is CC BY 4.0 — cite \"Geotone / GDELT\" with a link to the referenced page.",
"tools": [
{
"description": "Geotone's daily global risk briefing for a date (YYYY-MM-DD): an analytical summary of coverage surges, tone shifts, and notable movers, with the statistics behind each claim.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"date": {
"description": "UTC date, e.g. 2026-07-02",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
}
},
"required": [
"date"
],
"type": "object"
},
"name": "get_briefing",
"outputSchema": {
"additionalProperties": true,
"properties": {
"bodyMarkdown": {
"type": "string"
},
"date": {
"type": "string"
},
"headline": {
"type": "string"
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"page": {
"type": "string"
}
},
"required": [
"date",
"headline",
"bodyMarkdown"
],
"type": "object"
}
},
{
"description": "Live media-coverage statistics for one country by ISO-3166 alpha-2 code (e.g. 'ua', 'cn'): daily series (latest 30 days by default; response_format='detailed' for 90) of coverage volume (share of world news coverage that is about that country) and tone, plus armed-conflict fatalities (UCDP, trailing 12 months), displacement stocks (UNHCR: IDPs, refugees, asylum seekers), and coverage origin (what share of coverage about the country is produced by its own outlets vs abroad).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"iso2": {
"description": "ISO2 code, e.g. 'ua'",
"maxLength": 2,
"minLength": 2,
"type": "string"
},
"response_format": {
"description": "concise (default): summary stats + the latest 30 days of the series. detailed: the full 90-day series and article sample (~3x the tokens).",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"iso2"
],
"type": "object"
},
"name": "get_country",
"outputSchema": {
"additionalProperties": true,
"properties": {
"activeTopics": {
"items": {
"additionalProperties": true,
"properties": {
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"conflict": {
"additionalProperties": true,
"description": "UCDP GED trailing-12-month organized-violence totals; recent months preliminary",
"properties": {
"civilianDeaths": {
"type": [
"number",
"null"
]
},
"events": {
"type": [
"number",
"null"
]
},
"fatalities": {
"type": [
"number",
"null"
]
},
"source": {
"type": "string"
},
"window": {
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"coverageOrigin": {
"additionalProperties": true,
"description": "Trailing-14d share of coverage about the country produced by domestic outlets (floor estimate)",
"properties": {
"knownSourceArticles14d": {
"type": [
"number",
"null"
]
},
"localSharePct": {
"type": [
"number",
"null"
]
},
"note": {
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"displacement": {
"additionalProperties": true,
"description": "UNHCR year-end displacement stocks",
"properties": {
"asylumSeekers": {
"type": [
"number",
"null"
]
},
"idps": {
"type": [
"number",
"null"
]
},
"refugeesAbroad": {
"type": [
"number",
"null"
]
},
"refugeesHosted": {
"type": [
"number",
"null"
]
},
"source": {
"type": "string"
},
"year": {
"type": [
"number",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"iso2": {
"type": "string"
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"name": {
"type": "string"
},
"page": {
"type": "string"
},
"snapshots": {
"items": {
"additionalProperties": true,
"properties": {
"date": {
"type": "string"
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"toneAvg": {
"type": [
"number",
"null"
]
},
"volIntensity": {
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"stats": {
"additionalProperties": true,
"properties": {
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"wowChangePct": {
"type": [
"number",
"null"
]
},
"zScore": {
"type": [
"number",
"null"
]
}
},
"type": "object"
}
},
"required": [
"iso2",
"name",
"snapshots"
],
"type": "object"
}
},
{
"description": "Bilateral co-coverage signal for a monitored country pair (e.g. a='cn', b='us'): how much the world's press mentions the two countries together, and in what tone. ~50 strategic pairs are monitored.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"a": {
"description": "First country ISO2",
"maxLength": 2,
"minLength": 2,
"type": "string"
},
"b": {
"description": "Second country ISO2",
"maxLength": 2,
"minLength": 2,
"type": "string"
},
"response_format": {
"description": "concise (default): summary stats + the latest 30 days of the series. detailed: the full 90-day series and article sample (~3x the tokens).",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"a",
"b"
],
"type": "object"
},
"name": "get_relation",
"outputSchema": {
"additionalProperties": true,
"properties": {
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"pair": {
"type": "string"
},
"snapshots": {
"items": {
"additionalProperties": true,
"properties": {
"coCoverageVol": {
"type": [
"number",
"null"
]
},
"date": {
"type": "string"
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"toneAvg": {
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"pair",
"snapshots"
],
"type": "object"
}
},
{
"description": "A story timeline: the threaded developments of one multi-day event chain, oldest first (e.g. attack → casualties confirmed → international reaction). Use the chain_id values returned by get_wire. Each development is a headline + link + outlet count + tone.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"chain_id": {
"description": "Chain id from get_wire",
"type": "number"
}
},
"required": [
"chain_id"
],
"type": "object"
},
"name": "get_story_chain",
"outputSchema": {
"additionalProperties": true,
"properties": {
"country": {
"type": [
"string",
"null"
]
},
"developments": {
"items": {
"additionalProperties": true,
"properties": {
"domain": {
"type": "string"
},
"firstSeen": {
"type": "string"
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"outlets": {
"type": "number"
},
"title": {
"type": "string"
},
"toneAvg": {
"type": "number"
},
"topic": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"firstSeen": {
"type": "string"
},
"id": {
"type": "number"
},
"lastDevelopment": {
"type": "string"
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"page": {
"type": "string"
}
},
"required": [
"id",
"developments"
],
"type": "object"
}
},
{
"description": "Live media-coverage statistics for one geopolitical topic (e.g. 'ukraine-war', 'taiwan-strait', 'sanctions'): daily volume and tone series, z-score, week-over-week change, and a sample of recent articles (headline+link only). Returns the latest 30 days by default; pass response_format='detailed' for the full 90. Use search_topics to find slugs.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"response_format": {
"description": "concise (default): summary stats + the latest 30 days of the series. detailed: the full 90-day series and article sample (~3x the tokens).",
"enum": [
"concise",
"detailed"
],
"type": "string"
},
"slug": {
"description": "Topic slug, e.g. 'ukraine-war'",
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_topic",
"outputSchema": {
"additionalProperties": true,
"properties": {
"articles": {
"items": {
"additionalProperties": true,
"properties": {
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"name": {
"type": "string"
},
"page": {
"type": "string"
},
"slug": {
"type": "string"
},
"snapshots": {
"items": {
"additionalProperties": true,
"properties": {
"date": {
"type": "string"
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"toneAvg": {
"type": [
"number",
"null"
]
},
"volIntensity": {
"type": [
"number",
"null"
]
},
"volRaw": {
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"stats": {
"additionalProperties": true,
"properties": {
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"wowChangePct": {
"type": [
"number",
"null"
]
},
"zScore": {
"type": [
"number",
"null"
]
}
},
"type": "object"
}
},
"required": [
"slug",
"name",
"snapshots"
],
"type": "object"
}
},
{
"description": "What's surging in global news right now: topics whose coverage is ≥2 standard deviations above their trailing average (z-score), the biggest week-over-week movers, and surging countries. Derived every 3 hours from GDELT across 65+ languages.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_trending",
"outputSchema": {
"additionalProperties": true,
"properties": {
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"movers": {
"items": {
"additionalProperties": true,
"properties": {
"latestVolIntensity": {
"type": [
"number",
"null"
]
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"wowChange": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"surging": {
"items": {
"additionalProperties": true,
"properties": {
"latestVolIntensity": {
"type": [
"number",
"null"
]
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"zScore": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"surgingCountries": {
"items": {
"additionalProperties": true,
"properties": {
"iso2": {
"type": "string"
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"name": {
"type": "string"
},
"zScore": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "The live wire: the world's most significant stories right now, ranked by a published formula (authority-weighted outlet breadth, boosted by consequence themes, coded events, and casualty figures, decayed by recency over 72h). Each story carries one representative link, outlet count, tone, countries, non-English source languages that also reported the event, and a chain_id when it belongs to a multi-day story timeline (fetch with get_story_chain). Reclustered every 3 hours.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Max stories to return (default 20)",
"maximum": 36,
"minimum": 1,
"type": "number"
}
},
"type": "object"
},
"name": "get_wire",
"outputSchema": {
"additionalProperties": true,
"properties": {
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"page": {
"type": "string"
},
"stories": {
"items": {
"additionalProperties": true,
"properties": {
"chainId": {
"type": [
"number",
"null"
]
},
"countries": {
"items": {
"type": "string"
},
"type": "array"
},
"domain": {
"type": "string"
},
"firstSeen": {
"type": "string"
},
"languages": {
"items": {
"type": "string"
},
"type": "array"
},
"lastSeen": {
"type": "string"
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"outlets": {
"type": "number"
},
"rank": {
"type": "number"
},
"related": {
"items": {
"additionalProperties": true,
"properties": {
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"outlets": {
"type": "number"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"timeline": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"toneAvg": {
"type": "number"
},
"topic": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"stories"
],
"type": "object"
}
},
{
"description": "Search Geotone's tracked geopolitical topics by keyword (matches name, slug, and description). Returns slugs usable with get_topic, plus each topic's current coverage stats.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"query": {
"description": "Keyword, e.g. 'nuclear' or 'china'",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_topics",
"outputSchema": {
"additionalProperties": true,
"properties": {
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"query": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": true,
"properties": {
"latestToneAvg": {
"type": [
"number",
"null"
]
},
"latestVolIntensity": {
"type": [
"number",
"null"
]
},
"meta": {
"properties": {
"asOf": {
"description": "Date of the latest datapoint (UTC)",
"type": "string"
},
"attribution": {
"type": "string"
},
"citation": {
"type": "string"
},
"license": {
"type": "string"
},
"page": {
"description": "Canonical geotone.news page for this result — link it when citing",
"type": "string"
},
"retrievedAt": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"name": {
"type": "string"
},
"page": {
"type": "string"
},
"slug": {
"type": "string"
},
"zScore": {
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"query",
"results"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c81298acd01b14766ad0f921367a3065567dea34cfde9f6a8e4a3d43ad805fbc | sha256sum