@embed-earth/mcp-test

@embed-earth/mcp-test

The EmbedEarth MCP server gives agents Search, Compute, Routing, Maps, and Stratum tools for the physical world.

npx -y @embed-earth/mcp-test

Modes

Mode	Purpose
auto	Use verified local Stratum data first, then Cloud.
offline	Use verified local Stratum data only.
cloud	Use EmbedEarth Cloud; requires an API key.

Pass mode to e2_search, e2_compute, or the query operation of e2_stratum.

API key

Get an API key at embed.earth, then configure it as E2_API_KEY in the MCP host environment. Cloud mode and Street View image URLs require it.

Search

e2_search returns GeoJSON records.

{ "feature": "restaurant", "area": "New York", "mode": "auto", "limit": 25 }

{ "feature": ["restaurant", "hospital"], "area_id": "4915", "mode": "cloud", "limit": 100 }

Compute

Primitive	Purpose
NEAREST	Find closest selected features.
DISTANCE	Measure distances between features.
WITHIN	Find features inside a relation distance.
COUNT	Count features that meet a relation.
DENSITY	Measure feature concentration.
COVERAGE	Measure reached area.
GAPS	Find uncovered places.
CLUSTER	Group nearby features.

Routing

Set ROUTE_URL only when the MCP host needs a custom compatible router.

e2_route_to_feature accepts from: [lat, lng] and a feature such as restaurant. It selects the coordinate’s area, narrows candidates through H3, and routes to the directly closest result.

{ "feature": "restaurant", "from": [40.74, -73.99], "mode": "walking" }

e2_route provides route, matrix, isochrone, mapMatch, locate, and height.

Maps

e2_map_sources returns MapLibre-ready Planet and feature source descriptors.

Stratum

e2_stratum combines geographic lookup, verified local data, server pulls, and local storage.

Operation	Required inputs	Purpose
cacheList, cacheSet, cacheDelete, cacheClear	size or key when applicable	Manage verified local data.
featureList, featureSearch, featureInfo	query or feature when applicable	Look up built-in geographical features.
areaList, areaSearch, areaInfo	query or id when applicable	Look up built-in geographical areas.
dataList, dataInfo	feature for info	Inspect published data.
download	feature, optional area_id, optional output	Pull a stratum.
query	feature, optional area_id, mode	Query Cloud or verified local data.
upload	path, database	Add local GeoJSON, CSV, or Parquet.

{
  "operation": "upload",
  "path": "./stores.geojson",
  "database": "./stores.db",
  "feature": "stores",
  "namespace": "my-app"
}

This creates local:my-app:stores, separate from built-in feature keys.

Geographical Features

View geographical features.

Geographical Areas

View geographical areas.

Other EmbedEarth interfaces

• SDK package — typed application code.
• CLI package — terminal workflows.