ScoutingAPI — conecte o servidor MCP
O ScoutingAPI disponibiliza um servidor Model Context Protocol nativo para que um agente possa consultar dados de acomodações no Airbnb, Booking.com, Vrbo e Google Hotels como ferramentas de primeira classe — sem necessidade de colar chave de API no agente.
- URL do servidor: https://mcp.scoutingapi.com (transporte HTTP Streamable).
- Autenticação: OAuth 2.1 + PKCE (S256) com registro dinâmico de cliente. Você autoriza uma vez em um pop-up do navegador; o conector é vinculado à sua conta do ScoutingAPI e ao seu saldo de créditos.
- Metadados do recurso protegido OAuth (RFC 9728): https://mcp.scoutingapi.com/.well-known/oauth-protected-resource
Conectar (Claude.ai / Claude Desktop / Claude Code)
- Abra as configurações do conector do seu agente e adicione um conector personalizado (servidor MCP).
- Use a URL
https://mcp.scoutingapi.com. - Complete o prompt OAuth no pop-up do navegador — isso vincula o conector à sua conta do ScoutingAPI. (Usuários iniciantes: crie uma conta e verifique o e-mail primeiro; uma conta sandbox funciona para avaliação. Veja https://scoutingapi.com/docs/mcp.)
- As sete ferramentas abaixo ficam disponíveis para o agente.
As sete ferramentas somente leitura
search_stays— pesquise estadias em várias plataformas por local, datas, ocupação, filtros.check_availability— disponibilidade dia a dia para uma listagem conhecida em um intervalo de datas.get_listing— detalhes completos de uma listagem (comodidades, fotos, anfitrião, avaliações).get_price— uma cotação de preço real para uma listagem com datas e ocupação específicas.compare_prices— compare uma propriedade entre OTAs com o mínimo e a mediana calculados.get_reviews— avaliações normalizadas e paginadas para uma listagem em uma plataforma.get_job— consulte o status e obtenha os resultados de um trabalho de scraping assíncrono (custa 0).
Comportamento assíncrono
As ferramentas compartilham o mesmo contrato assíncrono da REST: uma chamada ao vivo que precisa fazer scraping retorna um trabalho pendente; o agente (ou a camada de ferramenta) consulta get_job com o jobId retornado até que ele seja concluído, e a carga útil do resultado chega em data.result. Acessos sandbox e em cache retornam imediatamente.
Créditos e limites
As chamadas MCP consomem do mesmo saldo único de créditos que suas chaves REST, mas são limitadas por taxa em um bucket separado por usuário. Custos e limites de taxa: https://scoutingapi.com/pricing.
MCP vs REST — qual usar
- MCP — melhor para agentes/assistentes interativos (ex.: Claude) que suportam conectores: OAuth em vez de gerenciamento de chaves, ferramentas expostas nativamente ao modelo.
- REST (habilidade: scoutingapi-search) — melhor para backends programáticos, servidores, tarefas agendadas e qualquer runtime sem suporte a MCP: uma chave Bearer + o
@scoutingapi/sdk.
Ambos acessam os mesmos dados e o mesmo esquema unificado. Documentação: https://scoutingapi.com/docs/mcp.