addGeoJsonLayer
Add a styled GeoJSON Point, LineString, or Polygon layer. Returns { success, data: { id, name, type, visible, color, dataRefId? }, message? }; use id with highlight.
LABSCO SUMMARY
The globe stays in the browser; the assistant just steers it.
Every tool returns a { success } object and hands back an entityId or layer id you carry into the next call, so a session builds up state you can query and clear rather than firing blind commands. The toolset split is the real economy here: 62 tools would swamp a model's context, so only four groups load by default and the rest come on by name when a request actually reaches for terrain, animation or 3D Tiles.
What it is
An MCP server that controls a CesiumJS Viewer: 62 command tools grouped into 12 toolsets, plus list_toolsets and enable_toolset for turning groups on as you need them. It ships its own browser Viewer and the bridge that runs the commands, so the default path is one package.
What you get
- Camera moved either way — flyTo animates to a point, setView jumps there instantly, getView reads back longitude, latitude, height, heading, pitch and roll, and zoomToExtent frames a west/south/east/north box
- Viewpoints saved by name in the page with saveViewpoint, loadViewpoint and listViewpoints, and the whole view, layer and entity state dumped to JSON via exportScene
- Entities placed and edited: addMarker, addLabel, addModel for glTF/GLB, addPolygon and addPolyline; each returns an entityId you keep for updateEntity or removeEntity, and batchAddEntities does a set in one call
- queryEntities finds them by name, type or geographic extent, and getEntityProperties reads one back in full
- GeoJSON added as a styled layer with addGeoJsonLayer, or as Cesium primitives with addGeoJsonPrimitive when the dataset is large enough that entities would bog the browser down
- Layers managed as a set — listLayers, getLayerSchema for fields and counts, setLayerVisibility, updateLayerStyle, removeLayer, and clearAll to wipe the scene
- setBasemap switches the base imagery, highlight picks out one feature or a whole layer, measure returns distance or area with its unit, and screenshot captures the view as a base64 PNG
- Toolsets you turn on only when the job needs them: camera (orbit, lookAt), entity-ext (box, cylinder, wall), animation (waypoints, clock, tracking), tiles (3D Tiles, Gaussian Splats, terrain, imagery, CZML, KML), trajectory, heatmap, scene, and geolocation for turning a place name into coordinates via Nominatim/OSM
- list_toolsets and enable_toolset let the model discover and switch on a group at runtime, so a normal request stays under a couple dozen tools instead of carrying all 62
Requirements
Node with npx, and nothing to sign up for on the default path: npx -y cesium-mcp-runtime starts the server and serves the built-in Viewer at http://localhost:9100/, with CesiumJS assets loading from the official Cesium CDN. Four core toolsets (30 tools) are on out of the box; set CESIUM_TOOLSETS=all to load every group. A separate cesium-mcp-bridge install is only for driving your own CesiumJS page rather than the bundled Viewer, and a Cesium Ion credential is optional, used only by the scene toolset.
Setup effort
One command — npx -y cesium-mcp-runtime
USE CASES
01
Taking someone to a place and marking it
Name a landmark and it geocodes the place, flies the camera there, and drops a labelled marker you can move or remove afterwards — the demo's own 'fly to the Eiffel Tower and drop a red marker' in one pass.
02
Putting a dataset on the globe
Load a GeoJSON file as a styled layer, inspect its fields and feature count, then restyle or hide it — and switch to primitives when the dataset is large enough to slow the page down.
03
Sketching a route and measuring it
Draw the path from a list of coordinates, measure its length, and frame the whole thing in view before capturing it as an image to hand off.
04
Reaching for terrain and 3D Tiles
Turn on the tiles toolset when a scene needs real elevation or a tileset — the model can discover the group and enable it mid-session rather than you configuring anything up front.
05
Bookmarking views to compare
Save the current camera under a name, move somewhere else, and jump back — building up a set of viewpoints you can list and return to across the session.
06
Building a scene up and tearing it down
Add many entities at once, find and inspect the ones you need by extent or type, then clear everything to start clean and see exactly how many layers and entities went away.
33 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
addGeoJsonPrimitive
Render GeoJSON as Cesium primitives for large browser datasets. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
addLabel
Add property-based text labels for GeoJSON features. Returns { success, data: { labelCount: integer }, message? }.
addMarker
Add a point marker at geographic coordinates. Returns { success, data: { entityId }, message? }; keep entityId for removeEntity.
addModel
Add a glTF or GLB model at geographic coordinates. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
addPolygon
Draw a polygon area from geographic coordinate tuples. Returns { success, data: { entityId }, message? }; keep entityId for removeEntity.
addPolyline
Draw a path or route from geographic coordinate tuples. Returns { success, data: { entityId }, message? }; keep entityId for removeEntity.
batchAddEntities
Add multiple supported entities in one page operation. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
clearAll
Clear all layers, entities, animations, and trajectories from the scene. Returns { success, data: { removedLayers, removedEntities }, message? }.
enable_toolset
Enable a tool group to make its tools available. Call list_toolsets first to see available groups.
exportScene
Export the current view, layer, and entity state as JSON. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
flyTo
Animate the camera to a geographic location. Use for visible navigation requested by the user. Returns { success: boolean, message?: string, error?: string }.
getEntityProperties
Read the properties and graphics metadata for one entity. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
getLayerSchema
Inspect fields, entity counts, and metadata for a layer. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
getView
Get the current camera position and orientation. Returns { success, data: { longitude, latitude, height, heading, pitch, roll }, message? }.
highlight
Highlight one feature or every feature in a GeoJSON layer. Returns { success: boolean, message?: string, error?: string }.
list_toolsets
List all available tool groups and their enabled status. Call this to discover additional capabilities before asking the user to configure anything.
listLayers
List all layers currently managed by the page. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
listSessions
List all connected browser sessions (ID and connection state) for multi-browser routing
listViewpoints
List camera viewpoints saved in the current page. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
loadViewpoint
Restore a previously saved page-local camera state. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
measure
Measure distance or area between geographic coordinate tuples. Returns { success, data: { mode, value, unit, segments?, id? }, message? }.
queryEntities
Query page entities by name, type, or geographic extent. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
removeEntity
Remove one entity created by an entity tool. Returns { success, message? } or { success: false, error } when entityId is not found.
removeLayer
Remove a managed layer from the page. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
saveViewpoint
Save the current camera state under a page-local name. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
screenshot
Capture the current Cesium map view as a PNG image. Returns { success, data: { dataUrl, width, height }, message? }; dataUrl is a base64 PNG.
setBasemap
Switch the visible basemap style. Returns { success, data: { basemap }, message? }.
setLayerVisibility
Show or hide a managed layer. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
setView
Set the camera position immediately without animation. Use for deterministic setup or instant view changes. Returns { success: boolean, message?: string, error?: string }.
updateEntity
Update the position, appearance, label, or visibility of an entity. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
updateLayerStyle
Update vector, imagery, primitive, or 3D Tiles styling for a layer. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
zoomToExtent
Animate the camera to a west/south/east/north bounding box. Returns { success: boolean, data?: unknown, message?: string, error?: string }.
BEFORE YOU INSTALL
What to know first
Tools you get
33 tools when we connected; the project documents 65. Default mode loads 4 core toolsets (30 tools) plus list_toolsets, enable_toolset and listSessions. Set CESIUM_TOOLSETS=all, or let the agent enable toolsets at runtime, to get the rest.
Requires
npx on PATH
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y cesium-mcp-runtimeMCP Clients
Claude Desktop, Cursor, Dify
JSON
{
"mcpServers": {
"cesium": {
"command": "npx",
"args": [
"-y",
"cesium-mcp-runtime"
]
}
}
}HTTP server
HTTP SERVER · TERMINAL
npx -y cesium-mcp-runtime --transport http --port 3000Browser agent demo
Open the hosted demo at https://cesium-browser-agent.pages.dev/ and ask, for example, "Fly to the Eiffel Tower and drop a red marker" — no install, no signup and no browser API key
To run your own copy, fork the examples/browser-agent folder of https://github.com/gaopengbin/cesium-mcp and deploy it
