Yatmo

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

Servidor MCP Yatmo: dados de vizinhança para assistentes e agentes de IA

O Yatmo expõe sua inteligência de vizinhança para clientes de IA por meio de um servidor MCP remoto. Conecte Claude, Cursor, VS Code ou seu próprio agente, e ele poderá responder "o que existe ao redor desta propriedade?" com dados reais: escola mais próxima, creche, supermercado, transporte público, estação de trem, acesso a rodovia, distâncias com tempos de deslocamento e um parágrafo resumido citável, em 25 países.

Este repositório contém configurações de cliente prontas para copiar e um início rápido sem dependências. O servidor em si é operado pela Yatmo em https://mcp.yatmo.com/mcp/v1 (HTTP Streamable). Documentação completa: documentation.yatmo.com/mcp.

As quatro ferramentas

Ferramenta	Retorna
yatmo_get_location_summary	Um parágrafo de vizinhança legível por humanos, além da escola, creche, supermercado, transporte mais próximos e o local com geocodificação reversa
yatmo_get_nearby_pois	Uma lista ordenada de pontos de interesse ao redor de uma propriedade, opcionalmente filtrada por categoria, dentro de um raio
yatmo_get_nearest_by_category	O único local mais próximo de uma categoria, com distância e tempo de deslocamento
yatmo_get_accessibility_profile	Presença de transporte público, ponto de ônibus mais próximo, estação de trem mais próxima, acesso a rodovia mais próximo

Todas as ferramentas recebem latitude, longitude, country (BE, FR, UK...) e language, e retornam o mesmo envelope: text (um resumo que o assistente pode citar), facts (dados estruturados), warnings e metadata. As categorias usam um vocabulário único em todos os lugares: school, nursery, supermarket, public_transport, train_station, motorway. Detalhes: referência das ferramentas.

Autenticação

Cada requisição carrega sua chave backend Yatmo no cabeçalho LicenceKey (LicenseKey também é aceito). Mantenha a chave no armazenamento de segredos do cliente, nunca em uma página web pública: a chave concede acesso à sua conta Yatmo. Obtenha uma chave em yatmo.com; chaves explicadas.

Conecte um cliente

Configuração MCP remota genérica (configs/mcp.json), aceita pela maioria dos clientes, às vezes sob uma chave pai ligeiramente diferente:

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

Claude.ai e Claude Desktop: Configurações > Conectores > Adicionar conector personalizado, URL https://mcp.yatmo.com/mcp/v1, cabeçalho personalizado LicenceKey: YOUR_KEY. As quatro ferramentas aparecem assim que o conector é habilitado.

Claude Code:

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

Cursor: copie configs/cursor/mcp.json para .cursor/mcp.json no seu projeto (ou para ~/.cursor/mcp.json para todos os projetos).

VS Code (modo agente Copilot): copie configs/vscode/mcp.json para .vscode/mcp.json.

Seu próprio agente (Anthropic, OpenAI ou qualquer SDK de LLM): use uma biblioteca de cliente MCP (TypeScript, Python, .NET, Go) com o transporte HTTP Streamable, adicione o cabeçalho LicenceKey ao transporte e encaminhe as quatro definições de ferramentas ao modelo. quickstart.py mostra o protocolo bruto sem nenhuma biblioteca.

Experimente pela linha de comando

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 funcionam bem

• "Como é a vizinhança ao redor de 50.8467, 4.3525 na Bélgica? Responda em francês."
• "Escola primária e supermercado mais próximos deste anúncio, com tempos de deslocamento a pé."
• "Este endereço é bem servido por transporte público? Estação de trem e acesso a rodovia mais próximos?"
• "Liste os pontos de interesse dentro de 800 m da propriedade, apenas escolas e supermercados."

O assistente responde com base no text e facts das ferramentas; as distâncias vêm com o modo em que foram medidas.

Mais

• Início rápido, autenticação e códigos de erro, FAQ
• Os mesmos dados para sites: plugins, WordPress, Odoo, SDKs móveis, exemplos

Licença MIT para os arquivos deste repositório. Yatmo é um serviço pago para portais imobiliários, redes de agências e desenvolvedores.

Diretórios

O servidor está publicado no registro oficial MCP como com.yatmo/yatmo (server.json neste repositório) e submetido ao Docker MCP Catalog, Smithery e mcp.so. Em clientes que leem o registro, pesquise por "yatmo" ou "real estate".