Terrain Viewer
Features

MCP Server

Ask Claude or another assistant for a place in plain words and get the Terrain Viewer view in the conversation, through a server it can call

Paste this in the Claude desktop app to install it and start:

Set up the Terrain Viewer MCP server on this computer. Clone https://github.com/Iconem/terrain-viewer, run pnpm install at its root and again in its mcp folder, then pnpm build in mcp. Add it to my Claude Desktop configuration file (claude_desktop_config.json, under mcpServers) as terrain-viewer, with the command node and the arguments <path of the clone>/mcp/server.mjs and --stdio. Keep what the file already holds. Tell me when to restart Claude. After the restart I will ask: show me the slope of the terrain around the Matterhorn in 3D.

It needs git, Node 20 or later, pnpm and Google Chrome on the computer. Claude runs the commands and asks before each one unless you allowed them. After the restart, ask in your own words; no tool has to be named.

The skill teaches an assistant to write a link. The server goes further: the assistant can look things up (where a place is, which datasets cover it, which dated images exist) and the result shows in the conversation.

What you can ask

  • "Show me the slope of the terrain around the Matterhorn in 3D."
  • "I am looking for ancient earthworks in the forest of the Veluwe. Which elevation data is best there, and show it so they stand out."
  • "Which satellite images exist over Antakya after the February 2023 earthquake? Show the most recent."
  • "Compare the surface model and the ground model over Amsterdam."
  • "How high is the Matterhorn above Zermatt, and how steep is the line between them?"
  • "Give me a GeoTIFF of the elevation around Mont Blanc."

Tools

ToolWhat it does
open_viewA place and modes, shown in the conversation, with the link that opens it
compare_sourcesOne place twice, side by side or as an overlay: two terrain datasets, or the imagery of two dates
geocodeA place name to coordinates (OpenStreetMap)
datasets_coveringThe terrain datasets of the library that cover a point, finest first, and the imagery catalogs that have something there
catalog_itemsDated satellite and aerial images and old maps for an area, from the catalogs the timeline reads
imagery_datesThe capture dates of the built-in dated imagery at a place: Esri Wayback and Google Earth historical
search_stacItems of any STAC API or static catalog over an area
elevationThe height of points, or a profile along a line, on one or several datasets
export_geotiffThe elevation of an area as a GeoTIFF file (32-bit float, EPSG:3857)
screenshotA picture of a view, so the assistant can look at the terrain itself

elevation and export_geotiff read tile datasets (Mapterhorn, AWS, Terrarium and Terrain-RGB pyramids). A dataset served as a COG, a WMS or a VRT is read by the app alone: the assistant opens it with open_view, and its Download section exports it.

By hand

git clone https://github.com/Iconem/terrain-viewer
cd terrain-viewer && pnpm install
cd mcp && pnpm install && pnpm build

Claude Desktop: Settings, Developer, Edit Config, then restart the app.

{
  "mcpServers": {
    "terrain-viewer": { "command": "node", "args": ["/path/to/terrain-viewer/mcp/server.mjs", "--stdio"] }
  }
}

Claude Code:

claude mcp add terrain-viewer -- node /path/to/terrain-viewer/mcp/server.mjs --stdio

claude.ai and ChatGPT reach a server by its address, not on your computer: run pnpm start in mcp (it listens on http://localhost:3300/mcp), put it behind a public HTTPS address, and add that address as a custom connector.

What shows in the conversation

Three displays, picked by what the view needs and what the host allows, with buttons to switch:

  • Interactive map: a map drawn in the conversation itself, to pan, zoom and tilt. It draws hillshade, 3D terrain and satellite imagery on the tile datasets. A view that needs nothing else opens this way.
  • Exact picture: the view with every mode asked for (slope, local relief model, sky-view factor, dated imagery, a split), rendered by the server in a few seconds. A view that needs the app's computed modes opens this way, with the interactive map one click away.
  • Live app: the app itself, in its embed layout. Claude frames a website inside a conversation only for some connectors: never for a server that runs on your computer, and for a server reached by its address only after you allow the site, in organizations where the feature is on (Claude's documentation).

Open in the browser always opens the full app, at the place the interactive map was moved to.

The server's own notes, with the files and what was tested, are in mcp/README.md.

On this page