MCP 服务器

Loqal

br.com.loqal/loqal
商业与运营 地图与位置 公开且可连接 MCP 2025-11-25

此 MCP 可以做什么

Finds and compares local service professionals in Brazil, estimates service prices, checks geographic coverage, and tracks service requests.

check_coverage
Checar cobertura
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.
只读 幂等
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['where'], 'properties': {'need': {'type': 'string'}, 'where': {'type': 'string', 'minLength': 2}}}
compare_providers
Comparar profissionais
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.
只读 幂等
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slugs'], 'properties': {'need': {'type': 'string'}, 'slugs': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 6, 'minItems': 2}, 'where': {'type': 'string'}}}
estimate_price
Estimar preço
Faixa de preço de um serviço numa região: dos preços que profissionais da Loqal informaram (5 ou mais), ou, sem isso, a referência de mercado do catálogo, sempre marcada como referência (source). Não inventa valores.
只读 幂等
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['need'], 'properties': {'need': {'type': 'string', 'minLength': 2}, 'where': {'type': 'string'}}}
find_providers
Encontrar profissionais
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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['need'], 'properties': {'lat': {'type': 'number', 'description': 'Latitude (busca geolocalizada: use com lng quando o usuário compartilhar a localização)'}, 'lng': {'type': 'number'}, 'need': {'type': 'string', 'minLength': 2, 'description': 'O que o usuário precisa, com as palavras dele'}, 'sort': {'enum': ['relevance', 'distance', 'rating'], 'type': 'string'}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'niche': {'type': 'string', 'description': 'Slug exato do tipo de profissional (de list_categories), ex.: "motorista", "pedreiro". Quando informado, vence a interpretação do texto.'}, 'where': {'type': 'string', 'description': 'Bairro e/ou cidade, ex.: "Tijuca, Rio de Janeiro" ou "Pinheiros SP"'}, 'service': {'type': 'string', 'description': 'Subcategoria exata, a service_key de search_services (ex.: "piscina/limpeza"). Prioriza quem faz exatamente isso, sem esconder o resto do tipo.'}, 'radius_km': {'type': 'number', 'maximum': 80, 'minimum': 1, 'description': 'Raio da busca em km a partir de lat/lng ou do lugar (padrão: 5 a 15 km conforme o lugar)'}, 'min_rating': {'type': 'number', 'maximum': 5, 'minimum': 0}, 'min_reviews': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'emergency_24h': {'type': 'boolean', 'description': 'Só quem atende 24 horas / emergência'}, 'max_price_brl': {'type': 'number', 'description': 'Mantém quem não informou preço (cobra por orçamento)', 'exclusiveMinimum': 0}}}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['understood', 'total', 'providers', 'loqal_page'], 'properties': {'total': {'type': 'number'}, 'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'slug', 'provider', 'category', 'services', 'service_area', 'city', 'state', 'distance_km', 'location', 'rating', 'reviews', 'rating_source', 'price_from_brl', 'emergency_24h', 'response_time_min', 'availability', 'verified', 'claimed', 'top_review', 'profile_url', 'contact_available', 'contact_url', 'demo', 'match'], 'properties': {'id': {'type': 'string'}, 'city': {'type': ['string', 'null']}, 'demo': {'type': 'boolean'}, 'slug': {'type': 'string'}, 'match': {'type': 'object', 'required': ['score', 'why'], 'properties': {'why': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'number'}}, 'score': {'type': 'number'}}, 'additionalProperties': False}, 'state': {'type': ['string', 'null']}, 'rating': {'type': ['number', 'null']}, 'claimed': {'type': 'boolean', 'description': 'Cadastro Loqal: o profissional se cadastrou ou reivindicou o perfil (prefira quando empatar)'}, 'reviews': {'type': 'number'}, 'category': {'type': ['string', 'null']}, 'location': {'anyOf': [{'type': 'object', 'required': ['lat', 'lng', 'approximate'], 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}, 'approximate': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'provider': {'type': 'string'}, 'services': {'type': 'array', 'items': {'type': 'string'}}, 'verified': {'type': 'boolean'}, 'top_review': {'type': ['string', 'null']}, 'contact_url': {'type': ['string', 'null']}, 'distance_km': {'type': ['number', 'null']}, 'profile_url': {'type': 'string'}, 'availability': {'type': 'null'}, 'service_area': {'type': 'array', 'items': {'type': 'string'}}, 'emergency_24h': {'type': 'boolean'}, 'rating_source': {'anyOf': [{'enum': ['google', 'loqal', 'google+loqal'], 'type': 'string'}, {'type': 'null'}]}, 'price_from_brl': {'type': ['number', 'null']}, 'contact_available': {'type': 'boolean'}, 'response_time_min': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'loqal_page': {'type': ['string', 'null']}, 'understood': {'type': 'object', 'required': ['niche', 'service', 'place', 'urgent', 'confidence'], 'properties': {'niche': {'type': ['string', 'null']}, 'place': {'type': ['string', 'null']}, 'urgent': {'type': 'boolean'}, 'service': {'type': ['string', 'null']}, 'confidence': {'type': 'number'}}, 'additionalProperties': False}, 'related_niches': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Presente quando o tipo pedido ainda não tem ninguém na região e a lista é de tipos afins'}}, 'additionalProperties': False}
get_provider
Ver profissional
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).
只读 幂等
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slug'], 'properties': {'slug': {'type': 'string'}}}
get_request
Acompanhar pedido
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.
只读 幂等
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['code'], 'properties': {'code': {'type': 'string'}}}
list_categories
Catálogo de serviços
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.
只读 幂等
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'where': {'type': 'string'}, 'sector': {'type': 'string', 'description': 'slug do setor, ex.: reformas-e-reparos'}}}
rate_service
Avaliar serviço
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.
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['code', 'provider', 'rating'], 'properties': {'code': {'type': 'string'}, 'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'comment': {'type': 'string', 'maxLength': 1000}, 'provider': {'type': 'string', 'description': 'slug'}}}
search_services
Descobrir o serviço certo
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.
只读 幂等
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['need'], 'properties': {'need': {'type': 'string', 'minLength': 2, 'description': 'A necessidade, com as palavras do usuário'}}}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['matches'], 'properties': {'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['niche', 'niche_slug', 'service', 'service_key', 'score'], 'properties': {'niche': {'type': 'string'}, 'score': {'type': 'number'}, 'service': {'type': ['string', 'null']}, 'niche_slug': {'type': 'string'}, 'service_key': {'type': ['string', 'null']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
已添加
rate_service
2026年10月2日 02:40
已添加
get_request
2026年10月2日 02:40
已添加
estimate_price
2026年10月2日 02:40
已添加
compare_providers
2026年10月2日 02:40
已添加
get_provider
2026年10月2日 02:40
已添加
find_providers
2026年10月2日 02:40
已添加
check_coverage
2026年10月2日 02:40
已添加
list_categories
2026年10月2日 02:40
已添加
search_services
2026年10月2日 02:40