Search Modo Promotions
search_modo_promotionsFull Description
Searches the MODO promotions catalog and returns an interactive carousel widget. Use when the user asks about promotions, discounts, offers, benefits, or cashback through MODO.
BEFORE calling: if the user has NOT mentioned which bank they use, ask which bank they operate with before calling this tool. If they already named a bank, proceed directly.
AFTER the tool returns: the widget displays all results visually. Respond with a short sentence in Spanish confirming the results. If the user mentioned any bank NOT in the available banks list, append "Por el momento no operamos con [banco/s]." in the same response. If the user explicitly asked a question, you may briefly answer it using ONLY the data fields present in the tool response — never invent or infer data that is not there. When answering, always include the merchant or commerce name alongside any discount or day information. Never proactively offer suggestions, recommendations, plans, follow-up actions, or ask follow-up questions — only respond to what the user asked. Never list or enumerate the full set of promotions unprompted — the widget already shows them.
Constraints: call at most ONCE per user message. Do not retry, paginate, or make multiple calls. Do not use for payments, transfers, account info, or financial advice. Results are AI-ranked; availability may change, so do not guarantee specific promotions are active.
Parameters (2 required, 5 optional)
querystringShort natural-language search query in Spanish describing what the user is looking for (e.g., 'supermercado', 'restaurantes', 'descuento en electrónica'). Keep it concise (ideally under 100 characters) and never longer than the maximum allowed length of 500 characters. Use everyday Spanish terms — the API handles synonyms and typos.
user_banksstringREQUIRED. Comma-separated list of bank names the user operates with (e.g., "Galicia, BBVA"). If the user already mentioned a bank, use it directly; otherwise ask "¿Con qué banco operás?" before calling this tool. Available banks: Banco Nación, Galicia, BBVA, Santander, Macro, ICBC, Prex, YOY, Credicoop, Ciudad, BANCOR, Hipotecario, Patagonia, Supervielle, Banco Santa Fe, Banco Entre Rios, BPN, Banco Santa Cruz, Banco San Juan, Comafi, Banco Bica, Banco Piano, Banco Corrientes, Banco Dino, NaranjaX, IUDÚ, Banco del Sol, Banco Columbia, Banco del Chubut, Banco Santiago, Banco Coinag, Banco Roela, Buepp
banksstringOptional. Comma-separated bank name(s) to filter results by. ONLY set this when the user explicitly asks for promotions from a specific bank in their current message (e.g., "promos de BBVA"). Omit if no bank filter is requested. This is independent from user_banks — user_banks identifies which banks the user holds; this parameter filters search results.
flowstringOptional filter for the purchase flow type. Examples: "online" (e-commerce), "presencial" (in-store). Omit to return promotions for all flows.
limitintegerNumber of promotion cards to return. Default is 16 which is usually sufficient. Max: 50. Only increase if the user explicitly asks for more results.
16pageintegerPage number for paginated results. Default: 1. Do NOT paginate automatically — only advance the page if the user explicitly asks to see more results.
1statusstringFilter by promotion status. Valid values: "running" (active now, default), "coming" (upcoming), "finished" (expired). Omit to use default "running".
running