# Ortho Earth

> Ortho Earth is an open-source MCP server for maps and travel. Facts, setup recipes and API types for the Ortho Earth open-source 3D globe. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, API, CLI
- **Website:** https://www.ortho-earth.com
- **Repository:** https://github.com/kenjiyoshidahome2026-bit/ortho-earth/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.kenjiyoshidahome2026-bit/ortho-earth
- **Categories:** maps and travel, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.ortho-earth.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ortho-earth": {
      "url": "https://www.ortho-earth.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ortho-earth
