Search Modo Promotions
search_modo_promotionsFull Description
Searches the MODO promotions catalog using a natural-language query written in Spanish. Returns an interactive carousel of promotion cards including merchant name, discount details, participating banks, validity dates, and images. Use this tool whenever the user asks about promotions, discounts, offers, benefits, or cashback available through MODO. Do NOT use this tool for payments, transfers, account information, or financial advice — those are outside the scope of this server. Results are AI-ranked by relevance; availability may change in real time, so do not guarantee that a specific promotion is still active. Call this tool at most ONCE per user message — do not retry, paginate, or make multiple calls.
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