Skip to content
MCP server

Ortho Earth

Facts, setup recipes and API types for the Ortho Earth open-source 3D globe

Pricing
Open source
Platforms
Web, API, CLI
Runs
Locally or Remotely
Version
0.1.0
Listing updated
3 days ago

About Ortho Earth

Ortho Earth is an open-source MCP server for maps and travel. It can run locally on your machine or as a hosted remote server.

This server is for developers and AI coding agents who want to put Ortho Earth's browser globe into a project without guessing. Instead of searching docs by hand, the agent asks for the current version, a tested starter recipe, or the exact TypeScript declaration of an API such as createGlobe or flyTo.

Ortho Earth is an open-source WebGPU globe whose API follows MapLibre GL JS, with 3D Tiles and true-scale terrain. The server reports how many official MapLibre and CesiumJS examples run unchanged and links side-by-side comparisons, so an agent can judge a migration before starting it.

It runs either as a remote Streamable HTTP endpoint or locally through npx with Node.js 18 or later. The ORTHO_EARTH_BASE variable changes where it reads files from.

Install

Run in a terminal

claude mcp add --transport http ortho-earth https://www.ortho-earth.com/mcp

Add to Settings → Connectors → Add custom connector

https://www.ortho-earth.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ortho-earth": {
      "url": "https://www.ortho-earth.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ortho-earth": {
      "type": "http",
      "url": "https://www.ortho-earth.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ortho-earth": {
      "serverUrl": "https://www.ortho-earth.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ortho-earth": {
      "type": "http",
      "url": "https://www.ortho-earth.com/mcp"
    }
  }
}

Tools this server provides (7)

Read directly from the server.

get_facts
Latest version and release date, npm packages, licenses, and how many official MapLibre GL JS and CesiumJS examples run unchanged on Ortho Earth. Rebuilt on every deploy of www.ortho-earth.com. Call this before stating a version number or a compatibility figure.
search_docs
Full-text search over the Ortho Earth documentation (the recipe, the changelog, migration guides from MapLibre GL JS, CesiumJS, Leaflet and Google Maps, the engine overview, GeoPBF, Gint, comparison articles). Returns the best matching sections with their source page.
get_started
The step-by-step recipe for putting the Ortho Earth globe in a web page, with the exact file contents. Every step is run by an automated test against the published npm packages. route "vite" = npm + Vite project with @ortho-earth/globe (recommended); route "html" = a plain HTML page without a bundler.
check_compat
Looks up how the official MapLibre GL JS examples and CesiumJS Sandcastle examples matching the query run on Ortho Earth (same picture / same answers / runs partly / does not run), with notes and links to side-by-side comparisons, and how MapLibre style properties are read (e.g. "fill-extrusion", "line-dasharray").
lookup_api
Returns the TypeScript declaration (with its doc comment) of an Ortho Earth API from the published types: createGlobe and its options (globe.d.ts), the map object it returns (globe-map.ts), and the MapLibre-compatible facade (maplibre.d.ts). Doc comments are partly in Japanese.
view_link
Makes a www.ortho-earth.com link that opens the 3D globe at a place, and the matching view string for createGlobe({ view }). zoom uses the same scale as the view string (about 0–2 for the whole Earth, 12 for a city). app "japan" adds Japan's detailed basemap and PLATEAU 3D buildings.
list_apps
The apps and demos on www.ortho-earth.com, each with its link and a one-line description. Useful for showing what the engine can do.

What it does

Version and licence facts
get_facts returns the latest release, packages, licences and compatibility counts.
Tested starter recipes
get_started returns exact file contents for a Vite or plain HTML setup.
Compatibility checks
check_compat shows how MapLibre and CesiumJS examples run on Ortho Earth.
API declarations
lookup_api returns TypeScript declarations with doc comments.
Docs search
search_docs does full-text search over recipes, changelog and migration guides.
View links
view_link builds a link that opens the globe at a given place.

Good for

  • Scaffold a Vite project with a 3D globe
  • Check whether a MapLibre example will run before porting it
  • Look up the signature of createGlobe options
  • Share a link to a specific globe view

Pricing

Open source

Open-source globe; free in education

Prices change. Check ortho-earth.com before you buy.

Ortho Earth FAQ

Does it need an account or API key?

No. The remote endpoint and the npx package are described as needing neither, and the globe itself needs no account or server.

How do I add it to Claude Code?

Run claude mcp add --transport http ortho-earth https://www.ortho-earth.com/mcp, or use npx -y @ortho-earth/mcp for a local copy.

Which Node version is needed locally?

Node.js 18 or later.

Is the globe free?

The site says it is open source and free to use in education.

Is Ortho Earth free?

Yes. Ortho Earth is open source, so you can use and self-host it for free.

How do I add Ortho Earth to Claude Code?

Run this command in your terminal: claude mcp add --transport http ortho-earth https://www.ortho-earth.com/mcp

What are the best alternatives to Ortho Earth?

The closest alternatives to Ortho Earth are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Ortho Earth

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools