Guía rápida

Dos caminos: llamar a la API REST desde código, o añadir el servidor MCP a un agente de IA. Ambos usan la misma cuenta y las mismas 100 llamadas gratuitas al mes.

Llamar a la API desde código

Crear una clave de API

1. Inicia sesión en terra-lab.ai/login. Una cuenta es gratuita y no requiere tarjeta.
2. Abre Dashboard, MCP, luego Advanced, API keys.
3. Ponle un nombre a la clave, acepta los términos de la API y haz clic en Create key.
4. Copia la clave ahora: empieza por tlk_ y solo se muestra una vez.

Guárdala en una variable de entorno, nunca en tu código:

export TERRALAB_API_KEY="tlk_your_key_here"

Comprobar la clave

GET /v1/me devuelve tu cuenta y las llamadas que te quedan este mes.

curl https://mcp.terra-lab.ai/v1/me \
  -H "Authorization: Bearer $TERRALAB_API_KEY"

Un 401 significa que la clave falta, está mal escrita o ha sido revocada.

Hacer tu primera llamada a una herramienta

Busca las coordenadas de una dirección con find_places:

curl -X POST https://mcp.terra-lab.ai/v1/tools/find_places \
  -H "Authorization: Bearer $TERRALAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"12 rue de la Paix, Annecy"}'

import os
import requests

response = requests.post(
    "https://mcp.terra-lab.ai/v1/tools/find_places",
    headers={"Authorization": f"Bearer {os.environ['TERRALAB_API_KEY']}"},
    json={"query": "12 rue de la Paix, Annecy"},
    timeout=120,
)
response.raise_for_status()
print(response.json()["structuredContent"])

const response = await fetch('https://mcp.terra-lab.ai/v1/tools/find_places', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TERRALAB_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ query: '12 rue de la Paix, Annecy' }),
});
const data = await response.json();
console.log(data.structuredContent);

La respuesta es un objeto JSON: structuredContent contiene el resultado con sus sources, content el mismo resultado como texto, e isError indica si la herramienta rechazó la solicitud.

Ir más lejos

• Extrae edificios y carreteras de un área con extract_open_data.
• Obtén la elevación, un perfil o curvas de nivel con get_elevation.
• Explora las 29 herramientas en la referencia de la API.

Añadir TerraLab a un agente de IA

En Claude Code, un solo comando:

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

Después ejecuta /mcp en Claude Code e inicia sesión en TerraLab. Para Claude, ChatGPT, Cursor, Codex y VS Code, consulta Servidor MCP.

Pregunta, por ejemplo: "Muestra los edificios a menos de 500 m de la estación de Lyon Part-Dieu y dame un GeoPackage."