io.github.cyanheads/elevation-mcp-server
v0.2.0Look up elevation worldwide, profile route ascent/descent, grid areas, check terrain line of sight.
Endpoint health
online- Last checked
- 11/20/2026, 9:18:01 AM
- Latency
- 272 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Felevation-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/elevation-mcp-server": {
"url": "https://elevation.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
4 shown · authentication unknown
Check Terrain Line of Sight
elevation_check_line_of_sight
Check whether terrain blocks the straight sightline between an observer and a target, each at a height above the ground, accounting for earth curvature and atmospheric refraction. Returns a verdict of clear, blocked, or indeterminate (when samples along the line have no data), the minimum clearance and the terrain point that limits it, and the first obstruction from the observer when blocked. With frequency_mhz, it also reports first Fresnel zone clearance against the 60% free-space bar. Where Mapzen reports sea-floor depth over open water, clearance is measured to the sea surface; USGS 3DEP values below 0 m (bay floor in some bays, or dry land) count as received unless water_surface_m sets a water level. Models terrain only: buildings and vegetation are not modeled beyond what the elevation source itself captures, and a ridge narrower than the reported sample spacing can be missed. To see the terrain between the points, call elevation_get_profile on the same two points.
Schema valid · SHA-256 ff2c0a165e21…
View input schema
{ "type": "object", "properties": { "observer": { "description": "Observer location as {lat, lon} in decimal degrees (WGS84).", "type": "object", "properties": { "lat": { "type": "number", "minimum": -90, "maximum": 90, "description": "Latitude in decimal degrees (WGS84), -90 to 90." }, "lon": { "type": "number", "minimum": -180, "maximum": 180, "description": "Longitude in decimal degrees (WGS84), -180 to 180." } }, "required": [ "lat", "lon" ] }, "target": { "description": "Target location as {lat, lon} in decimal degrees (WGS84).", "type": "object", "properties": { "lat": { "type": "number", "minimum": -90, "maximum": 90, "description": "Latitude in decimal degrees (WGS84), -90 to 90." }, "lon": { "type": "number", "minimum": -180, "maximum": 180, "description": "Longitude in decimal degrees (WGS84), -180 to 180." } }, "required": [ "lat", "lon" ] }, "observer_height_m": { "description": "Observer eye or antenna height above ground, meters (default 1.7, standing eye height).", "default": 1.7, "type": "number", "minimum": 0, "maximum": 10000 }, "target_height_m": { "description": "Target height above ground, meters (default 0, the ground itself). Set it for a tower, building top, or second antenna.", "default": 0, "type": "number", "minimum": 0, "maximum": 10000 }, "earth_model": { "description": "Earth model: flat ignores curvature; geometric applies curvature without refraction; optical applies standard visible-light refraction (coefficient 0.13, default); radio applies the standard 4/3-earth radio refraction (coefficient 0.25).", "default": "optical", "type": "string", "enum": [ "flat", "geometric", "optical", "radio" ] }, "samples": { "description": "Evenly spaced terrain samples along the line, endpoints included (3–250, default 100). Spacing is reported; a ridge narrower than it can be missed.", "default": 100, "type": "integer", "minimum": 3, "maximum": 250 }, "water_surface_m": { "description": "Water level in meters (-500 to 9,000). When set, each sample's surface, endpoints included, is the higher of its elevation and this level, replacing the default that lifts only Mapzen sea-floor values to 0 m. Requires a vertical reference compatible with the sampled terrain; choosing zero or source opentopodata alone does not establish compatibility. No datum conversion is performed.", "type": "number", "minimum": -500, "maximum": 9000 }, "frequency_mhz": { "description": "Radio frequency in MHz (30–300,000; 5800 for 5.8 GHz). When set, the result adds first Fresnel zone clearance against the 60% free-space bar; pair it with earth_model radio.", "type": "number", "minimum": 30, "maximum": 300000 }, "source": { "description": "Elevation source: auto (default) uses USGS 3DEP where it has data and Open Topo Data (SRTM, with Mapzen terrain tiles where SRTM has no data) for the rest; usgs_3dep uses 3DEP only; opentopodata uses Open Topo Data only. Case is ignored and spaces or hyphens read as underscores, so USGS-3DEP and open topo data are accepted; 3dep, usgs, and epqs are also aliases for usgs_3dep.", "default": "auto", "type": "string", "enum": [ "auto", "usgs_3dep", "opentopodata" ] } }, "required": [ "observer", "target" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }
Connections
streamable-http
https://elevation.caseyjhand.com/mcp