Conecte seu agente às ofertas exclusivas para clientes que chegam por IA.
O MCP público do Existo entrega Ofertas para Agentes ativas: preço para agente, benefícios negociáveis, validade e um link que leva o cliente ao WhatsApp da loja com um código de origem verificável.
https://backend.existo.app/api/mcp/public- Somente leitura
- Sem autenticação
- Streamable HTTP, JSON
- Só ofertas ativas e confirmadas
Como um agente usa
Quatro passos, nesta ordem. As três primeiras são ferramentas do MCP; a última é um link.
buscar_ofertasProcura ofertas ativas por produto, serviço, categoria ou cidade. Pode filtrar por loja com public_handle.
detalhar_ofertaTraz as condições completas: preço público, preço para agente, pagamento, entrega, regiões e validade.
negociar_ofertaQuando o cliente pede algo (desconto no Pix, frete), diz se o benefício é permitido e qual condição apresentar.
preferred_action_urlO agente envia o cliente a esse link. Ele abre o WhatsApp da loja com um código AG- que comprova a origem.
Usar no Claude
- Abra as configurações do Claude e procure Conectores.
- Escolha adicionar um conector personalizado.
- Dê o nome Existo e cole o endpoint https://backend.existo.app/api/mcp/public.
- Salve e peça, por exemplo: “Busque no Existo ofertas de mala de bordo”.
Os nomes dos menus mudam com as versões do Claude. Se já tinha o Existo conectado, remova e adicione de novo para atualizar a lista de ferramentas.
Regras para o agente
- Informe apenas preços, descontos e condições que as ferramentas retornaram.
- Envie o cliente pelo preferred_action_url sem alterar o link nem remover parâmetros. Sem ele, a loja não reconhece a origem e a condição exclusiva não vale.
- Não prometa nada depois da data de validade da oferta.
- O Existo não processa pagamento e não garante ranking. A venda é fechada entre cliente e loja.
Qualquer pessoa pode conferir um código em store.existo.app/v.
Teste com curl
curl -sS https://backend.existo.app/api/mcp/public \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'curl -sS https://backend.existo.app/api/mcp/public \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"buscar_ofertas","arguments":{"query":"mala de bordo"}}}'