# TerraLab MCP server

> Geocode addresses, convert coordinates, get elevation, extract open map data, convert GIS files and look up French parcels.

- Listing: https://mcp.tc/i/terralab
- Connect: use the server's own URL `https://mcp.terra-lab.ai/mcp` (OAuth sign-in at the server); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: OAuth sign-in
- Category: [Travel & Maps](https://mcp.tc/c/travel-maps)
- Vendor: TerraLab
- Homepage: <https://terra-lab.ai/>

## About

TerraLab provides geospatial tools built on open data. You can place addresses and places on a map, convert coordinates between formats and projections, get elevation profiles and contour lines, extract OpenStreetMap-based data for an area, open and convert GIS files, and look up French cadastral parcels with zoning. Results name their sources and licences.

It runs as a hosted streamable HTTP endpoint at https://mcp.terra-lab.ai/mcp. No sign-in or API key is needed. All six tools are read-only.

## What it can do

- Geocode addresses and places, including lists of up to 100
- Convert coordinates between DD, DMS, UTM, MGRS and EPSG projections
- Get elevation points, profiles, contour lines and slope statistics
- Extract open map data for an area as GeoJSON, KML, Shapefile or CSV
- Open, inspect and convert GIS files up to 50 MB
- Find French cadastral parcels and PLU zoning

## Tools (13)

- `find_places`: Geocode places and addresses, or reverse geocode, and show them on a map with CSV, KML and GeoJSON. (read-only)
- `convert_coordinates`: Convert up to 1,000 coordinate lines between common formats and projections. (read-only)
- `get_elevation`: Elevation for points, path profiles, and contour lines and slope for an area. (read-only)
- `extract_open_data`: Extract open map data such as buildings, roads or POIs for an area, with licence. (read-only)
- `open_gis_file`: Inspect, map and convert GIS files like GeoJSON, KML, GPX, Shapefile and CSV. (read-only)
- `french_parcel`: Find the French cadastral parcel and local urban plan zone at an address or point. (read-only)
- `measure`: Use this when the user wants a straight-line (as the crow flies) distance between places with midpoint and bearing, the length of a drawn line, the area and perimeter of a polygon, a circle of a given radius around a… (read-only)
- `french_building_heights`: Use this when the user asks how tall the buildings are around an address or in a small area in France: height in metres per building, floors, main use, year built and ground altitude, from IGN BD TOPO. (read-only)
- `get_route`: Use this when the user wants the driving, walking or cycling route between 2 to 25 places or points in order: the distance and travel time along the roads and paths, per leg and in total, and the route line. (read-only)
- `get_travel_area`: Use this when the user wants the area reachable from 1 to 10 places within a travel time or a distance along the roads (an isochrone, catchment or service area): for example everything within 5, 10 and 20 minutes on… (read-only)
- `process_geometry`: Use this when the user wants to apply one GIS operation to a set of features (an uploaded file, a link, inline GeoJSON, or a download link from another TerraLab answer) and get the result as a file: buffer every… (read-only)
- `get_satellite_image`: Use this when the user wants a satellite image or aerial photo of an area as a file for QGIS: a recent true colour picture, a false colour image, or NDVI to see vegetation, crops or forest health. (read-only)
- `get_forest_type`: Use this when the user asks whether a forest is natural, primary, naturally regenerating, planted, a plantation or tree crops (oil palm, cocoa, coffee, rubber, orchards, agroforestry), for example for EUDR due… (read-only)

## Example prompts

- "Put these 20 addresses on a map and give me a CSV for QGIS"
- "Convert 48.8584, 2.2945 to UTM and Lambert 93"
- "How steep is the terrain within 2 km of this location?"
- "Which cadastral parcel and PLU zone is at 10 rue de Rivoli, Paris?"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http terralab https://mcp.terra-lab.ai/mcp
```

2. Start Claude Code, type `/mcp`, pick **terralab** and choose **Authenticate**. A browser window opens for the TerraLab sign-in.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.

2. Name it **TerraLab** and paste this URL:

```url
https://mcp.terra-lab.ai/mcp
```

3. Click **Add**, then **Connect**, and sign in when TerraLab asks.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TerraLab&connectorUrl=https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://mcp.terra-lab.ai/mcp` and click **Add**.

3. Click **Connect** and sign in when TerraLab asks.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.

2. Enter a name for the server.

3. Under **Connection**, paste `https://mcp.terra-lab.ai/mcp` as the server URL, then for authentication choose **OAuth**. ChatGPT sends you to TerraLab to sign in.

4. Check **I understand and want to continue**, then select **Create as a plugin**.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=terralab&config=eyJ1cmwiOiJodHRwczovL21jcC50ZXJyYS1sYWIuYWkvbWNwIn0%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "terralab": {
      "url": "https://mcp.terra-lab.ai/mcp"
    }
  }
}
```

Cursor shows **Needs authentication** next to the server. Click the button beside it to sign in.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=terralab&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"terralab","type":"http","url":"https://mcp.terra-lab.ai/mcp"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "terralab": {
      "type": "http",
      "url": "https://mcp.terra-lab.ai/mcp"
    }
  }
}
```

VS Code asks you to sign in the first time the server starts.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "terralab": {
      "serverUrl": "https://mcp.terra-lab.ai/mcp"
    }
  }
}
```

2. Refresh the MCP server list in Cascade and sign in when asked.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add terralab --url https://mcp.terra-lab.ai/mcp
codex mcp login terralab
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.terralab]
url = "https://mcp.terra-lab.ai/mcp"
```

### Gemini CLI

```bash
gemini mcp add --transport http terralab https://mcp.terra-lab.ai/mcp
```

Then, inside Gemini CLI, run `/mcp auth terralab` to sign in.

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "terralab": {
      "type": "http",
      "url": "https://mcp.terra-lab.ai/mcp"
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://mcp.terra-lab.ai/mcp`.

## Recent changes

- 2026-10-24 13:43 UTC: 1 tool added. Source: automatic check. Added: get\_forest\_type.
- 2026-10-23 13:46 UTC: 6 tools added and 1 tool changed. Server instructions changed. Source: automatic check. Worth a look: new server instructions. Added: french\_building\_heights, get\_route, get\_satellite\_image, get\_travel\_area, measure, process\_geometry. Changed: extract\_open\_data.
- 2026-10-19 13:38 UTC: 6 tools changed. Source: automatic check. Changed: convert\_coordinates, extract\_open\_data, find\_places, french\_parcel, get\_elevation, open\_gis\_file.
- 2026-10-19 10:42 UTC: 1 tool changed. Source: automatic check. Changed: get\_elevation.
- 2026-10-11 10:29 UTC: Tracking started: 6 tools read. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/terralab#history (Atom feed: https://mcp.tc/i/terralab/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 1.0.0
- MCP protocol version: 2025-11-25
- Last checked: 2026-11-18 (reachable, asks for credentials)
- Listed: 2026-10-11
- Updated: 2026-10-30

---
Source: https://mcp.tc/i/terralab (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
