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.
https://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.
buscar_ofertasSearches active offers by product, service, category or city. Filter by merchant with public_handle.
detalhar_ofertaReturns the full terms: public price, agent price, payment, shipping, regions and validity.
negociar_ofertaWhen the customer asks for something (Pix discount, shipping), says whether it is allowed and which condition to present.
preferred_action_urlThe 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
- Open Claude settings and find Connectors.
- Choose to add a custom connector.
- Name it Existo and paste the endpoint https://backend.existo.app/api/mcp/public.
- 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
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"}}}'