VeryChic MCP

VeryChic MCP

Encontre, filtre e precifique ofertas de hotéis VeryChic a partir de qualquer cliente MCP

Navegue pelas ofertas atuais de vendas relâmpago, filtre-as por destino, país, preço, desconto, estrelas, voos, tema ou proximidade (e ordene os resultados), depois leia a disponibilidade e os preços de uma oferta por data. Somente leitura, anônimo, sem necessidade de conta.

Somente leitura e anônimo. Este servidor apenas pesquisa e lê ofertas — ele nunca reserva, nunca faz login e não usa credenciais. Um limite de taxa conservador (≥ 1 s entre solicitações) está incorporado ao cliente. Consulte o aviso legal para os termos de uso.

Demonstração

Adicionando o servidor hospedado VeryChic MCP ao Claude Desktop como um conector personalizado e, em seguida, solicitando ofertas na Espanha abaixo de €600:

▶ Assista em MP4

Início rápido

Adicione o servidor à configuração do seu cliente MCP. Com o uv instalado, não há nada para clonar ou instalar:

{
  "mcpServers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}

Isso executa o servidor via stdio, que é o que o Claude Desktop e o Claude Code usam. Você também pode executá-lo diretamente:

uvx verychic-mcp          # stdio (default)
uvx verychic-mcp --help   # all options

O mesmo par command/args funciona em todos os clientes stdio; apenas a configuração de encapsulamento difere. Essas configurações são para clientes locais (stdio). Para clientes em nuvem como claude.ai ou Cowork, que se conectam via HTTPS, consulte Uso a partir do Claude.ai ou Cowork.

claude mcp add verychic -- uvx verychic-mcp

{
  "mcpServers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}

{
  "servers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}

{
  "mcpServers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}

Ferramentas

Cada chamada é somente leitura e anônima, com um limite de taxa conservador incorporado ao cliente.

verychic_search_offers

Retorna as ofertas que correspondem a cada filtro que você passar (os filtros são combinados com AND).

verychic_offer_details

Retorna o conteúdo completo de uma oferta além, para hotéis, da disponibilidade e preços dia a dia.

Exemplos

Pergunte ao seu assistente coisas como:

• "Navegue pelas ofertas atuais da VeryChic."
• "Pesquise ofertas da VeryChic na Espanha abaixo de 600 euros."
• "Encontre hotéis spa de 5 estrelas com pelo menos 40% de desconto, do mais barato para o mais caro."
• "Mostre ofertas da VeryChic dentro de 300 km de Paris (48.8566, 2.3522), do mais próximo para o mais distante."
• "Obtenha os detalhes e preços por data para a oferta de hotel ORCHESTRA 44983."
• "Obtenha os detalhes para a oferta de pacote ORCHESTRA_TO 301375." Pacotes de operadora de turismo incluem voos com o hotel, então eles não expõem preços dia a dia da mesma forma que um hotel individual. A ferramenta ainda retorna o conteúdo e as vantagens da oferta, e define availabilities_supported: false para que um availabilities vazio seja lido como "não suportado para este tipo de oferta", e não "sem datas disponíveis".

As ofertas carregam um source (ORCHESTRA para um hotel, ORCHESTRA_TO para um pacote) e um external_id. Ambos retornam de verychic_search_offers, então o assistente pode passá-los para verychic_offer_details por conta própria.

Um resultado de verychic_search_offers é uma lista de objetos de oferta (um mostrado aqui, reduzido):

{
  "source": "ORCHESTRA",
  "external_id": 36509,
  "name": "Sofitel New York ****",
  "destination": "New York, États-Unis",
  "country": "États-Unis",
  "price": 182,
  "currency": "EUR",
  "discount": 57.0,
  "sales_mode": "FLASH",
  "offer_end_date": "2026-06-24T23:55+0200",
  "image": "https://.../sofitel-new-york.jpg",
  "advantages": ["Petit-déjeuner inclus", "VeryFlexible : réservez en toute sérénité !"],
  "offer_url": "https://www.verychic.fr/p/36509/etats-unis-new-york-hotel-sofitel-new-york"
}

verychic_offer_details adiciona gallery, included_added_values, um cheapest_price e o availabilities dia a dia para um hotel:

{
  "offer": { "source": "ORCHESTRA", "external_id": 44983, "name": "Hotel Kaktus Playa *****", "...": "..." },
  "cheapest_price": 169,
  "availabilities_supported": true,
  "availabilities": [
    { "date": "20/06/2026", "price": 169, "currency": "EUR", "nights": 1, "days": 2 },
    { "date": "21/06/2026", "price": 169, "currency": "EUR", "nights": 1, "days": 2 }
  ]
}

Uso a partir do Claude.ai ou Cowork

Diferente dos clientes locais em Início rápido, clientes em nuvem como claude.ai e Cowork só se conectam a servidores MCP remotos via HTTPS, não a um processo local. Para usar o VeryChic MCP lá, hospede-o você mesmo no modo streamable-http (verychic-mcp --transport streamable-http, atrás de HTTPS) e adicione-o como um conector personalizado, colando a URL da sua implantação com o caminho /mcp.

Uma instância pública está implantada por conveniência em https://verychic-mcp.fly.dev/mcp. Adicione-a como um conector personalizado no claude.ai/Cowork, ou conecte-a a um cliente local que fale MCP remoto:

{
  "mcpServers": {
    "verychic": {
      "url": "https://verychic-mcp.fly.dev/mcp"
    }
  }
}

Ela é fornecida no melhor esforço e pode ser pausada ou limitada por taxa a qualquer momento — para qualquer coisa além de um teste rápido, execute sua própria instância com o comando uvx acima ou hospede o modo streamable-http.

A listagem no diretório oficial de conectores da Anthropic (ao lado de Booking ou Tripadvisor) está fora do escopo. Esse diretório é reservado para integrações de parceiros que passam por uma revisão que este tipo de ferramenta não passaria.

Como funciona

O aplicativo web da VeryChic conversa com uma API JSON pública sob https://api.verychic.com/verychic-endpoints/v1 (mais search.verychic.com). Este servidor reproduz essas mesmas chamadas com uma impressão digital TLS semelhante à de um navegador (curl_cffi), analisa as respostas em objetos tipados e as expõe como ferramentas MCP. Tudo funciona sem fazer login. O único parâmetro de solicitação volátil, channelVersion, é lido do site ao vivo na inicialização e recorre a um valor conhecido se essa leitura falhar.

Desenvolvimento

git clone https://github.com/jordantete/verychic-mcp.git && cd verychic-mcp
pip install -e ".[dev]"
pytest                  # offline tests, run against recorded fixtures
pytest -m network       # optional smoke test against the live API, low volume
ruff check verychic_mcp tests

Os lançamentos são orientados por tags. Enviar uma tag vX.Y.Z executa os testes, compila o pacote e o publica no PyPI por meio do GitHub Actions com publicação confiável, então nenhum token é armazenado em qualquer lugar.

Aviso legal

O VeryChic MCP não é afiliado, endossado ou conectado à VeryChic ou à VeryChic SAS. É uma ferramenta comunitária independente para uso pessoal que lê a API web pública da VeryChic da mesma forma que um navegador faz. Você é responsável por cumprir os termos de venda da VeryChic, notadamente o Artigo 9 sobre propriedade intelectual e o direito sui generis do produtor do banco de dados. Use por sua conta e risco, apenas para navegação pessoal e de baixo volume. Não use para extração em massa ou redistribuição dos dados da VeryChic.

Licença

MIT. Consulte LICENSE.