# Connect an agent

> Index of the TerraLab docs for agents: [llms.txt](https://terra-lab.ai/docs/llms.txt). Every docs page is also served as markdown: add .md to its URL.

TerraLab is a remote MCP server over Streamable HTTP. One URL works in every agent:

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

The first time, your agent asks you to sign in to TerraLab. Your free calls and balance show on [Dashboard, MCP](https://terra-lab.ai/dashboard/mcp).

## Claude

Open the prefilled dialog: [add TerraLab to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TerraLab&connectorUrl=https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp). Click **Add**, then **Connect**, and sign in to TerraLab.

Or in Claude, open **Settings**, **Connectors**, **Add custom connector**, and paste the server URL.

## ChatGPT

Open the [TerraLab app in ChatGPT](https://chatgpt.com/apps/terralab/asdk_app_6abeb2f16190819199cc1be0ed69e8d4), click **Add**, then start your message with `@TerraLab`.

## Claude Code

Run this in your terminal:

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

Then run `/mcp` in Claude Code and sign in to TerraLab. Ready-made GIS workflows come as a plugin:

```text
/plugin marketplace add TerraLabAI/mcp
/plugin install terralab@terralab-ai-apps
```

## Codex

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

Codex adds the server and opens the TerraLab sign-in in your browser. It then works in the CLI, the IDE extension and the app. The same entry in `~/.codex/config.toml`:

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

## Cursor

Open the install link: [add TerraLab to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=terralab&config=eyJ1cmwiOiJodHRwczovL21jcC50ZXJyYS1sYWIuYWkvbWNwIn0%3D). Cursor shows the server: click **Install**, then sign in when it asks.

Or add a remote server in Cursor's MCP settings, in `.cursor/mcp.json`:

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

## VS Code

Open the install link: [add TerraLab to VS Code](vscode:mcp/install?%7B%22name%22%3A%22terralab%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp%22%7D). Click **Install**, sign in to TerraLab, then ask Copilot in agent mode.

Or in `.vscode/mcp.json`:

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

## Other agents

Add a remote MCP server with the URL above in any agent that takes one; it opens the TerraLab sign-in. Gemini CLI:

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

## Tools

The server exposes 29 tools. Each one is documented with its parameters and a request example in the [API reference](https://terra-lab.ai/docs/api): the MCP tool and the REST endpoint share the same name and arguments.

- **Places**: [Find places and addresses](https://terra-lab.ai/docs/api/find_places), [Convert coordinates](https://terra-lab.ai/docs/api/convert_coordinates), [Measure distance, area, radius or buffer](https://terra-lab.ai/docs/api/measure)
- **Map data**: [Extract open map data for an area](https://terra-lab.ai/docs/api/extract_open_data), [Open, map and convert GIS data](https://terra-lab.ai/docs/api/open_gis_file), [Buffer, merge, clip or simplify features](https://terra-lab.ai/docs/api/process_geometry)
- **Terrain and routes**: [Elevation, profile and contour lines](https://terra-lab.ai/docs/api/get_elevation), [Road route between places](https://terra-lab.ai/docs/api/get_route), [Area reachable in a travel time](https://terra-lab.ai/docs/api/get_travel_area)
- **Imagery and land**: [Satellite image of an area](https://terra-lab.ai/docs/api/get_satellite_image), [Forest type (natural, planted, plantation)](https://terra-lab.ai/docs/api/get_forest_type), [Estimate the population of an area](https://terra-lab.ai/docs/api/estimate_population)
- **France**: [French cadastral parcel and zoning](https://terra-lab.ai/docs/api/french_parcel), [French building heights](https://terra-lab.ai/docs/api/french_building_heights), [Natural risks at an address or a point](https://terra-lab.ai/docs/api/get_natural_risks)
- **Data catalog**: [Find a dataset in the TerraLab catalogue](https://terra-lab.ai/docs/api/find_datasets), [Extract a hosted dataset for an area](https://terra-lab.ai/docs/api/extract_dataset), [Ask TerraLab to add data it does not have](https://terra-lab.ai/docs/api/request_data)

## What to ask

- "Find the coordinates of these 40 addresses and give me a CSV for QGIS."
- "Extract the buildings and roads within 1 km of Annecy station as a GeoPackage."
- "Elevation profile from Chamonix to the Aiguille du Midi."
- "Which natural risks apply at 12 rue de la Paix, Annecy?"

Answers show a map in the chat when the agent supports it, and give files that open in QGIS, ArcGIS or Google Earth.

## Troubleshooting

- **TerraLab shows as connected in Claude but has no tools.** If you added it before October 26, 2026, remove the connector and add it again: Claude then offers the TerraLab sign-in.
- **The agent says the free calls are used.** Top up on [Dashboard, MCP](https://terra-lab.ai/dashboard/mcp) or wait for the 1st of the month. See [Pricing and free calls](https://terra-lab.ai/docs/pricing).
- **A tool answers with an error.** Its `message` and `hint` say what to change. See [Errors and rate limits](https://terra-lab.ai/docs/errors).

Source: https://terra-lab.ai/docs/mcp · Updated 2026-10-27