Yatmo

npx add-mcp 'https://mcp.yatmo.com/mcp/v1'

Servidor MCP de Yatmo: datos de vecindario para asistentes y agentes de IA

Yatmo expone su inteligencia de vecindario a clientes de IA a través de un servidor remoto de MCP. Conecta Claude, Cursor, VS Code o tu propio agente, y puede responder "¿qué hay alrededor de esta propiedad?" con datos reales: escuela más cercana, guardería, supermercado, transporte público, estación de tren, acceso a autopista, distancias con tiempos de viaje y un párrafo resumen citable, en 25 países.

Este repositorio contiene configuraciones de cliente listas para copiar y un inicio rápido sin dependencias. El servidor en sí es operado por Yatmo en https://mcp.yatmo.com/mcp/v1 (HTTP Streamable). Documentación completa: documentation.yatmo.com/mcp.

Las cuatro herramientas

Herramienta	Devuelve
yatmo_get_location_summary	Un párrafo de vecindario legible por humanos más la escuela, guardería, supermercado, transporte más cercanos y el lugar geocodificado inversamente
yatmo_get_nearby_pois	Una lista ordenada de puntos de interés alrededor de una propiedad, opcionalmente filtrada por categoría, dentro de un radio
yatmo_get_nearest_by_category	El lugar más cercano de una categoría, con distancia y tiempo de viaje
yatmo_get_accessibility_profile	Presencia de transporte público, parada más cercana, estación de tren más cercana, acceso a autopista más cercano

Todas las herramientas aceptan latitude, longitude, country (BE, FR, UK...) y language, y devuelven el mismo formato: text (un resumen que el asistente puede citar), facts (datos estructurados), warnings y metadata. Las categorías usan un único vocabulario en todas partes: school, nursery, supermarket, public_transport, train_station, motorway. Detalles: referencia de herramientas.

Autenticación

Cada solicitud lleva tu clave backend de Yatmo en el encabezado LicenceKey (LicenseKey también se acepta). Mantén la clave en el almacén de secretos del cliente, nunca en una página web pública: la clave otorga acceso a tu cuenta de Yatmo. Obtén una clave en yatmo.com; claves explicadas.

Conecta un cliente

Configuración MCP remota genérica (configs/mcp.json), aceptada por la mayoría de los clientes, a veces bajo una clave principal ligeramente diferente:

{
  "mcpServers": {
    "yatmo": {
      "url": "https://mcp.yatmo.com/mcp/v1",
      "headers": { "LicenceKey": "YOUR_KEY" }
    }
  }
}

Claude.ai y Claude Desktop: Configuración > Conectores > Añadir conector personalizado, URL https://mcp.yatmo.com/mcp/v1, encabezado personalizado LicenceKey: YOUR_KEY. Las cuatro herramientas aparecen una vez que el conector está habilitado.

Claude Code:

claude mcp add --transport http yatmo https://mcp.yatmo.com/mcp/v1 --header "LicenceKey: YOUR_KEY"

Cursor: copia configs/cursor/mcp.json a .cursor/mcp.json en tu proyecto (o a ~/.cursor/mcp.json para cada proyecto).

VS Code (modo agente Copilot): copia configs/vscode/mcp.json a .vscode/mcp.json.

Tu propio agente (Anthropic, OpenAI o cualquier SDK de LLM): usa una biblioteca de cliente MCP (TypeScript, Python, .NET, Go) con el transporte HTTP Streamable, añade el encabezado LicenceKey al transporte y reenvía las cuatro definiciones de herramientas al modelo. quickstart.py muestra el protocolo crudo sin ninguna biblioteca.

Pruébalo desde la línea de comandos

export YATMO_KEY=your_backend_key
python3 quickstart.py          # initialize, list the tools, call yatmo_get_location_summary on a Brussels address
sh quickstart.sh               # the same three calls with curl

Prompts que funcionan bien

• "¿Cómo es el vecindario alrededor de 50.8467, 4.3525 en Bélgica? Responde en francés."
• "Escuela primaria y supermercado más cercanos a este anuncio, con tiempos de viaje a pie."
• "¿Está esta dirección bien servida por transporte público? ¿Estación de tren y acceso a autopista más cercanos?"
• "Lista los puntos de interés dentro de 800 m de la propiedad, solo escuelas y supermercados."

El asistente responde a partir del text y facts de las herramientas; las distancias vienen con el modo en el que se midieron.

Más

• Inicio rápido, autenticación y códigos de error, FAQ
• Los mismos datos para sitios web: plugins, WordPress, Odoo, SDK móviles, ejemplos

Licencia MIT para los archivos de este repositorio. Yatmo es un servicio de pago para portales inmobiliarios, redes de agencias y desarrolladores.

Directorios

El servidor está publicado en el registro oficial de MCP como com.yatmo/yatmo (server.json en este repositorio) y enviado al Catálogo MCP de Docker, Smithery y mcp.so. En clientes que leen el registro, busca "yatmo" o "real estate".