Loqal

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Profissionais de serviços locais no Brasil: encanador, eletricista, diarista e +270 tipos

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Loqal": {
      "url": "https://api.loqal.com.br/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• search_services read-only

  Mapeia uma necessidade em linguagem natural ("cano da pia vazando", "limpar ar-condicionado") para os serviços da Loqal. Use quando não estiver claro qual profissional resolve.

  Parameters:

  • need (required) — string — A necessidade, com as palavras do usuário

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_categories read-only

  Setores e nichos da Loqal (285 tipos de serviço), com quantos profissionais reais atendem. Filtre por setor (slug) ou por lugar para ver só o que existe ali.

  Parameters:

  • where — string
  • sector — string — slug do setor, ex.: reformas-e-reparos

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• check_coverage read-only

  Diz se a Loqal reconhece um lugar (bairro, cidade, UF em todo o Brasil) e quantos profissionais reais atendem ali, no geral ou para uma necessidade. Use antes de prometer algo ao usuário.

  Parameters:

  • where (required) — string
  • need — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_providers read-only

  Encontra profissionais reais perto de um lugar para uma necessidade. Ex.: need="instalar 3 ventiladores", where="Tijuca, Rio de Janeiro", min_rating=4.5, max_price_brl=350. Retorna perfis estruturados (nota, avaliações, distância, preço quando informado) e uma tela com cards.

  Parameters:

  • need (required) — string — O que o usuário precisa, com as palavras dele
  • lat — number — Latitude (busca geolocalizada: use com lng quando o usuário compartilhar a localização)
  • lng — number
  • sort — string
  • limit — integer
  • niche — string — Slug exato do tipo de profissional (de list_categories), ex.: "motorista", "pedreiro". Quando informado, vence a interpretação do texto.
  • where — string — Bairro e/ou cidade, ex.: "Tijuca, Rio de Janeiro" ou "Pinheiros SP"
  • service — string — Subcategoria exata, a service_key de search_services (ex.: "piscina/limpeza"). Prioriza quem faz exatamente isso, sem esconder o resto do tipo.
  • radius_km — number — Raio da busca em km a partir de lat/lng ou do lugar (padrão: 5 a 15 km conforme o lugar)
  • min_rating — number
  • min_reviews — integer
  • emergency_24h — boolean — Só quem atende 24 horas / emergência
  • max_price_brl — number — Mantém quem não informou preço (cobra por orçamento)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_provider read-only

  Perfil completo de um profissional (slug vindo de find_providers): serviços com aliases e preço inicial, bairros atendidos, nota com a fonte, avaliações recentes, ações e o índice de preparo para IAs (agent_readiness).

  Parameters:

  • slug (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• compare_providers read-only

  Compara lado a lado 2 a 6 profissionais (slugs) para uma necessidade: nota, avaliações, distância, preço informado, 24h, verificação. Não inventa: "não informado" quando a Loqal não sabe.

  Parameters:

  • slugs (required) — array
  • need — string
  • where — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• estimate_job read-only

  Estima quanto vai custar um serviço específico descrito pelo usuário (ex.: "instalar ar split de 12 mil BTUs no 7º andar, sem infraestrutura, na Tijuca"), separando mão de obra, material e deslocamento, com as premissas e o que falta para refinar. Usa o Índice de Preços Loqal e preços reais publicados por profissionais quando existem (base=indice_loqal|precos_reais); sem eles, é uma referência de mercado (base=ia). É estimativa, não orçamento. Antes de chamar, se faltar o detalhe que mais muda o preço (tamanho, quantidade, m², BTUs), pergunte ao usuário.

  Parameters:

  • need (required) — string — O caso com os detalhes do usuário
  • niche — string — slug do tipo de profissional (search_services/list_categories); se omitido, a Loqal entende pelo texto
  • where — string — Bairro e cidade, ou cidade e UF
  • details — array — Respostas do usuário que mudam o preço, ex.: "12.000 BTUs", "7º andar"

  Hints: read-only yes · destructive no · idempotent no · open-world no

• estimate_price read-only

  Faixa de preço de um serviço numa região, só com preços reais: dos profissionais perto (5 ou mais) ou do Índice de Preços Loqal (preços publicados pelos próprios negócios, por estado ou nacional; source=indice_loqal, com página de referência). Sem dados suficientes, diz que não há e não inventa valores.

  Parameters:

  • need (required) — string
  • where — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_request read-only

  Situação de um pedido pelo código (LQ-XXXX): status e profissionais que receberam. Respostas de orçamento chegam no WhatsApp do usuário.

  Parameters:

  • code (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• rate_service

  Registra a avaliação do usuário para um profissional que recebeu o pedido dele (código LQ-XXXX). Só aceita avaliação ligada a um pedido real: é o que torna a reputação da Loqal confiável.

  Parameters:

  • code (required) — string
  • provider (required) — string — slug
  • rating (required) — integer
  • comment — string

  Hints: read-only no · destructive no · idempotent no · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.