MCP App Store
by KeenEthics
Vinellu icon

Vinellu MCP Server for ChatGPT

By Vinellu

Overview

O Vinellu é a rede social do vinho. Este app dá ao ChatGPT acesso ao acervo de 174 mil rótulos, com ficha técnica completa (produtor, país, região, denominação, uva, tipo, corpo, acidez, tanino, doçura e harmonização) e as avaliações da comunidade. Sem conectar conta, você já pode buscar um rótulo por nome, produtor, uva ou região, pedir harmonização para um prato e ver onde comprar. Conectando sua conta Vinellu, o ChatGPT passa a ler e escrever os seus dados. Adega, reviews, lista de quero tomar, curtidas, perfil de gosto, recomendações, check-in do que você está bebendo e pedidos de amizade. Toda escrita que altera ou remove alguma coisa passa por duas etapas. O app mostra em português o que vai fazer e só executa depois que você concorda. Precisa de conta no Vinellu, criada no aplicativo para iOS e Android. O login acontece no site do Vinellu com código de uso único, e sua senha nunca passa pelo ChatGPT. Você desconecta quando quiser em vinellu.com/mcp/conectados. Conteúdo em português. O catálogo cobre rótulos do Brasil, Argentina, Chile, França, Itália, Portugal, Espanha e outros.

How to connect

  1. ChatGPT: Open the Vinellu listing in the ChatGPT app directory and choose Connect. ChatGPT listing Vinellu exposes 43 tools here.

Tools

aceitar_pedido

ChatGPT
Aceita um pedido de amizade recebido. user_id é quem mandou. Exige conta conectada com o escopo amigos.

achar_contatos_no_vinellu

ChatGPT
Descobre quem da agenda da pessoa já tem conta no Vinellu. ACEITA SÓ HASH, NUNCA E-MAIL: pra cada endereço, calcule sha256(email) onde o e-mail está em minúsculas e sem espaço nas pontas, e mande o digest em hexadecimal minúsculo. Ex: sha256('ana@exemplo.com'). Mandar e-mail cru é recusado. O servidor registra só a CONTAGEM de hashes e de matches, nunca os hashes. Já exclui você, contas apagadas, quem já é seu amigo e bloqueios nos dois sentidos. Teto de 2000 por chamada. Exige conta conectada com o escopo amigos.

adicionar_na_adega

ChatGPT
Soma garrafas na adega da pessoa. Reversível: preparar_consumo + confirmar_consumo desfazem. Exige conta conectada com o escopo adega.

anexar_foto_rotulo

ChatGPT
Anexa uma foto (JPEG, PNG ou WebP) ao rótulo indicado por public_id, pra quando você já sabe qual rótulo é (por exemplo, veio de buscar_vinho ou ficha_do_rotulo antes) e só falta a imagem. A foto só vira a imagem pública do rótulo quando ele ainda não tem imagem e direitos_confirmados é verdadeiro. Só marque direitos_confirmados depois que a pessoa disser, na conversa, que tem os direitos sobre a foto. Sem isso, ou se o rótulo já tiver imagem, a tool diz o motivo e não grava. Anexar a foto conta como abrir a ficha desse rótulo. Exige conta conectada com o escopo imagens.

buscar_pessoa

ChatGPT
Busca usuários pelo nome de exibição. Só perfis públicos — quem marcou perfil privado ou só-amigos não aparece. Exige conta conectada com o escopo amigos.

buscar_vinho

ChatGPT
Busca rótulos no acervo do Vinellu (174 mil) por nome, produtor, uva, região ou descrição em linguagem natural. Use isto antes de qualquer outra ferramenta que peça public_id. Não precisa de conta conectada.

confirmar_ajuste

ChatGPT
Executa o ajuste preparado por preparar_ajuste. Só chame depois de mostrar o resumo e a pessoa concordar. Exige conta conectada com o escopo adega.

confirmar_checkin

ChatGPT
Registra o check-in preparado por preparar_checkin e publica o post no feed. Só chame depois de mostrar o resumo e a pessoa concordar. Exige conta conectada com o escopo reviews.

confirmar_consumo

ChatGPT
Executa a baixa preparada por preparar_consumo. Só chame depois de mostrar o resumo e a pessoa concordar. Exige conta conectada com o escopo adega.

confirmar_pedidos

ChatGPT
Envia os pedidos preparados por preparar_pedidos. Só chame depois de mostrar os nomes e a pessoa concordar. Exige conta conectada com o escopo amigos.

curtir

ChatGPT
Curte um rótulo. Curtida de RÓTULO é sinal de gosto pro motor de recomendação — não é interação com pessoa e não notifica ninguém. Exige conta conectada com o escopo desejos.

descurtir

ChatGPT
Remove a curtida de um rótulo. Exige conta conectada com o escopo desejos.

desfazer_ultima_acao

ChatGPT
Desfaz a última escrita REVERSÍVEL feita por este servidor nos últimos 15 minutos (adicionar na adega, quero tomar, curtir, registrar review). Baixa e ajuste de adega não entram: eles já passam por confirmação em duas fases. Exige conta conectada com o escopo adega.

editar_review

ChatGPT
Edita uma review da própria pessoa. Só os campos enviados mudam. Pegue o review_id em minhas_reviews. Exige conta conectada com o escopo reviews.

ficha_do_rotulo

ChatGPT
Ficha completa de um rótulo: produtor, país, região, uvas, tipo, teor alcoólico, perfil sensorial, harmonizações e as safras com nota da crítica e preço observado.

harmonizar

ChatGPT
Dado um prato, devolve rótulos do acervo que harmonizam. Conhece 21 conceitos curados (churrasco, cordeiro, frutos do mar, queijos, sushi…); prato fora deles cai numa busca pelo termo cru nas harmonizações dos rótulos.

lista_de_rotulos

ChatGPT
Casa VÁRIOS rótulos de uma vez com o acervo do Vinellu e ordena pela afinidade com o gosto da pessoa. Serve os dois casos: prateleira de mercado e carta de restaurante. Mande em rotulos o que VOCÊ leu, um rótulo por linha, com safra e preço quando aparecerem. Não mande imagem nem base64. Pra um rótulo só, use que_vinho_e_esse. Rótulo que o Vinellu não conhece volta com no_acervo: false em vez de desaparecer. Diga isso, não ofereça um parecido no lugar. Consome a cota diária de IA da conta. Exige conta conectada com o escopo leitura.

meu_convite

ChatGPT
Devolve o link de convite da pessoa (/i/<código>) e um texto pronto pra ela mandar pra quem quiser. QUEM MANDA A MENSAGEM É A PESSOA: o Vinellu não envia e-mail, WhatsApp nem notificação pra ninguém. Mostre o texto e o link e deixe ela colar no canal dela. Não peça o contato do amigo, você não vai precisar. Quem entrar por esse link já vira amigo dela no Vinellu. Exige conta conectada com o escopo leitura.

meu_perfil_de_gosto

ChatGPT
O que o Vinellu inferiu sobre o gosto da pessoa a partir do histórico dela: uvas, tipos e países que mais aparecem nas reviews boas, e quantas interações sustentam isso. Exige conta conectada com o escopo leitura.

meus_comentarios

ChatGPT
Os comentários que a pessoa escreveu em posts e em reviews (de qualquer pessoa), do mais recente pro mais antigo, com o rótulo de cada um quando dá pra achar. sem_review=true devolve só os comentários cujo rótulo a própria pessoa ainda não avaliou. paginacao.proximo_offset é o offset da próxima chamada; paginacao.tem_mais diz se há mais. Exige conta conectada com o escopo leitura.

meus_curtidos

ChatGPT
Os rótulos que a pessoa curtiu. Curtida de rótulo é sinal de gosto pro motor de recomendação (não é interação social). Exige conta conectada com o escopo leitura.

meus_pedidos_pendentes

ChatGPT
Pedidos de amizade recebidos e enviados que ainda não foram respondidos. Exige conta conectada com o escopo leitura.

minha_adega

ChatGPT
As garrafas que a pessoa tem em casa: rótulo, safra, quantidade, prateleira e a janela de apogeu de cada uma. filtro é uma busca por texto em título, produtor, tipo ou local. Exige conta conectada com o escopo leitura.

minha_lista_de_desejos

ChatGPT
Os rótulos que a pessoa marcou como 'quero tomar'. Exige conta conectada com o escopo leitura.

minhas_conquistas

ChatGPT
Badges desbloqueados e o progresso nos que faltam. Exige conta conectada com o escopo leitura.

minhas_preferencias

ChatGPT
Configuração da conta: visibilidade do perfil e se a localização aparece. SÓ LEITURA — mudar preferência é no app. Agente mexendo em configuração é o tipo de coisa que a pessoa descobre três dias depois sem entender o que houve. Exige conta conectada com o escopo leitura.

minhas_recomendacoes

ChatGPT
As recomendações que o Vinellu gerou pra pessoa nesta semana, com o motivo de cada uma. Se ainda não houver recomendação da semana, gera na hora. Exige conta conectada com o escopo leitura.

minhas_reviews

ChatGPT
As avaliações que a pessoa escreveu, da mais recente pra mais antiga. Exige conta conectada com o escopo leitura.

o_que_meus_amigos_beberam

ChatGPT
As reviews mais recentes dos amigos da pessoa. Só quem tem amizade aceita. Exige conta conectada com o escopo leitura.

o_que_tomei

ChatGPT
Os rótulos que a pessoa tomou num dia. Junta o check-in ('tomando agora', certeza) e as reviews escritas no dia (indício — pode ser vinho de outro dia). Cada rótulo diz em origens de onde veio, e a resposta deve respeitar essa diferença. Exige conta conectada com o escopo leitura.

onde_comprar

ChatGPT
Lojas parceiras do Vinellu Shop que têm o rótulo em estoque, da mais barata pra mais cara. uf filtra por quem entrega no estado. Devolve o endereço da loja; a compra acontece lá, fora daqui. Bebida alcoólica, venda proibida para menores de 18 anos.

onde_comprar_para_mim

ChatGPT
Igual a onde_comprar, mas já filtrado pelas lojas que entregam no estado do perfil da pessoa, sem precisar perguntar onde ela mora. Bebida alcoólica, venda proibida para menores de 18 anos. Exige conta conectada com o escopo leitura.

preparar_ajuste

ChatGPT
Primeira fase de SOBRESCREVER a quantidade de uma entrada da adega. Não muda nada: devolve resumo e token. Ajuste engole o valor anterior sem deixar rastro no estado — mostre o resumo antes de confirmar. Exige conta conectada com o escopo adega.

preparar_checkin

ChatGPT
Primeira fase de marcar que a pessoa está bebendo um rótulo AGORA. NÃO registra nada: devolve um resumo em português e um token. MOSTRE o resumo — ele avisa que o check-in VAI VIRAR POST no feed — e só chame confirmar_checkin depois que ela concordar. O token vale 2 minutos e serve uma vez só. Exige conta conectada com o escopo reviews.

preparar_consumo

ChatGPT
Primeira fase de dar baixa. NÃO mexe no estoque: devolve um resumo em português e um token. MOSTRE o resumo pra pessoa e só chame confirmar_consumo depois que ela concordar. O token vale 2 minutos e serve uma vez só. Exige conta conectada com o escopo adega.

preparar_pedidos

ChatGPT
Primeira fase de mandar pedido de amizade. NÃO manda nada: devolve os NOMES de quem receberia e um token. MOSTRE a lista de nomes pra pessoa e só chame confirmar_pedidos depois que ela concordar. Lote máximo de 10. O pedido não carrega mensagem — texto endereçado a estranho não entra por aqui. Exige conta conectada com o escopo amigos.

quando_beber

ChatGPT
Sem argumento, varre a adega inteira e diz quais garrafas estão dentro da janela de apogeu agora (e quais ainda vão chegar lá ou já passaram). Com public_id, devolve a janela de apogeu daquele rótulo. É a pergunta que ninguém abre app pra responder e todo mundo faz antes do jantar. Exige conta conectada com o escopo leitura.

que_vinho_e_esse

ChatGPT
Casa o texto de UM rótulo com o acervo de 174 mil do Vinellu, rankeado pelo gosto da pessoa. Mande em texto_do_rotulo o que VOCÊ leu no rótulo (produtor, nome, safra, região, uva), como está escrito na garrafa. Não mande imagem nem base64: a leitura da foto é sua, o casamento com o acervo é nosso. Serve garrafa na mão, na prateleira ou na mesa. Pra vários rótulos de uma vez (prateleira inteira, carta), use lista_de_rotulos. Quando a resposta vier sem certeza, pergunte qual é em vez de escolher o primeiro candidato. Consome a cota diária de IA da conta. Exige conta conectada com o escopo leitura.

quero_tomar

ChatGPT
Marca um rótulo como 'quero tomar'. Aceita public_id OU nome em texto livre — com nome, o servidor resolve por busca e devolve QUAL rótulo casou, pra você confirmar com a pessoa. Reversível com tirar_dos_desejos. Exige conta conectada com o escopo desejos.

recusar_pedido

ChatGPT
Recusa um pedido de amizade recebido. user_id é quem mandou. Exige conta conectada com o escopo amigos.

registrar_review

ChatGPT
Cria uma avaliação de 1 a 5 do rótulo, na conta da pessoa. Se a pessoa já avaliou esse rótulo, atualiza a review existente em vez de criar outra. Editável depois com editar_review. Exige conta conectada com o escopo reviews.

tirar_dos_desejos

ChatGPT
Remove um rótulo da lista de 'quero tomar'. Exige conta conectada com o escopo desejos.

vinhos_por

ChatGPT
Lista rótulos de um país, região, uva ou tipo. Mesma consulta dos hubs públicos do site. O slug aceita tanto o slug da URL (estados-unidos) quanto o valor cru (United States).

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/vinellu"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/vinellu)