unesco-heritage-mcp-server
An MCP server that allows agents to search and retrieve detailed records for UNESCO World Heritage sites, intangible heritage elements, biosphere reserves, and Global Geoparks. It supports filtering by keyword, country, category, region, criteria, and danger status, and provides full record details including coordinates and descriptions.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://unesco-heritage.caseyjhand.com/mcpWhat its tools do
9 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search World Heritage sites by keyword, country, or category
- Fetch full records for specific heritage sites or reserves
- Check the List of World Heritage in Danger
- Find sites near a specific geographic point
Source and maintenance
Community listingRegistry 0.3.0
- Maintenance checked
Protocol and capabilities
- Server
- unesco-heritage-mcp-server 0.3.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 9 advertised
- Resources
- 1 advertised
- Resource templates
- 5 advertised
- Prompts
- 0 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"logging": {},
"prompts": {
"listChanged": true
},
"resources": {
"subscribe": true,
"listChanged": true
},
"extensions": {
"io.modelcontextprotocol/skills": {
"directoryRead": true
}
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
9 advertised
unesco_search_sites — Search World Heritage sites
Advertised read-onlyOpen-world
Search the UNESCO World Heritage List by keyword, country, category (Cultural, Natural, Mixed), region, inscription criteria (i)–(x), inscription year range, Danger-list status, transboundary status, or distance from a point. Every keyword must appear at the start of a word in a site's name (any of six languages), component names, description, or statement of Outstanding Universal Value; name matches rank first, then component matches, which list the components that matched. A country is an ISO 3166-1 alpha-2 or alpha-3 code and matches every site it shares, transboundary sites included. Set in_danger to true for the List of World Heritage in Danger; the data records the year of each site's current Danger-list entry but no threat factors. Criterion (vi) is inferred from each site's statement of Outstanding Universal Value and marked as inferred. Results page with next_cursor and carry facet counts over the whole match.
unesco_search_sites input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"near": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the point, in decimal degrees (−90 to 90)."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the point, in decimal degrees (−180 to 180)."
},
"radius_km": {
"type": "number",
"default": 100,
"maximum": 5000,
"description": "Search radius in kilometres (up to 5000, default 100).",
"exclusiveMinimum": 0
}
},
"description": "Only sites within radius_km of this point: a site matches when its representative point or any of its components lies within the radius, and a site with neither never matches. The match and the distance sort use the exact distance to the nearest of those points, which distance_km shows rounded to 0.1 km and never above radius_km.",
"additionalProperties": false
},
"sort": {
"enum": [
"relevance",
"name",
"inscribed_newest",
"inscribed_oldest",
"area_largest",
"danger_listed_newest",
"distance"
],
"type": "string",
"description": "Result order. Default: relevance when query is set, else distance when near is set, else name. relevance needs query; distance needs near. Absent areas and Danger years sort last."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"description": "Maximum results per page (default 20). A page holds at most 50: a larger limit, up to 10000, is served as 50 and notice says so."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Keywords; every word must match the start of a word in a site's name (any of six languages), component names, description, or statement of Outstanding Universal Value. Case, accents, and punctuation are ignored, so the query must contain at least one letter or digit and at most 16 distinct words; no phrases, operators, or fuzzy matching."
},
"cursor": {
"type": "string",
"maxLength": 1024,
"description": "Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page."
},
"region": {
"enum": [
"Africa",
"Arab States",
"Asia and the Pacific",
"Europe and North America",
"Latin America and the Caribbean"
],
"type": "string",
"description": "UNESCO region: Africa, Arab States, Asia and the Pacific, Europe and North America, or Latin America and the Caribbean (codes AFR, ARB, APA, EUR, LAC accepted)."
},
"country": {
"type": "string",
"maxLength": 64,
"description": "ISO 3166-1 alpha-2 or alpha-3 code, any case (FR, FRA). Matches every site the country takes part in, transboundary sites included. For a country name, look up its code with unesco_list_reference (topic countries)."
},
"category": {
"enum": [
"Cultural",
"Natural",
"Mixed"
],
"type": "string",
"description": "Site category: Cultural, Natural, or Mixed."
},
"criteria": {
"type": "array",
"items": {
"enum": [
"i",
"ii",
"iii",
"iv",
"v",
"vi",
"vii",
"viii",
"ix",
"x"
],
"type": "string",
"description": "A criterion numeral i–x; 1–10 and (iv)-style forms are accepted."
},
"maxItems": 10,
"description": "Inscription criteria a site must all carry. (i) A masterpiece of human creative genius. (ii) An important interchange of human values over time or within a cultural area, in architecture, technology, monumental arts, town planning, or landscape design. (iii) A unique or exceptional testimony to a cultural tradition or a civilization, living or vanished. (iv) An outstanding example of a type of building, architectural or technological ensemble, or landscape illustrating significant stages in human history. (v) An outstanding example of traditional human settlement, land use, or sea use representative of a culture or of human interaction with the environment, especially where vulnerable to irreversible change. (vi) Direct association with events, living traditions, ideas, beliefs, or artistic and literary works of outstanding universal significance. (vii) Superlative natural phenomena, or areas of exceptional natural beauty and aesthetic importance. (viii) An outstanding example of a major stage of Earth's history, including the record of life, significant ongoing geological processes, or significant landforms. (ix) An outstanding example of significant ongoing ecological and biological processes in the evolution of ecosystems and communities of plants and animals. (x) The most important natural habitats for in-situ conservation of biological diversity, including those holding threatened species of outstanding universal value. Criterion (vi) is inferred from the statement of Outstanding Universal Value, since UNESCO's criteria fields omit it."
},
"in_danger": {
"type": "boolean",
"description": "true: only sites on the List of World Heritage in Danger. false: only sites not on it. Omit for both."
},
"inscribed_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Latest inscription year, inclusive."
},
"transboundary": {
"type": "boolean",
"description": "true: only sites shared by more than one State Party. false: only single-State sites."
},
"inscribed_from": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Earliest inscription year, inclusive."
},
"include_description": {
"type": "boolean",
"default": true,
"description": "Set false to leave each row's description out of the response (default true); unesco_get_site returns it. Which sites match, their order, matched_in, and matched_components are unchanged."
}
},
"additionalProperties": false
}unesco_search_sites output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"sites",
"sources",
"totalCount",
"truncated",
"shown",
"cap",
"applied_filters",
"facets"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "number",
"description": "The page size applied: limit, or the per-call cap of 50 when limit was larger."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unknown_country",
"invalid_year_range",
"sort_needs_input",
"cursor_mismatch",
"invalid_cursor",
"snapshot_unavailable"
],
"description": "Machine-readable failure mode. Declared by this tool: `unknown_country`: country is not a recognized ISO 3166-1 alpha-2 or alpha-3 code, such as a country name or an unassigned code. `invalid_year_range`: inscribed_from is later than inscribed_to. `sort_needs_input`: sort relevance without query, or sort distance without near. `cursor_mismatch`: cursor was issued for different filters or sort, or for an earlier data snapshot. `invalid_cursor`: cursor is malformed, or its offset is not a non-negative whole number or its limit not a positive one. `snapshot_unavailable`: No World Heritage snapshot has loaded yet: the Data Hub is unreachable, failing, or rate-limiting (retryable), or it rejected the request or served data this server cannot use (not retryable). Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "number",
"description": "Number of results on this page."
},
"sites": {
"type": "array",
"items": {
"type": "object",
"required": [
"id_no",
"name",
"category",
"states",
"country_codes",
"region",
"transboundary",
"inscribed_year",
"criteria",
"in_danger"
],
"properties": {
"name": {
"type": "string",
"description": "English name."
},
"id_no": {
"type": "string",
"description": "World Heritage id_no; pass to unesco_get_site for the full record."
},
"region": {
"enum": [
"Africa",
"Arab States",
"Asia and the Pacific",
"Europe and North America",
"Latin America and the Caribbean"
],
"type": "string",
"description": "UNESCO region."
},
"states": {
"type": "array",
"items": {
"type": "string",
"description": "State Party name."
},
"description": "States Parties as UNESCO names them."
},
"category": {
"enum": [
"Cultural",
"Natural",
"Mixed"
],
"type": "string",
"description": "Cultural, Natural, or Mixed."
},
"criteria": {
"type": "array",
"items": {
"enum": [
"i",
"ii",
"iii",
"iv",
"v",
"vi",
"vii",
"viii",
"ix",
"x"
],
"type": "string",
"description": "Criterion numeral."
},
"description": "Inscription criteria (recorded plus inferred), in numeral order."
},
"latitude": {
"type": "number",
"description": "Representative point latitude, when recorded."
},
"in_danger": {
"type": "boolean",
"description": "True when on the List of World Heritage in Danger."
},
"longitude": {
"type": "number",
"description": "Representative point longitude, when recorded."
},
"matched_in": {
"enum": [
"name",
"component",
"description",
"justification"
],
"type": "string",
"description": "The first field tier by which every query word had matched, in rank order: name (the site's names), component (its component names), description, then justification (the statement of Outstanding Universal Value). Present when query is set."
},
"description": {
"type": "string",
"description": "UNESCO's short description, when recorded; omitted from every row when include_description is false."
},
"distance_km": {
"type": "number",
"description": "Distance in km from the near point to the nearest of the site's representative point and its components, rounded to 0.1 km and never above radius_km (present when near is set)."
},
"area_hectares": {
"type": "number",
"description": "Area in hectares, when recorded."
},
"country_codes": {
"type": "array",
"items": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code."
},
"description": "ISO 3166-1 alpha-2 codes aligned with states; empty for the one site without a code."
},
"transboundary": {
"type": "boolean",
"description": "True when the site spans more than one State Party."
},
"inscribed_year": {
"type": "number",
"description": "Year of inscription."
},
"criteria_inferred": {
"type": "array",
"items": {
"enum": [
"i",
"ii",
"iii",
"iv",
"v",
"vi",
"vii",
"viii",
"ix",
"x"
],
"type": "string",
"description": "Criterion numeral."
},
"description": "The subset of criteria inferred from the statement of Outstanding Universal Value (in practice vi); present only when non-empty."
},
"nearest_component": {
"type": "object",
"required": [
"ref",
"latitude",
"longitude"
],
"properties": {
"ref": {
"type": "string",
"description": "Component reference."
},
"name": {
"type": "string",
"description": "Component name; absent when UNESCO lists none."
},
"latitude": {
"type": "number",
"description": "Component point latitude."
},
"longitude": {
"type": "number",
"description": "Component point longitude."
}
},
"description": "The component distance_km is measured to; present when near is set and a component is strictly nearer than the representative point before rounding (an exact tie keeps the representative point), or the site has no representative point.",
"additionalProperties": false
},
"danger_listed_year": {
"type": "number",
"description": "Year of the current Danger-list entry, when in danger."
},
"matched_components": {
"type": "array",
"items": {
"type": "object",
"required": [
"ref",
"name",
"latitude",
"longitude"
],
"properties": {
"ref": {
"type": "string",
"description": "Component reference."
},
"name": {
"type": "string",
"description": "Component name."
},
"latitude": {
"type": "number",
"description": "Component point latitude."
},
"longitude": {
"type": "number",
"description": "Component point longitude."
}
},
"description": "One component whose name matched.",
"additionalProperties": false
},
"description": "The components whose names match a query word the site's own names lack, those matching more such words first, then in UNESCO order; at most 10. Present when such a word first matched in the component tier, whatever matched_in is."
},
"matched_components_total": {
"type": "number",
"description": "How many components match, listed or not; present with matched_components. unesco_get_site lists every component of the site."
}
},
"description": "One World Heritage site.",
"additionalProperties": false
},
"description": "Matching sites on this page."
},
"facets": {
"type": "object",
"required": [
"category",
"region",
"in_danger",
"criteria",
"top_countries"
],
"properties": {
"region": {
"type": "object",
"description": "Matching sites per region.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"category": {
"type": "object",
"description": "Matching sites per category.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"criteria": {
"type": "object",
"description": "Matching sites per criterion; the vi count is inferred.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"in_danger": {
"type": "object",
"required": [
"true",
"false"
],
"properties": {
"true": {
"type": "number",
"description": "Matching sites in danger."
},
"false": {
"type": "number",
"description": "Matching sites not in danger."
}
},
"description": "Matching sites by Danger-list status.",
"additionalProperties": false
},
"top_countries": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"count"
],
"properties": {
"code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code; absent for the State-Party entry without one."
},
"name": {
"type": "string",
"description": "Country name."
},
"count": {
"type": "number",
"description": "Matching sites listing the country."
}
},
"description": "One country count.",
"additionalProperties": false
},
"description": "Top 10 countries by matching-site count, ties by code with the code-less State-Party entry last; a transboundary site counts once for each of its countries."
}
},
"description": "Facet counts over the whole match, not just this page.",
"additionalProperties": false
},
"notice": {
"type": "string",
"description": "Guidance on the result: why nothing matched, caveats, or how to continue paging."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"dataset",
"title",
"data_as_of",
"license",
"attribution"
],
"properties": {
"title": {
"type": "string",
"description": "Dataset title."
},
"dataset": {
"enum": [
"whc001",
"ich001",
"mab001"
],
"type": "string",
"description": "UNESCO Data Hub dataset id."
},
"license": {
"type": "string",
"description": "Dataset license from the dataset metadata ('CC BY-SA 4.0')."
},
"data_as_of": {
"type": "string",
"description": "Dataset's data_processed timestamp (ISO 8601) from the loaded snapshot."
},
"attribution": {
"type": "string",
"description": "Credit line to reproduce with the data."
}
},
"description": "One source dataset.",
"additionalProperties": false
},
"description": "Datasets this response was built from."
},
"truncated": {
"type": "boolean",
"description": "True when more results remain beyond this page."
},
"totalCount": {
"type": "number",
"description": "Total matches across all pages."
},
"next_cursor": {
"type": "string",
"description": "Pass as cursor, with the same filters and sort, to fetch the next page. Present when more results remain."
},
"applied_filters": {
"type": "object",
"required": [
"sort",
"limit",
"include_description"
],
"properties": {
"near": {
"type": "object",
"required": [
"latitude",
"longitude",
"radius_km"
],
"properties": {
"latitude": {
"type": "number",
"description": "Latitude."
},
"longitude": {
"type": "number",
"description": "Longitude."
},
"radius_km": {
"type": "number",
"description": "Radius in km."
}
},
"description": "Distance filter.",
"additionalProperties": false
},
"sort": {
"enum": [
"relevance",
"name",
"inscribed_newest",
"inscribed_oldest",
"area_largest",
"danger_listed_newest",
"distance"
],
"type": "string",
"description": "The sort applied (resolved default when none was given)."
},
"limit": {
"type": "number",
"description": "Page size applied: limit, or 50 when limit was larger."
},
"query": {
"type": "string",
"description": "Keyword query as given."
},
"region": {
"enum": [
"Africa",
"Arab States",
"Asia and the Pacific",
"Europe and North America",
"Latin America and the Caribbean"
],
"type": "string",
"description": "Region filter."
},
"country": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code the country input resolved to."
},
"name": {
"type": "string",
"description": "Country name."
}
},
"description": "Resolved country.",
"additionalProperties": false
},
"category": {
"enum": [
"Cultural",
"Natural",
"Mixed"
],
"type": "string",
"description": "Category filter."
},
"criteria": {
"type": "array",
"items": {
"enum": [
"i",
"ii",
"iii",
"iv",
"v",
"vi",
"vii",
"viii",
"ix",
"x"
],
"type": "string",
"description": "Criterion numeral."
},
"description": "Required criteria."
},
"in_danger": {
"type": "boolean",
"description": "Danger-list filter."
},
"inscribed_to": {
"type": "number",
"description": "Latest inscription year."
},
"transboundary": {
"type": "boolean",
"description": "Transboundary filter."
},
"inscribed_from": {
"type": "number",
"description": "Earliest inscription year."
},
"include_description": {
"type": "boolean",
"description": "Whether rows carry their description."
}
},
"description": "The filters and sort as the server applied them.",
"additionalProperties": false
},
"descriptions_omitted": {
"type": "boolean",
"const": true,
"description": "Present when include_description is false: no row carries its description, which unesco_get_site returns."
}
},
"additionalProperties": false
}unesco_search_sites annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}unesco_get_site — Get World Heritage site
Advertised read-onlyOpen-world
Fetch one World Heritage site's full record by id_no: its description, statement of Outstanding Universal Value, each inscription criterion with its meaning (criterion (vi) marked as inferred), States Parties, coordinates, area, inscription and later years, Danger-list year, component parts, names in six languages, and the main image with its copyright credit. description_language returns UNESCO's French, Spanish, Russian, Arabic, or Chinese description instead of the English one. Intangible heritage UNESCO links to the site is listed by unesco_search_intangible_heritage with world_heritage_site.
unesco_get_site input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id_no"
],
"properties": {
"id_no": {
"type": "string",
"pattern": "^[1-9]\\d{0,4}$",
"description": "The site's World Heritage id_no, from unesco_search_sites. A number, a digit string, or the site's whc.unesco.org/en/list/{id} page URL."
},
"max_components": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 0,
"description": "Maximum component parts to list (default 20). One call lists at most 1000: a larger value, up to 10000, is served as 1000 and notice says so. 0 omits the list but keeps components_total; the largest site has 758 components."
},
"description_language": {
"enum": [
"en",
"fr",
"es",
"ru",
"ar",
"zh"
],
"type": "string",
"description": "Language of the description UNESCO publishes for the site: en, fr, es, ru, ar, or zh, in any case. Unset returns the English description. When UNESCO publishes none in that language, the English one is returned with description_language en, and notice says so. The statement of Outstanding Universal Value is English only."
}
},
"additionalProperties": false
}unesco_get_site output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"id_no",
"name",
"names",
"category",
"states",
"country_codes",
"region",
"transboundary",
"inscribed_year",
"secondary_years",
"criteria",
"in_danger",
"components",
"components_total",
"components_unparsed",
"url",
"sources",
"truncated",
"shown",
"cap"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "number",
"description": "The max_components applied: the request, or the per-call cap of 1000 when it was larger."
},
"url": {
"type": "string",
"description": "The site's UNESCO page URL."
},
"name": {
"type": "string",
"description": "English name."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"site_not_found",
"snapshot_unavailable"
],
"description": "Machine-readable failure mode. Declared by this tool: `site_not_found`: No record carries this id_no. `snapshot_unavailable`: No World Heritage snapshot has loaded yet: the Data Hub is unreachable, failing, or rate-limiting (retryable), or it rejected the request or served data this server cannot use (not retryable). Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"id_no": {
"type": "string",
"description": "World Heritage id_no."
},
"image": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Main image URL (opens in a browser; not fetched by this server)."
},
"author": {
"type": "string",
"description": "Photographer, when recorded."
},
"copyright": {
"type": "string",
"description": "Copyright holder, when recorded."
}
},
"description": "Main image with its credit, when UNESCO lists one.",
"additionalProperties": false
},
"names": {
"type": "object",
"properties": {
"ar": {
"type": "string",
"description": "Arabic name."
},
"es": {
"type": "string",
"description": "Spanish name."
},
"fr": {
"type": "string",
"description": "French name."
},
"ru": {
"type": "string",
"description": "Russian name."
},
"zh": {
"type": "string",
"description": "Chinese name."
}
},
"description": "Names in the other UNESCO languages, each present when UNESCO records it.",
"additionalProperties": false
},
"shown": {
"type": "number",
"description": "Components listed."
},
"notice": {
"type": "string",
"description": "That max_components was above the per-call cap, that the description is not in the requested description_language, how to list more components, or why some are missing."
},
"region": {
"enum": [
"Africa",
"Arab States",
"Asia and the Pacific",
"Europe and North America",
"Latin America and the Caribbean"
],
"type": "string",
"description": "UNESCO region."
},
"states": {
"type": "array",
"items": {
"type": "string",
"description": "State Party name."
},
"description": "States Parties as UNESCO names them."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"dataset",
"title",
"data_as_of",
"license",
"attribution"
],
"properties": {
"title": {
"type": "string",
"description": "Dataset title."
},
"dataset": {
"enum": [
"whc001",
"ich001",
"mab001"
],
"type": "string",
"description": "UNESCO Data Hub dataset id."
},
"license": {
"type": "string",
"description": "Dataset license from the dataset metadata ('CC BY-SA 4.0')."
},
"data_as_of": {
"type": "string",
"description": "Dataset's data_processed timestamp (ISO 8601) from the loaded snapshot."
},
"attribution": {
"type": "string",
"description": "Credit line to reproduce with the data."
}
},
"description": "One source dataset.",
"additionalProperties": false
},
"description": "Datasets this response was built from."
},
"category": {
"enum": [
"Cultural",
"Natural",
"Mixed"
],
"type": "string",
"description": "Cultural, Natural, or Mixed."
},
"criteria": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"meaning",
"source"
],
"properties": {
"code": {
"enum": [
"i",
"ii",
"iii",
"iv",
"v",
"vi",
"vii",
"viii",
"ix",
"x"
],
"type": "string",
"description": "Criterion numeral."
},
"source": {
"enum": [
"recorded",
"inferred"
],
"type": "string",
"description": "recorded: from UNESCO's criteria field. inferred: named by the statement of Outstanding Universal Value (criterion (vi), which UNESCO's criteria fields omit)."
},
"meaning": {
"type": "string",
"description": "The criterion's meaning, paraphrased from UNESCO's Operational Guidelines."
}
},
"description": "One inscription criterion.",
"additionalProperties": false
},
"description": "Inscription criteria in numeral order."
},
"latitude": {
"type": "number",
"description": "Representative point latitude, when recorded."
},
"in_danger": {
"type": "boolean",
"description": "True when the site is on the List of World Heritage in Danger."
},
"longitude": {
"type": "number",
"description": "Representative point longitude, when recorded."
},
"truncated": {
"type": "boolean",
"description": "True when the list stops at cap with more readable components left."
},
"components": {
"type": "array",
"items": {
"type": "object",
"required": [
"ref",
"latitude",
"longitude"
],
"properties": {
"ref": {
"type": "string",
"description": "Component reference."
},
"name": {
"type": "string",
"description": "Component name; absent when UNESCO lists none."
},
"latitude": {
"type": "number",
"description": "Component point latitude."
},
"longitude": {
"type": "number",
"description": "Component point longitude."
}
},
"description": "One component part.",
"additionalProperties": false
},
"description": "Component parts in UNESCO order, up to max_components."
},
"description": {
"type": "string",
"description": "UNESCO's short description, when recorded: in English, or in the language description_language names."
},
"area_hectares": {
"type": "number",
"description": "Area in hectares, when recorded."
},
"country_codes": {
"type": "array",
"items": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code."
},
"description": "ISO 3166-1 alpha-2 codes aligned with states; empty for the one site without a code."
},
"justification": {
"type": "string",
"description": "The statement of Outstanding Universal Value, in English (UNESCO publishes no translation), when recorded."
},
"transboundary": {
"type": "boolean",
"description": "True when the site spans more than one State Party."
},
"inscribed_year": {
"type": "number",
"description": "Year of inscription."
},
"secondary_years": {
"type": "array",
"items": {
"type": "number",
"description": "Year."
},
"description": "Later years UNESCO's secondary dates list for the site after inscription; empty when none."
},
"components_total": {
"type": "number",
"description": "UNESCO's component count for the site."
},
"danger_listed_year": {
"type": "number",
"description": "Year of the site's current Danger-list entry, when in danger."
},
"components_unparsed": {
"type": "number",
"description": "Entries of UNESCO's component list that could not be read and are omitted; 0 normally."
},
"description_language": {
"enum": [
"en",
"fr",
"es",
"ru",
"ar",
"zh"
],
"type": "string",
"description": "Language of description, present when the description_language input was set and a description is returned: the requested language, or en when UNESCO publishes no description in it."
}
},
"additionalProperties": false
}unesco_get_site annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}unesco_search_intangible_heritage — Search intangible heritage
Advertised read-onlyOpen-world
Search UNESCO's Intangible Cultural Heritage lists — the Representative List, the Urgent Safeguarding List, and the Register of Good Safeguarding Practices — by keyword, country, list, inscription year range, multinational status, or linked World Heritage site. Every keyword must appear at the start of a word in an element's English or French name, its UNESCO concept terms, or its description, and name matches rank first. A country is an ISO 3166-1 alpha-2 or alpha-3 code and matches every element it shares, multinational elements included. world_heritage_site takes a site's id_no and lists the elements UNESCO links to it. Rows omit the description; read it with unesco_get_intangible_heritage_element. Results page with next_cursor and carry facet counts over the whole match.
unesco_search_intangible_heritage input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"list": {
"enum": [
"Representative List",
"Urgent Safeguarding List",
"Register of Good Safeguarding Practices"
],
"type": "string",
"description": "Intangible heritage list: Representative List, Urgent Safeguarding List, or Register of Good Safeguarding Practices (acronyms RL, USL, Art18 accepted)."
},
"sort": {
"enum": [
"relevance",
"name",
"inscribed_newest",
"inscribed_oldest"
],
"type": "string",
"description": "Result order. Default: relevance when query is set, else name. relevance needs query."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"description": "Maximum results per page (default 20). A page holds at most 50: a larger limit, up to 10000, is served as 50 and notice says so."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Keywords; every word must match the start of a word in an element's English or French name, its UNESCO concept terms, or its description. Case, accents, and punctuation are ignored, so the query must contain at least one letter or digit and at most 16 distinct words; no phrases, operators, or fuzzy matching."
},
"cursor": {
"type": "string",
"maxLength": 1024,
"description": "Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page."
},
"country": {
"type": "string",
"maxLength": 64,
"description": "ISO 3166-1 alpha-2 or alpha-3 code, any case (FR, FRA). Matches every element the country shares, multinational elements included. For a country name, look up its code with unesco_list_reference (topic countries)."
},
"inscribed_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Latest inscription year, inclusive."
},
"multinational": {
"type": "boolean",
"description": "true: only elements shared by more than one country. false: only single-country elements."
},
"inscribed_from": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Earliest inscription year, inclusive."
},
"world_heritage_site": {
"type": "string",
"pattern": "^[1-9]\\d{0,4}$",
"description": "A World Heritage site's id_no (from unesco_search_sites or unesco_get_site); lists the elements UNESCO links to that site. A number, a digit string, or the site's whc.unesco.org/en/list/{id} page URL."
}
},
"additionalProperties": false
}unesco_search_intangible_heritage output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"elements",
"sources",
"totalCount",
"truncated",
"shown",
"cap",
"applied_filters",
"facets"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "number",
"description": "The page size applied: limit, or the per-call cap of 50 when limit was larger."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unknown_country",
"invalid_year_range",
"sort_needs_input",
"cursor_mismatch",
"invalid_cursor",
"snapshot_unavailable"
],
"description": "Machine-readable failure mode. Declared by this tool: `unknown_country`: country is not a recognized ISO 3166-1 alpha-2 or alpha-3 code, such as a country name or an unassigned code. `invalid_year_range`: inscribed_from is later than inscribed_to. `sort_needs_input`: sort relevance without query. `cursor_mismatch`: cursor was issued for different filters or sort, or for an earlier data snapshot. `invalid_cursor`: cursor is malformed, or its offset is not a non-negative whole number or its limit not a positive one. `snapshot_unavailable`: No intangible heritage snapshot has loaded yet: the Data Hub is unreachable, failing, or rate-limiting (retryable), or it rejected the request or served data this server cannot use (not retryable). Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "number",
"description": "Number of results on this page."
},
"facets": {
"type": "object",
"required": [
"list",
"multinational",
"top_countries",
"top_concepts"
],
"properties": {
"list": {
"type": "object",
"description": "Matching elements per list.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"top_concepts": {
"type": "array",
"items": {
"type": "object",
"required": [
"term",
"count"
],
"properties": {
"term": {
"type": "string",
"description": "Primary concept term."
},
"count": {
"type": "number",
"description": "Matching elements carrying the term."
}
},
"description": "One concept count.",
"additionalProperties": false
},
"description": "Top 10 primary concept terms across the match."
},
"multinational": {
"type": "object",
"required": [
"true",
"false"
],
"properties": {
"true": {
"type": "number",
"description": "Matching elements shared by more than one country."
},
"false": {
"type": "number",
"description": "Matching single-country elements."
}
},
"description": "Matching elements by multinational status.",
"additionalProperties": false
},
"top_countries": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name",
"count"
],
"properties": {
"code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code."
},
"name": {
"type": "string",
"description": "Country name."
},
"count": {
"type": "number",
"description": "Matching elements the country shares."
}
},
"description": "One country count.",
"additionalProperties": false
},
"description": "Top 10 countries; a multinational element counts once for each of its countries."
}
},
"description": "Facet counts over the whole match, not just this page.",
"additionalProperties": false
},
"notice": {
"type": "string",
"description": "Guidance on the result: why nothing matched, caveats, or how to continue paging."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"dataset",
"title",
"data_as_of",
"license",
"attribution"
],
"properties": {
"title": {
"type": "string",
"description": "Dataset title."
},
"dataset": {
"enum": [
"whc001",
"ich001",
"mab001"
],
"type": "string",
"description": "UNESCO Data Hub dataset id."
},
"license": {
"type": "string",
"description": "Dataset license from the dataset metadata ('CC BY-SA 4.0')."
},
"data_as_of": {
"type": "string",
"description": "Dataset's data_processed timestamp (ISO 8601) from the loaded snapshot."
},
"attribution": {
"type": "string",
"description": "Credit line to reproduce with the data."
}
},
"description": "One source dataset.",
"additionalProperties": false
},
"description": "Datasets this response was built from."
},
"elements": {
"type": "array",
"items": {
"type": "object",
"required": [
"ich_ref",
"name",
"list",
"country_codes",
"countries",
"multinational",
"inscribed_year",
"concepts",
"world_heritage_sites"
],
"properties": {
"list": {
"enum": [
"Representative List",
"Urgent Safeguarding List",
"Register of Good Safeguarding Practices"
],
"type": "string",
"description": "The list the element is inscribed on."
},
"name": {
"type": "string",
"description": "English name."
},
"ich_ref": {
"type": "string",
"description": "Intangible heritage element reference; pass to unesco_get_intangible_heritage_element for the full record."
},
"concepts": {
"type": "array",
"items": {
"type": "string",
"description": "Concept term."
},
"description": "Every primary UNESCO concept term the element carries; empty when none are recorded. The concepts match tier also covers the secondary terms, which unesco_get_intangible_heritage_element returns."
},
"countries": {
"type": "array",
"items": {
"type": "string",
"description": "Country name."
},
"description": "Country display names aligned with country_codes."
},
"matched_in": {
"enum": [
"name",
"concepts",
"description"
],
"type": "string",
"description": "The first field tier by which every query word had matched (present when query is set)."
},
"country_codes": {
"type": "array",
"items": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code."
},
"description": "ISO 3166-1 alpha-2 codes of the countries sharing the element."
},
"multinational": {
"type": "boolean",
"description": "True when more than one country shares the element."
},
"inscribed_year": {
"type": "number",
"description": "Inscription year."
},
"world_heritage_sites": {
"type": "array",
"items": {
"type": "object",
"required": [
"id_no",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Site name as the element record carries it."
},
"id_no": {
"type": "string",
"description": "World Heritage id_no; pass to unesco_get_site."
}
},
"description": "One linked World Heritage site.",
"additionalProperties": false
},
"description": "World Heritage sites UNESCO links to the element; empty when none are linked."
}
},
"description": "One intangible heritage element (description omitted; fetch it with the get tool).",
"additionalProperties": false
},
"description": "Matching elements on this page."
},
"truncated": {
"type": "boolean",
"description": "True when more results remain beyond this page."
},
"totalCount": {
"type": "number",
"description": "Total matches across all pages."
},
"next_cursor": {
"type": "string",
"description": "Pass as cursor, with the same filters and sort, to fetch the next page. Present when more results remain."
},
"applied_filters": {
"type": "object",
"required": [
"sort",
"limit"
],
"properties": {
"list": {
"enum": [
"Representative List",
"Urgent Safeguarding List",
"Register of Good Safeguarding Practices"
],
"type": "string",
"description": "List filter."
},
"sort": {
"enum": [
"relevance",
"name",
"inscribed_newest",
"inscribed_oldest"
],
"type": "string",
"description": "The sort applied (resolved default when none was given)."
},
"limit": {
"type": "number",
"description": "Page size applied: limit, or 50 when limit was larger."
},
"query": {
"type": "string",
"description": "Keyword query as given."
},
"country": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code the country input resolved to."
},
"name": {
"type": "string",
"description": "Country name."
}
},
"description": "Resolved country.",
"additionalProperties": false
},
"inscribed_to": {
"type": "number",
"description": "Latest inscription year."
},
"multinational": {
"type": "boolean",
"description": "Multinational filter."
},
"inscribed_from": {
"type": "number",
"description": "Earliest inscription year."
},
"world_heritage_site": {
"type": "string",
"description": "Linked World Heritage id_no filter."
}
},
"description": "The filters and sort as the server applied them.",
"additionalProperties": false
}
},
"additionalProperties": false
}unesco_search_intangible_heritage annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}unesco_get_intangible_heritage_element — Get intangible heritage element
Advertised read-onlyOpen-world
Fetch one Intangible Cultural Heritage element's full record by ich_ref: its description, the list it is inscribed on, the countries that share it, its inscription year, UNESCO concept terms, the World Heritage sites UNESCO links to it, its UNESCO page, and the main image with its caption and copyright credit. description_language fr returns UNESCO's French description instead of the English one.
unesco_get_intangible_heritage_element input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ich_ref"
],
"properties": {
"ich_ref": {
"type": "string",
"pattern": "^[1-9]\\d{0,4}$",
"description": "The element's ich_ref, from unesco_search_intangible_heritage. A number, a digit string, or the element's ich.unesco.org/en/{RL|USL|Art18}/{ref} page URL."
},
"description_language": {
"enum": [
"en",
"fr"
],
"type": "string",
"description": "Language of the description UNESCO publishes for the element: en or fr, in any case; UNESCO publishes element descriptions in no other language. Unset returns the English description. When UNESCO publishes none in French, the English one is returned with description_language en, and notice says so."
}
},
"additionalProperties": false
}unesco_get_intangible_heritage_element output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"ich_ref",
"name",
"name_fr",
"list",
"country_codes",
"countries",
"multinational",
"inscribed_year",
"description",
"concepts",
"concepts_secondary",
"world_heritage_sites",
"url",
"sources"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"url": {
"type": "string",
"description": "The element's UNESCO page URL."
},
"list": {
"enum": [
"Representative List",
"Urgent Safeguarding List",
"Register of Good Safeguarding Practices"
],
"type": "string",
"description": "The list the element is inscribed on: Representative List, Urgent Safeguarding List, or Register of Good Safeguarding Practices."
},
"name": {
"type": "string",
"description": "English name."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"element_not_found",
"snapshot_unavailable"
],
"description": "Machine-readable failure mode. Declared by this tool: `element_not_found`: No record carries this ich_ref. `snapshot_unavailable`: No intangible heritage snapshot has loaded yet: the Data Hub is unreachable, failing, or rate-limiting (retryable), or it rejected the request or served data this server cannot use (not retryable). Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"image": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Main image URL (opens in a browser; not fetched by this server)."
},
"author": {
"type": "string",
"description": "Photographer, when recorded."
},
"caption": {
"type": "string",
"description": "Image caption, when recorded."
},
"copyright": {
"type": "string",
"description": "Copyright holder, when recorded."
}
},
"description": "Main image with its caption and credit, when UNESCO lists one.",
"additionalProperties": false
},
"notice": {
"type": "string",
"description": "That the description is not in the requested description_language, and why."
},
"ich_ref": {
"type": "string",
"description": "Intangible heritage element reference (ich_ref)."
},
"name_fr": {
"type": "string",
"description": "French name."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"dataset",
"title",
"data_as_of",
"license",
"attribution"
],
"properties": {
"title": {
"type": "string",
"description": "Dataset title."
},
"dataset": {
"enum": [
"whc001",
"ich001",
"mab001"
],
"type": "string",
"description": "UNESCO Data Hub dataset id."
},
"license": {
"type": "string",
"description": "Dataset license from the dataset metadata ('CC BY-SA 4.0')."
},
"data_as_of": {
"type": "string",
"description": "Dataset's data_processed timestamp (ISO 8601) from the loaded snapshot."
},
"attribution": {
"type": "string",
"description": "Credit line to reproduce with the data."
}
},
"description": "One source dataset.",
"additionalProperties": false
},
"description": "Datasets this response was built from."
},
"concepts": {
"type": "array",
"items": {
"type": "string",
"description": "Concept term."
},
"description": "Primary UNESCO concept terms; empty for the few elements without any."
},
"countries": {
"type": "array",
"items": {
"type": "string",
"description": "Country name."
},
"description": "Country display names aligned with country_codes."
},
"description": {
"type": "string",
"description": "UNESCO's description of the element: in English, or in the language description_language names."
},
"country_codes": {
"type": "array",
"items": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code."
},
"description": "ISO 3166-1 alpha-2 codes of the countries sharing the element, as UNESCO lists them."
},
"multinational": {
"type": "boolean",
"description": "True when more than one country shares the element."
},
"inscribed_year": {
"type": "number",
"description": "Inscription year. Elements dated 2008 were incorporated into the Representative List that year after an earlier proclamation."
},
"concepts_secondary": {
"type": "array",
"items": {
"type": "string",
"description": "Concept term."
},
"description": "Secondary UNESCO concept terms."
},
"description_language": {
"enum": [
"en",
"fr"
],
"type": "string",
"description": "Language of description, present when the description_language input was set: the requested language, or en when UNESCO publishes no description in it."
},
"world_heritage_sites": {
"type": "array",
"items": {
"type": "object",
"required": [
"id_no",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Site name as the element record carries it."
},
"id_no": {
"type": "string",
"description": "World Heritage id_no; pass to unesco_get_site."
}
},
"description": "One linked World Heritage site.",
"additionalProperties": false
},
"description": "World Heritage sites UNESCO links to the element; empty when none are linked."
}
},
"additionalProperties": false
}unesco_get_intangible_heritage_element annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}unesco_search_biosphere_reserves — Search biosphere reserves
Advertised read-onlyOpen-world
Search the World Network of Biosphere Reserves (UNESCO Man and the Biosphere Programme) by keyword, country, region, MAB regional network, designation year range, transboundary or Small Island Developing States status, or distance from a point. Every keyword must appear at the start of a word in the reserve's name, introduction, or ecological or socio-economic description; there is no biome or ecosystem field, so an ecosystem search is a keyword search such as mangrove or alpine. A country is an ISO 3166-1 alpha-2 or alpha-3 code. A transboundary reserve appears once per participating country, each with its own mab_id. Results page with next_cursor and carry facet counts over the whole match.
unesco_search_biosphere_reserves input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"near": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the point, in decimal degrees (−90 to 90)."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the point, in decimal degrees (−180 to 180)."
},
"radius_km": {
"type": "number",
"default": 100,
"maximum": 5000,
"description": "Search radius in kilometres (up to 5000, default 100).",
"exclusiveMinimum": 0
}
},
"description": "Only reserves within radius_km of this point. Every reserve has coordinates.",
"additionalProperties": false
},
"sids": {
"type": "boolean",
"description": "true: only reserves in Small Island Developing States. false: only reserves elsewhere."
},
"sort": {
"enum": [
"relevance",
"name",
"designated_newest",
"designated_oldest",
"area_largest",
"distance"
],
"type": "string",
"description": "Result order. Default: relevance when query is set, else distance when near is set, else name. relevance needs query; distance needs near. area_largest orders by total recorded area."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"description": "Maximum results per page (default 20). A page holds at most 50: a larger limit, up to 10000, is served as 50 and notice says so."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Keywords; every word must match the start of a word in the reserve's name, introduction, or ecological or socio-economic description. Case, accents, and punctuation are ignored, so the query must contain at least one letter or digit and at most 16 distinct words; no phrases, operators, or fuzzy matching. For an ecosystem, use a habitat word such as mangrove, wetland, or alpine."
},
"cursor": {
"type": "string",
"maxLength": 1024,
"description": "Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page."
},
"region": {
"enum": [
"Africa",
"Arab States",
"Asia and the Pacific",
"Europe and North America",
"Latin America and the Caribbean"
],
"type": "string",
"description": "UNESCO region: Africa, Arab States, Asia and the Pacific, Europe and North America, or Latin America and the Caribbean (codes AFR, ARB, APA, EUR, LAC accepted). Matches any of a reserve's regions."
},
"country": {
"type": "string",
"maxLength": 64,
"description": "ISO 3166-1 alpha-2 or alpha-3 code, any case (FR, FRA). Matches the reserve's country; a transboundary reserve has one row per participating country. For a country name, look up its code with unesco_list_reference (topic countries)."
},
"designated_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Latest designation year, inclusive."
},
"transboundary": {
"type": "boolean",
"description": "true: only transboundary reserves (one row per participating country). false: only single-country reserves."
},
"designated_from": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Earliest designation year, inclusive."
},
"regional_network": {
"enum": [
"African Biosphere Reserve Network (AfriMAB)",
"Arab States Biosphere Reserve Network (ArabMAB)",
"East Asian Biosphere Reserve Network (EABRN)",
"Europe and North America Biosphere Reserve Network (EuroMAB)",
"Ibero-American MAB Network (IberoMAB)",
"South and Central Asia MAB Network (SACAM)",
"Southeast Asian Biosphere Reserve Network (SeaBRnet)"
],
"type": "string",
"description": "MAB regional network, by full name or acronym (AfriMAB, ArabMAB, EABRN, EuroMAB, IberoMAB, SACAM, SeaBRnet), any case. A few reserves belong to no network."
},
"include_description": {
"type": "boolean",
"default": true,
"description": "Set false to leave each row's introduction out of the response (default true); unesco_get_biosphere_reserve returns it. Which reserves match, their order, and matched_in are unchanged."
}
},
"additionalProperties": false
}unesco_search_biosphere_reserves output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"reserves",
"sources",
"totalCount",
"truncated",
"shown",
"cap",
"applied_filters",
"facets"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "number",
"description": "The page size applied: limit, or the per-call cap of 50 when limit was larger."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unknown_country",
"invalid_year_range",
"sort_needs_input",
"cursor_mismatch",
"invalid_cursor",
"snapshot_unavailable"
],
"description": "Machine-readable failure mode. Declared by this tool: `unknown_country`: country is not a recognized ISO 3166-1 alpha-2 or alpha-3 code, such as a country name or an unassigned code. `invalid_year_range`: designated_from is later than designated_to. `sort_needs_input`: sort relevance without query, or sort distance without near. `cursor_mismatch`: cursor was issued for different filters or sort, or for an earlier data snapshot. `invalid_cursor`: cursor is malformed, or its offset is not a non-negative whole number or its limit not a positive one. `snapshot_unavailable`: No MAB snapshot has loaded yet: the Data Hub is unreachable, failing, or rate-limiting (retryable), or it rejected the request or served data this server cannot use (not retryable). Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "number",
"description": "Number of results on this page."
},
"facets": {
"type": "object",
"required": [
"region",
"regional_network",
"transboundary",
"sids",
"top_countries"
],
"properties": {
"sids": {
"type": "object",
"required": [
"true",
"false"
],
"properties": {
"true": {
"type": "number",
"description": "Matching reserves in Small Island Developing States."
},
"false": {
"type": "number",
"description": "Matching reserves elsewhere."
}
},
"description": "Matching reserves by Small Island Developing State status.",
"additionalProperties": false
},
"region": {
"type": "object",
"description": "Matching reserves per region; a reserve in two regions counts in both.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"top_countries": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name",
"count"
],
"properties": {
"code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code."
},
"name": {
"type": "string",
"description": "Country name."
},
"count": {
"type": "number",
"description": "Matching reserves in the country."
}
},
"description": "One country count.",
"additionalProperties": false
},
"description": "Top 10 countries."
},
"transboundary": {
"type": "object",
"required": [
"true",
"false"
],
"properties": {
"true": {
"type": "number",
"description": "Matching transboundary reserves."
},
"false": {
"type": "number",
"description": "Matching single-country reserves."
}
},
"description": "Matching reserves by transboundary status.",
"additionalProperties": false
},
"regional_network": {
"type": "object",
"description": "Matching reserves per MAB regional network; \"none\" counts those in none.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
}
},
"description": "Facet counts over the whole match, not just this page.",
"additionalProperties": false
},
"notice": {
"type": "string",
"description": "Guidance on the result: why nothing matched, caveats, or how to continue paging."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"dataset",
"title",
"data_as_of",
"license",
"attribution"
],
"properties": {
"title": {
"type": "string",
"description": "Dataset title."
},
"dataset": {
"enum": [
"whc001",
"ich001",
"mab001"
],
"type": "string",
"description": "UNESCO Data Hub dataset id."
},
"license": {
"type": "string",
"description": "Dataset license from the dataset metadata ('CC BY-SA 4.0')."
},
"data_as_of": {
"type": "string",
"description": "Dataset's data_processed timestamp (ISO 8601) from the loaded snapshot."
},
"attribution": {
"type": "string",
"description": "Credit line to reproduce with the data."
}
},
"description": "One source dataset.",
"additionalProperties": false
},
"description": "Datasets this response was built from."
},
"reserves": {
"type": "array",
"items": {
"type": "object",
"required": [
"mab_id",
"name",
"country_code",
"country",
"regions",
"designation_year",
"transboundary",
"sids",
"area_total_hectares",
"area_marine_hectares",
"population_total",
"latitude",
"longitude"
],
"properties": {
"name": {
"type": "string",
"description": "English name."
},
"sids": {
"type": "boolean",
"description": "True when the reserve is in a Small Island Developing State."
},
"mab_id": {
"type": "string",
"description": "Biosphere reserve id; pass to unesco_get_biosphere_reserve for the full record."
},
"country": {
"type": "string",
"description": "Country name as UNESCO records it."
},
"regions": {
"type": "array",
"items": {
"enum": [
"Africa",
"Arab States",
"Asia and the Pacific",
"Europe and North America",
"Latin America and the Caribbean"
],
"type": "string",
"description": "UNESCO region."
},
"description": "UNESCO regions the reserve belongs to."
},
"latitude": {
"type": "number",
"description": "Representative point latitude."
},
"longitude": {
"type": "number",
"description": "Representative point longitude."
},
"matched_in": {
"enum": [
"name",
"introduction",
"characteristics"
],
"type": "string",
"description": "The first field tier by which every query word had matched (present when query is set)."
},
"distance_km": {
"type": "number",
"description": "Distance from the near point in km, rounded to 0.1 km and never above radius_km (present when near is set)."
},
"country_code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code of the reserve country."
},
"introduction": {
"type": "string",
"description": "UNESCO's introduction to the reserve; omitted from every row when include_description is false."
},
"transboundary": {
"type": "boolean",
"description": "True for a transboundary reserve; each participating country has its own mab_id."
},
"designation_year": {
"type": "number",
"description": "Year of designation."
},
"population_total": {
"type": "number",
"description": "Resident population, as recorded; 0 can mean none or unreported."
},
"regional_network": {
"enum": [
"African Biosphere Reserve Network (AfriMAB)",
"Arab States Biosphere Reserve Network (ArabMAB)",
"East Asian Biosphere Reserve Network (EABRN)",
"Europe and North America Biosphere Reserve Network (EuroMAB)",
"Ibero-American MAB Network (IberoMAB)",
"South and Central Asia MAB Network (SACAM)",
"Southeast Asian Biosphere Reserve Network (SeaBRnet)"
],
"type": "string",
"description": "MAB regional network, when the reserve belongs to one."
},
"area_total_hectares": {
"type": "number",
"description": "Total area in hectares, as recorded (unit inferred; undocumented upstream)."
},
"area_marine_hectares": {
"type": "number",
"description": "Total marine area in hectares, as recorded."
}
},
"description": "One biosphere reserve.",
"additionalProperties": false
},
"description": "Matching reserves on this page."
},
"truncated": {
"type": "boolean",
"description": "True when more results remain beyond this page."
},
"totalCount": {
"type": "number",
"description": "Total matches across all pages."
},
"next_cursor": {
"type": "string",
"description": "Pass as cursor, with the same filters and sort, to fetch the next page. Present when more results remain."
},
"applied_filters": {
"type": "object",
"required": [
"sort",
"limit",
"include_description"
],
"properties": {
"near": {
"type": "object",
"required": [
"latitude",
"longitude",
"radius_km"
],
"properties": {
"latitude": {
"type": "number",
"description": "Latitude."
},
"longitude": {
"type": "number",
"description": "Longitude."
},
"radius_km": {
"type": "number",
"description": "Radius in km."
}
},
"description": "Distance filter.",
"additionalProperties": false
},
"sids": {
"type": "boolean",
"description": "Small Island Developing State filter."
},
"sort": {
"enum": [
"relevance",
"name",
"designated_newest",
"designated_oldest",
"area_largest",
"distance"
],
"type": "string",
"description": "The sort applied (resolved default when none was given)."
},
"limit": {
"type": "number",
"description": "Page size applied: limit, or 50 when limit was larger."
},
"query": {
"type": "string",
"description": "Keyword query as given."
},
"region": {
"enum": [
"Africa",
"Arab States",
"Asia and the Pacific",
"Europe and North America",
"Latin America and the Caribbean"
],
"type": "string",
"description": "Region filter."
},
"country": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code the country input resolved to."
},
"name": {
"type": "string",
"description": "Country name."
}
},
"description": "Resolved country.",
"additionalProperties": false
},
"designated_to": {
"type": "number",
"description": "Latest designation year."
},
"transboundary": {
"type": "boolean",
"description": "Transboundary filter."
},
"designated_from": {
"type": "number",
"description": "Earliest designation year."
},
"regional_network": {
"enum": [
"African Biosphere Reserve Network (AfriMAB)",
"Arab States Biosphere Reserve Network (ArabMAB)",
"East Asian Biosphere Reserve Network (EABRN)",
"Europe and North America Biosphere Reserve Network (EuroMAB)",
"Ibero-American MAB Network (IberoMAB)",
"South and Central Asia MAB Network (SACAM)",
"Southeast Asian Biosphere Reserve Network (SeaBRnet)"
],
"type": "string",
"description": "MAB regional network filter."
},
"include_description": {
"type": "boolean",
"description": "Whether rows carry their introduction."
}
},
"description": "The filters and sort as the server applied them.",
"additionalProperties": false
}
},
"additionalProperties": false
}unesco_search_biosphere_reserves annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}unesco_get_biosphere_reserve — Get biosphere reserve
Advertised read-onlyOpen-world
Fetch one biosphere reserve's full record by mab_id: its introduction, ecological and socio-economic characteristics, core, buffer, and transition areas (terrestrial and marine, in hectares) with resident population by zone, designation, extension, renaming, and periodic-review years, coordinates, and its UNESCO page.
unesco_get_biosphere_reserve input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mab_id"
],
"properties": {
"mab_id": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "The reserve's mab_id, from unesco_search_biosphere_reserves. Case and accents are ignored."
}
},
"additionalProperties": false
}unesco_get_biosphere_reserve output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"mab_id",
"name",
"country_code",
"country",
"regions",
"designation_year",
"extension_years",
"renaming_years",
"periodic_review_years",
"transboundary",
"sids",
"area_hectares",
"population",
"latitude",
"longitude",
"introduction",
"url",
"sources"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"url": {
"type": "string",
"description": "The reserve's UNESCO page URL."
},
"name": {
"type": "string",
"description": "English name."
},
"sids": {
"type": "boolean",
"description": "True when the reserve is in a Small Island Developing State."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"biosphere_reserve_not_found",
"snapshot_unavailable"
],
"description": "Machine-readable failure mode. Declared by this tool: `biosphere_reserve_not_found`: No record carries this mab_id, after folding case and diacritics. `snapshot_unavailable`: No MAB snapshot has loaded yet: the Data Hub is unreachable, failing, or rate-limiting (retryable), or it rejected the request or served data this server cannot use (not retryable). Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"mab_id": {
"type": "string",
"description": "Biosphere reserve id (mab_id)."
},
"country": {
"type": "string",
"description": "Country name as UNESCO records it."
},
"regions": {
"type": "array",
"items": {
"enum": [
"Africa",
"Arab States",
"Asia and the Pacific",
"Europe and North America",
"Latin America and the Caribbean"
],
"type": "string",
"description": "UNESCO region."
},
"description": "UNESCO regions the reserve belongs to."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"dataset",
"title",
"data_as_of",
"license",
"attribution"
],
"properties": {
"title": {
"type": "string",
"description": "Dataset title."
},
"dataset": {
"enum": [
"whc001",
"ich001",
"mab001"
],
"type": "string",
"description": "UNESCO Data Hub dataset id."
},
"license": {
"type": "string",
"description": "Dataset license from the dataset metadata ('CC BY-SA 4.0')."
},
"data_as_of": {
"type": "string",
"description": "Dataset's data_processed timestamp (ISO 8601) from the loaded snapshot."
},
"attribution": {
"type": "string",
"description": "Credit line to reproduce with the data."
}
},
"description": "One source dataset.",
"additionalProperties": false
},
"description": "Datasets this response was built from."
},
"website": {
"type": "string",
"description": "The reserve's own website, when recorded."
},
"latitude": {
"type": "number",
"description": "Representative point latitude."
},
"longitude": {
"type": "number",
"description": "Representative point longitude."
},
"population": {
"type": "object",
"required": [
"total",
"core",
"buffer",
"transition"
],
"properties": {
"core": {
"type": "number",
"description": "Core-zone population, as recorded."
},
"total": {
"type": "number",
"description": "Total resident population, as recorded."
},
"buffer": {
"type": "number",
"description": "Buffer-zone population, as recorded."
},
"transition": {
"type": "number",
"description": "Transition-zone population, as recorded."
}
},
"description": "Resident population by zone, as recorded; 0 can mean none or unreported, and zone sums do not always match the total.",
"additionalProperties": false
},
"country_code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code of the reserve country."
},
"introduction": {
"type": "string",
"description": "UNESCO's introduction to the reserve."
},
"area_hectares": {
"type": "object",
"required": [
"total",
"terrestrial",
"marine"
],
"properties": {
"total": {
"type": "number",
"description": "Total area, as recorded."
},
"marine": {
"type": "object",
"required": [
"total",
"core",
"buffer",
"transition"
],
"properties": {
"core": {
"type": "number",
"description": "Core-zone marine area, as recorded."
},
"total": {
"type": "number",
"description": "Total marine area, as recorded."
},
"buffer": {
"type": "number",
"description": "Buffer-zone marine area, as recorded."
},
"transition": {
"type": "number",
"description": "Transition-zone marine area, as recorded."
}
},
"description": "The marine area by zone in hectares, as recorded; zone sums don't always match the total upstream.",
"additionalProperties": false
},
"terrestrial": {
"type": "object",
"required": [
"total",
"core",
"buffer",
"transition"
],
"properties": {
"core": {
"type": "number",
"description": "Core-zone terrestrial area, as recorded."
},
"total": {
"type": "number",
"description": "Total terrestrial area, as recorded."
},
"buffer": {
"type": "number",
"description": "Buffer-zone terrestrial area, as recorded."
},
"transition": {
"type": "number",
"description": "Transition-zone terrestrial area, as recorded."
}
},
"description": "The terrestrial area by zone in hectares, as recorded; zone sums don't always match the total upstream.",
"additionalProperties": false
}
},
"description": "Areas in hectares (unit inferred; undocumented upstream), as recorded — the server computes no totals, and zone sums do not always match the totals.",
"additionalProperties": false
},
"transboundary": {
"type": "boolean",
"description": "True for a transboundary reserve; each participating country has its own mab_id."
},
"renaming_years": {
"type": "array",
"items": {
"type": "number",
"description": "Year."
},
"description": "Years the reserve was renamed; empty when none."
},
"extension_years": {
"type": "array",
"items": {
"type": "number",
"description": "Year."
},
"description": "Years the reserve was extended; empty when none."
},
"designation_year": {
"type": "number",
"description": "Year of designation."
},
"regional_network": {
"enum": [
"African Biosphere Reserve Network (AfriMAB)",
"Arab States Biosphere Reserve Network (ArabMAB)",
"East Asian Biosphere Reserve Network (EABRN)",
"Europe and North America Biosphere Reserve Network (EuroMAB)",
"Ibero-American MAB Network (IberoMAB)",
"South and Central Asia MAB Network (SACAM)",
"Southeast Asian Biosphere Reserve Network (SeaBRnet)"
],
"type": "string",
"description": "MAB regional network, when the reserve belongs to one."
},
"periodic_review_years": {
"type": "array",
"items": {
"type": "number",
"description": "Year."
},
"description": "Years of periodic review; empty when none recorded."
},
"ecological_characteristics": {
"type": "string",
"description": "Ecological characteristics, when recorded."
},
"socio_economic_characteristics": {
"type": "string",
"description": "Socio-economic characteristics, when recorded."
}
},
"additionalProperties": false
}unesco_get_biosphere_reserve annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}unesco_search_geoparks — Search UNESCO Global Geoparks
Advertised read-onlyOpen-world
Search UNESCO Global Geoparks by keyword, country, designation year range, transnational status, or distance from a point. Every keyword must appear at the start of a word in the geopark's name, introduction, description, or account of how it sustains local communities, and name matches rank first. A country is an ISO 3166-1 alpha-2 or alpha-3 code and matches every geopark it takes part in, transnational geoparks included. Geoparks UNESCO recognized before the Global Geopark label existed are dated 2015, the year it was created. Results page with next_cursor and carry facet counts over the whole match.
unesco_search_geoparks input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"near": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the point, in decimal degrees (−90 to 90)."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the point, in decimal degrees (−180 to 180)."
},
"radius_km": {
"type": "number",
"default": 100,
"maximum": 5000,
"description": "Search radius in kilometres (up to 5000, default 100).",
"exclusiveMinimum": 0
}
},
"description": "Only geoparks within radius_km of this point. Every geopark has one point, which the distance measures.",
"additionalProperties": false
},
"sort": {
"enum": [
"relevance",
"name",
"designated_newest",
"designated_oldest",
"area_largest",
"distance"
],
"type": "string",
"description": "Result order. Default: relevance when query is set, else distance when near is set, else name. relevance needs query; distance needs near. area_largest orders by recorded area."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"description": "Maximum results per page (default 20). A page holds at most 50: a larger limit, up to 10000, is served as 50 and notice says so."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Keywords; every word must match the start of a word in the geopark's name, introduction, description, or account of sustaining local communities. Case, accents, and punctuation are ignored, so the query must contain at least one letter or digit and at most 16 distinct words; no phrases, operators, or fuzzy matching. For a landform, use a word such as volcanic, karst, or fossil."
},
"cursor": {
"type": "string",
"maxLength": 1024,
"description": "Opaque continuation cursor from the previous call's next_cursor. Pass it with the same filters and sort to fetch the next page."
},
"country": {
"type": "string",
"maxLength": 64,
"description": "ISO 3166-1 alpha-2 or alpha-3 code, any case (FR, FRA). Matches every geopark the country takes part in, transnational geoparks included. For a country name, look up its code with unesco_list_reference (topic countries)."
},
"designated_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Latest designation year, inclusive."
},
"transnational": {
"type": "boolean",
"description": "true: only geoparks spanning more than one country. false: only single-country geoparks."
},
"designated_from": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Earliest designation year, inclusive."
},
"include_description": {
"type": "boolean",
"default": true,
"description": "Set false to leave each row's introduction out of the response (default true); unesco_get_geopark returns it. Which geoparks match, their order, and matched_in are unchanged."
}
},
"additionalProperties": false
}unesco_search_geoparks output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"geoparks",
"sources",
"totalCount",
"truncated",
"shown",
"cap",
"applied_filters",
"facets"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cap": {
"type": "number",
"description": "The page size applied: limit, or the per-call cap of 50 when limit was larger."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"unknown_country",
"invalid_year_range",
"sort_needs_input",
"cursor_mismatch",
"invalid_cursor",
"snapshot_unavailable"
],
"description": "Machine-readable failure mode. Declared by this tool: `unknown_country`: country is not a recognized ISO 3166-1 alpha-2 or alpha-3 code, such as a country name or an unassigned code. `invalid_year_range`: designated_from is later than designated_to. `sort_needs_input`: sort relevance without query, or sort distance without near. `cursor_mismatch`: cursor was issued for different filters or sort, or for an earlier data snapshot. `invalid_cursor`: cursor is malformed, or its offset is not a non-negative whole number or its limit not a positive one. `snapshot_unavailable`: No geopark snapshot has loaded yet: the Data Hub is unreachable, failing, or rate-limiting (retryable), or it rejected the request or served data this server cannot use (not retryable). Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"shown": {
"type": "number",
"description": "Number of results on this page."
},
"facets": {
"type": "object",
"required": [
"transnational",
"top_countries"
],
"properties": {
"top_countries": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name",
"count"
],
"properties": {
"code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code."
},
"name": {
"type": "string",
"description": "Country name."
},
"count": {
"type": "number",
"description": "Matching geoparks the country takes part in."
}
},
"description": "One country count.",
"additionalProperties": false
},
"description": "Top 10 countries; a transnational geopark counts for each of its countries."
},
"transnational": {
"type": "object",
"required": [
"true",
"false"
],
"properties": {
"true": {
"type": "number",
"description": "Matching transnational geoparks."
},
"false": {
"type": "number",
"description": "Matching single-country geoparks."
}
},
"description": "Matching geoparks by transnational status.",
"additionalProperties": false
}
},
"description": "Facet counts over the whole match, not just this page.",
"additionalProperties": false
},
"notice": {
"type": "string",
"description": "Guidance on the result: why nothing matched, caveats, or how to continue paging."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"dataset",
"title",
"data_as_of",
"license",
"attribution"
],
"properties": {
"title": {
"type": "string",
"description": "Dataset title."
},
"dataset": {
"enum": [
"eg0001"
],
"type": "string",
"description": "UNESCO Data Hub dataset id."
},
"license": {
"type": "string",
"description": "Dataset license from the dataset metadata ('CC BY-SA 4.0')."
},
"data_as_of": {
"type": "string",
"description": "Dataset's data_processed timestamp (ISO 8601) from the loaded snapshot."
},
"attribution": {
"type": "string",
"description": "Credit line to reproduce with the data."
}
},
"description": "One source dataset.",
"additionalProperties": false
},
"description": "Datasets this response was built from."
},
"geoparks": {
"type": "array",
"items": {
"type": "object",
"required": [
"ugg_id",
"name",
"country_codes",
"countries",
"transnational",
"designation_year",
"area_hectares",
"latitude",
"longitude"
],
"properties": {
"name": {
"type": "string",
"description": "English name."
},
"ugg_id": {
"type": "string",
"description": "UNESCO Global Geopark id; pass to unesco_get_geopark for the full record."
},
"latitude": {
"type": "number",
"description": "Latitude of the geopark's point."
},
"countries": {
"type": "array",
"items": {
"type": "string",
"description": "Country name."
},
"description": "Country display names aligned with country_codes."
},
"longitude": {
"type": "number",
"description": "Longitude of the geopark's point."
},
"matched_in": {
"enum": [
"name",
"introduction",
"description"
],
"type": "string",
"description": "The first field tier by which every query word had matched (present when query is set); description covers the description and the account of sustaining local communities."
},
"population": {
"type": "number",
"description": "Resident population, as recorded; absent when UNESCO records none, and 0 can mean unreported."
},
"distance_km": {
"type": "number",
"description": "Distance from the near point in km, rounded to 0.1 km and never above radius_km (present when near is set)."
},
"introduction": {
"type": "string",
"description": "UNESCO's introduction to the geopark; omitted from every row when include_description is false."
},
"area_hectares": {
"type": "number",
"description": "Area in hectares, as recorded."
},
"country_codes": {
"type": "array",
"items": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code."
},
"description": "ISO 3166-1 alpha-2 codes of the geopark's countries; a transnational geopark lists each."
},
"transnational": {
"type": "boolean",
"description": "True when the geopark spans more than one country."
},
"designation_year": {
"type": "number",
"description": "Designation year; geoparks UNESCO recognized before the Global Geopark label existed are dated 2015, the year it was created."
}
},
"description": "One UNESCO Global Geopark.",
"additionalProperties": false
},
"description": "Matching geoparks on this page."
},
"truncated": {
"type": "boolean",
"description": "True when more results remain beyond this page."
},
"totalCount": {
"type": "number",
"description": "Total matches across all pages."
},
"next_cursor": {
"type": "string",
"description": "Pass as cursor, with the same filters and sort, to fetch the next page. Present when more results remain."
},
"applied_filters": {
"type": "object",
"required": [
"sort",
"limit",
"include_description"
],
"properties": {
"near": {
"type": "object",
"required": [
"latitude",
"longitude",
"radius_km"
],
"properties": {
"latitude": {
"type": "number",
"description": "Latitude."
},
"longitude": {
"type": "number",
"description": "Longitude."
},
"radius_km": {
"type": "number",
"description": "Radius in km."
}
},
"description": "Distance filter.",
"additionalProperties": false
},
"sort": {
"enum": [
"relevance",
"name",
"designated_newest",
"designated_oldest",
"area_largest",
"distance"
],
"type": "string",
"description": "The sort applied (resolved default when none was given)."
},
"limit": {
"type": "number",
"description": "Page size applied: limit, or 50 when limit was larger."
},
"query": {
"type": "string",
"description": "Keyword query as given."
},
"country": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code the country input resolved to."
},
"name": {
"type": "string",
"description": "Country name."
}
},
"description": "Resolved country.",
"additionalProperties": false
},
"designated_to": {
"type": "number",
"description": "Latest designation year."
},
"transnational": {
"type": "boolean",
"description": "Transnational filter."
},
"designated_from": {
"type": "number",
"description": "Earliest designation year."
},
"include_description": {
"type": "boolean",
"description": "Whether rows carry their introduction."
}
},
"description": "The filters and sort as the server applied them.",
"additionalProperties": false
}
},
"additionalProperties": false
}unesco_search_geoparks annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}unesco_get_geopark — Get UNESCO Global Geopark
Advertised read-onlyOpen-world
Fetch one UNESCO Global Geopark's full record by ugg_id: its countries, designation year, transnational status, area and resident population as recorded, coordinates, UNESCO's introduction and description, its account of how the geopark sustains local communities, its own website, and its UNESCO page.
unesco_get_geopark input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ugg_id"
],
"properties": {
"ugg_id": {
"type": "string",
"pattern": "^[A-Za-z0-9]+$",
"maxLength": 20,
"description": "The geopark's ugg_id, such as EUFR10, from unesco_search_geoparks. Case and surrounding whitespace are ignored."
}
},
"additionalProperties": false
}unesco_get_geopark output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"ugg_id",
"name",
"country_codes",
"countries",
"transnational",
"designation_year",
"area_hectares",
"latitude",
"longitude",
"introduction",
"description",
"sustaining_local_communities",
"url",
"sources"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"url": {
"type": "string",
"description": "The geopark's UNESCO page URL."
},
"name": {
"type": "string",
"description": "English name."
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"geopark_not_found",
"snapshot_unavailable"
],
"description": "Machine-readable failure mode. Declared by this tool: `geopark_not_found`: No record carries this ugg_id, after trimming and uppercasing. `snapshot_unavailable`: No geopark snapshot has loaded yet: the Data Hub is unreachable, failing, or rate-limiting (retryable), or it rejected the request or served data this server cannot use (not retryable). Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"ugg_id": {
"type": "string",
"description": "UNESCO Global Geopark id (ugg_id)."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"dataset",
"title",
"data_as_of",
"license",
"attribution"
],
"properties": {
"title": {
"type": "string",
"description": "Dataset title."
},
"dataset": {
"enum": [
"eg0001"
],
"type": "string",
"description": "UNESCO Data Hub dataset id."
},
"license": {
"type": "string",
"description": "Dataset license from the dataset metadata ('CC BY-SA 4.0')."
},
"data_as_of": {
"type": "string",
"description": "Dataset's data_processed timestamp (ISO 8601) from the loaded snapshot."
},
"attribution": {
"type": "string",
"description": "Credit line to reproduce with the data."
}
},
"description": "One source dataset.",
"additionalProperties": false
},
"description": "Datasets this response was built from."
},
"website": {
"type": "string",
"description": "The geopark's own website, when recorded."
},
"latitude": {
"type": "number",
"description": "Latitude of the geopark's point."
},
"countries": {
"type": "array",
"items": {
"type": "string",
"description": "Country name."
},
"description": "Country display names aligned with country_codes."
},
"longitude": {
"type": "number",
"description": "Longitude of the geopark's point."
},
"population": {
"type": "number",
"description": "Resident population, as recorded; absent when UNESCO records none, and 0 can mean unreported."
},
"description": {
"type": "string",
"description": "UNESCO's description of the geopark."
},
"introduction": {
"type": "string",
"description": "UNESCO's introduction to the geopark."
},
"area_hectares": {
"type": "number",
"description": "Area in hectares, as recorded."
},
"country_codes": {
"type": "array",
"items": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code."
},
"description": "ISO 3166-1 alpha-2 codes of the geopark's countries; a transnational geopark lists each."
},
"transnational": {
"type": "boolean",
"description": "True when the geopark spans more than one country."
},
"designation_year": {
"type": "number",
"description": "Designation year; geoparks UNESCO recognized before the Global Geopark label existed are dated 2015, the year it was created."
},
"sustaining_local_communities": {
"type": "string",
"description": "UNESCO's account of how the geopark sustains its local communities."
}
},
"additionalProperties": false
}unesco_get_geopark annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}unesco_list_reference — List UNESCO reference vocabulary
Advertised read-onlyOpen-world
List the vocabulary the other unesco_ tools accept and the coverage of the underlying datasets: the ten inscription criteria with their meanings and site counts, the countries in each dataset with their ISO alpha-2 and alpha-3 codes and record counts, the five UNESCO regions, the three intangible heritage lists, the MAB regional networks, and each dataset's record count, license, and data date. Set filter to narrow a topic to matching entries, for example a country name to find its code.
unesco_list_reference input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"topic"
],
"properties": {
"topic": {
"enum": [
"criteria",
"countries",
"regions",
"intangible_lists",
"biosphere_networks",
"datasets"
],
"type": "string",
"description": "What to list. criteria: the ten inscription criteria (i)–(x) with meanings and site counts, the values of the criteria input of unesco_search_sites. countries: every country with its ISO alpha-2 and alpha-3 codes and counts per dataset, the values of every country input. regions: the five UNESCO regions with codes, the values of the region inputs. intangible_lists: the three intangible heritage lists with acronyms, the values of the list input of unesco_search_intangible_heritage. biosphere_networks: the MAB regional networks with acronyms, the values of the regional_network input of unesco_search_biosphere_reserves. datasets: each dataset with whether it loaded, its record count, data date, license, attribution, and coverage notes."
},
"filter": {
"type": "string",
"maxLength": 100,
"description": "Keep only entries whose name or code (a criterion's meaning, a dataset's title) contains every word of this text, each word matching at the start of a word. Case, accents, and punctuation are ignored, so the filter must contain at least one letter or digit and at most 16 distinct words. For example, a country name finds its ISO code. For countries, a two- or three-letter ISO code (or UK) keeps exactly that country, as the country inputs read it, and common former or everyday names such as Turkey, Swaziland, or Holland match too."
}
},
"additionalProperties": false
}unesco_list_reference output schema
{
"type": "object",
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"topic",
"sources"
]
},
{
"required": [
"error"
]
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"examples": [
"snapshot_unavailable"
],
"description": "Machine-readable failure mode. Declared by this tool: `snapshot_unavailable`: No dataset the topic reads has loaded yet (countries, regions, and datasets answer from the ones that did, when any did): the Data Hub is unreachable, failing, or rate-limiting (retryable), or it rejected the request or served data this server cannot use (not retryable). Other values are possible when a failure originates below the handler."
},
"recovery": {
"type": "object",
"required": [
"hint"
],
"properties": {
"hint": {
"type": "string"
}
},
"description": "Actionable next step for the caller.",
"additionalProperties": {}
},
"retryable": {
"type": "boolean",
"description": "Whether retrying may succeed."
}
},
"additionalProperties": {}
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
}
},
"description": "Present when the call failed. Absent on success.",
"additionalProperties": {}
},
"topic": {
"enum": [
"criteria",
"countries",
"regions",
"intangible_lists",
"biosphere_networks",
"datasets"
],
"type": "string",
"description": "The topic listed."
},
"notice": {
"type": "string",
"description": "Names each dataset that could not load and what the answer leaves out for it, then guidance when the filter matched no entry."
},
"regions": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"code"
],
"properties": {
"code": {
"type": "string",
"description": "UNESCO region code, also accepted by the region inputs."
},
"name": {
"type": "string",
"description": "UNESCO region name, as the region inputs take it."
},
"heritage_site_count": {
"type": "number",
"description": "World Heritage sites in the region."
},
"biosphere_reserve_count": {
"type": "number",
"description": "Biosphere reserves in the region (a reserve spanning two regions counts in each)."
}
},
"description": "One UNESCO region. A count is absent, never 0, when its dataset could not load; the notice names that dataset.",
"additionalProperties": false
},
"description": "Region rows (topic regions)."
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"dataset",
"title",
"data_as_of",
"license",
"attribution"
],
"properties": {
"title": {
"type": "string",
"description": "Dataset title."
},
"dataset": {
"enum": [
"whc001",
"ich001",
"mab001",
"eg0001"
],
"type": "string",
"description": "UNESCO Data Hub dataset id."
},
"license": {
"type": "string",
"description": "Dataset license from the dataset metadata ('CC BY-SA 4.0')."
},
"data_as_of": {
"type": "string",
"description": "Dataset's data_processed timestamp (ISO 8601) from the loaded snapshot."
},
"attribution": {
"type": "string",
"description": "Credit line to reproduce with the data."
}
},
"description": "One source dataset.",
"additionalProperties": false
},
"description": "Datasets this response was built from."
},
"criteria": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"group",
"meaning",
"site_count",
"inferred_count"
],
"properties": {
"code": {
"enum": [
"i",
"ii",
"iii",
"iv",
"v",
"vi",
"vii",
"viii",
"ix",
"x"
],
"type": "string",
"description": "Criterion numeral, as the criteria input of unesco_search_sites takes it."
},
"group": {
"enum": [
"cultural",
"natural"
],
"type": "string",
"description": "Whether the criterion is a cultural (i–vi) or natural (vii–x) criterion."
},
"meaning": {
"type": "string",
"description": "The criterion's meaning, paraphrased from UNESCO's Operational Guidelines."
},
"site_count": {
"type": "number",
"description": "World Heritage sites carrying the criterion (recorded or inferred)."
},
"inferred_count": {
"type": "number",
"description": "Of those, sites where the criterion is inferred from the statement of Outstanding Universal Value (non-zero only for vi)."
}
},
"description": "One inscription criterion.",
"additionalProperties": false
},
"description": "Criteria rows (topic criteria)."
},
"datasets": {
"type": "array",
"items": {
"type": "object",
"required": [
"dataset",
"title",
"available",
"license_url",
"attribution"
],
"properties": {
"title": {
"type": "string",
"description": "Dataset title."
},
"dataset": {
"type": "string",
"description": "UNESCO Data Hub dataset id."
},
"license": {
"type": "string",
"description": "Dataset license."
},
"records": {
"type": "number",
"description": "Records in the loaded snapshot."
},
"available": {
"type": "boolean",
"description": "Whether the dataset loaded."
},
"retryable": {
"type": "boolean",
"description": "Whether a later call can load the dataset: true when the Data Hub was unreachable or failing, false when it rejected this server's request or served data this server cannot use. Present only when available is false."
},
"data_as_of": {
"type": "string",
"description": "The dataset's data_processed timestamp (ISO 8601)."
},
"attribution": {
"type": "string",
"description": "Credit line to reproduce with the data."
},
"license_url": {
"type": "string",
"description": "License text URL."
},
"coverage_notes": {
"type": "array",
"items": {
"type": "string",
"description": "One note."
},
"description": "Data gaps that change how results read."
}
},
"description": "One dataset. records, data_as_of, license, and coverage_notes are absent when it could not load.",
"additionalProperties": false
},
"description": "Dataset rows (topic datasets)."
},
"countries": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 code, the form every country input accepts. Absent for the one State-Party entry without a code."
},
"name": {
"type": "string",
"description": "English display name."
},
"alpha3": {
"type": "string",
"description": "ISO 3166-1 alpha-3 code, also accepted by country inputs."
},
"unesco_name": {
"type": "string",
"description": "The spelling the UNESCO records use (World Heritage spelling, else the biosphere reserve one), when a dataset carries one."
},
"geopark_count": {
"type": "number",
"description": "UNESCO Global Geoparks listing this country, transnational geoparks included."
},
"heritage_site_count": {
"type": "number",
"description": "World Heritage sites listing this country, transboundary sites included."
},
"biosphere_reserve_count": {
"type": "number",
"description": "Biosphere reserves in this country."
},
"intangible_element_count": {
"type": "number",
"description": "Intangible heritage elements listing this country, multinational elements included."
}
},
"description": "One country. A count is absent, never 0, when its dataset could not load; the notice names that dataset.",
"additionalProperties": false
},
"description": "Country rows sorted by name (topic countries)."
},
"intangible_lists": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"acronym",
"element_count"
],
"properties": {
"name": {
"type": "string",
"description": "List name, as the list input of unesco_search_intangible_heritage takes it."
},
"acronym": {
"type": "string",
"description": "The acronym UNESCO uses for the list, also accepted by the list input."
},
"element_count": {
"type": "number",
"description": "Elements on the list."
}
},
"description": "One intangible heritage list.",
"additionalProperties": false
},
"description": "Intangible heritage list rows (topic intangible_lists)."
},
"biosphere_networks": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"reserve_count"
],
"properties": {
"name": {
"type": "string",
"description": "Network name, as the regional_network input of unesco_search_biosphere_reserves takes it."
},
"acronym": {
"type": "string",
"description": "Network acronym, also accepted by the regional_network input. Absent on the \"No regional network\" row."
},
"reserve_count": {
"type": "number",
"description": "Biosphere reserves in the network."
}
},
"description": "One MAB regional network, or the row counting reserves in none.",
"additionalProperties": false
},
"description": "MAB regional network rows (topic biosphere_networks)."
}
},
"additionalProperties": false
}unesco_list_reference annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}Prompts
0 advertised
Resources
1 advertised
unesco-heritage-guide
Gates and chains for the unesco_* tools over UNESCO's World Heritage List, intangible heritage lists, biosphere reserves, and Global Geoparks. Covers whether a landmark is World Heritage, what an empty result proves, coordinates for near searches, nearest-designation chains, keyword match tiers, inferred criterion (vi), intangible heritage linked to a site, and partial answers while a dataset cannot load. Use for any question about UNESCO-listed places or traditions.
unesco-heritage-guide URI
skill://unesco-heritage-guide/SKILL.mdunesco_site — World Heritage site record
One World Heritage site's full record by id_no, as unesco_get_site returns it with up to 20 components (components_total gives the full count) and the English description, plus a sources array carrying the dataset date, license, and UNESCO attribution. For the description in French, Spanish, Russian, Arabic, or Chinese, call unesco_get_site with description_language.
unesco_site URI template
unesco://site/{id_no}unesco_intangible_heritage_element — Intangible heritage element record
One Intangible Cultural Heritage element's full record by ich_ref, as unesco_get_intangible_heritage_element returns it with the English description, plus a sources array carrying the dataset date, license, and UNESCO attribution. For the French description, call unesco_get_intangible_heritage_element with description_language fr.
unesco_intangible_heritage_element URI template
unesco://intangible-heritage/{ich_ref}unesco_biosphere_reserve — Biosphere reserve record
One biosphere reserve's full record by mab_id, as unesco_get_biosphere_reserve returns it, plus a sources array carrying the dataset date, license, and UNESCO attribution.
unesco_biosphere_reserve URI template
unesco://biosphere-reserve/{mab_id}unesco_geopark — UNESCO Global Geopark record
One UNESCO Global Geopark's full record by ugg_id, as unesco_get_geopark returns it, plus a sources array carrying the dataset date, license, and UNESCO attribution.
unesco_geopark URI template
unesco://geopark/{ugg_id}io.modelcontextprotocol/skills
io.modelcontextprotocol/skills URI template
skill://{+path}90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 811 ms
- 95th percentile latency
- 811 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 811 ms · metadata changed · 9 tool(s), 1 resource(s), 5 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http unesco-heritage-mcp-server-caseyjhand https://unesco-heritage.caseyjhand.com/mcpCodex
Codex configuration
codex mcp add unesco-heritage-mcp-server-caseyjhand --url https://unesco-heritage.caseyjhand.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"unesco-heritage-mcp-server-caseyjhand": {
"url": "https://unesco-heritage.caseyjhand.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"unesco-heritage-mcp-server-caseyjhand": {
"type": "streamableHttp",
"url": "https://unesco-heritage.caseyjhand.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"unesco-heritage-mcp-server-caseyjhand": {
"type": "http",
"url": "https://unesco-heritage.caseyjhand.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http unesco-heritage-mcp-server-caseyjhand https://unesco-heritage.caseyjhand.com/mcpClaude Desktop
Claude Desktop configuration
https://unesco-heritage.caseyjhand.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"unesco-heritage-mcp-server-caseyjhand": {
"serverUrl": "https://unesco-heritage.caseyjhand.com/mcp"
}
}
}Let your agent find its tools
Find servers like unesco-heritage-mcp-server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.