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.

Endpoint MCPhttps://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.

  1. buscar_ofertas

    Procura ofertas ativas por produto, serviço, categoria ou cidade. Pode filtrar por loja com public_handle.

  2. detalhar_oferta

    Traz as condições completas: preço público, preço para agente, pagamento, entrega, regiões e validade.

  3. negociar_oferta

    Quando o cliente pede algo (desconto no Pix, frete), diz se o benefício é permitido e qual condição apresentar.

  4. preferred_action_url

    O 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

  1. Abra as configurações do Claude e procure Conectores.
  2. Escolha adicionar um conector personalizado.
  3. Dê o nome Existo e cole o endpoint https://backend.existo.app/api/mcp/public.
  4. 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

Listar as ferramentas
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"}'
Buscar uma oferta
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"}}}'