Connect your agent to exclusive offers for customers who arrive through AI.

The Existo public MCP serves active Agent Offers from Brazilian merchants: agent price, negotiable benefits, validity and a link that takes the customer to the merchant’s WhatsApp with a verifiable origin code.

MCP endpointhttps://backend.existo.app/api/mcp/public
  • Read-only
  • No authentication
  • Streamable HTTP, JSON
  • Only active, confirmed offers

How an agent uses it

Four steps, in this order. The first three are MCP tools; the last is a link.

  1. buscar_ofertas

    Searches active offers by product, service, category or city. Filter by merchant with public_handle.

  2. detalhar_oferta

    Returns the full terms: public price, agent price, payment, shipping, regions and validity.

  3. negociar_oferta

    When the customer asks for something (Pix discount, shipping), says whether it is allowed and which condition to present.

  4. preferred_action_url

    The agent sends the customer to this link. It opens the merchant’s WhatsApp with an AG- code that proves the origin.

Use it in Claude

  1. Open Claude settings and find Connectors.
  2. Choose to add a custom connector.
  3. Name it Existo and paste the endpoint https://backend.existo.app/api/mcp/public.
  4. Save and ask, for example: “Search Existo for carry-on luggage offers”.

Menu names change between Claude versions. If Existo was already connected, remove it and add it again to refresh the tool list.

Rules for the agent

  • Only state prices, discounts and terms returned by the tools.
  • Send the customer through preferred_action_url without changing the link or dropping parameters. Without it the merchant cannot see the origin and the exclusive condition does not apply.
  • Do not promise anything past the offer’s valid-until date.
  • Existo does not process payments and does not guarantee ranking. The sale is closed between customer and merchant.

Anyone can check a code at store.existo.app/v.

Try it with curl

List the tools
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"}'
Search for an offer
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"}}}'