add_loyalty_points
ChatGPTAdd points to one issued loyalty pass. Provide quantity as points, or amount in MXN to calculate points using the card rate. Requires confirmation before writing.
add_pass_stamps
ChatGPTAdd stamps to one issued stamp pass. Resolves a unique customer/card, reads the current pass state, and requires confirmation before writing. This records a loyalty movement; it does not charge a payment terminal.
assign_card_locations
ChatGPTLink store locations to a live card (Geo-Push). By default location_names are ADDED to existing stores (merge). Set replace_existing=true to set the exact list. Empty location_names removes all. Requires confirmation.
attach_draft_assets
ChatGPTAssign images to a draft or a live card. Prefer this after receiving a chat image. For stamp/sessions cards, the background where stamps appear is strip-background-image; strip-image is accepted as an alias and remapped automatically while preserving the existing stamp design. Pass draft_id, or card_id/card_name to open an edit draft automatically. Public https or data:image URLs. Confirm template updates after attachment.
cancel_scheduled_notification
ChatGPTCancel a wallet push that was scheduled for the future (status pending). Identify by card_name + scheduled_for and/or message_contains, or notification_id from list_sent_notifications. Requires confirmation_token.
confirm_issuance_link_creation
ChatGPTAfter template creation, shares the existing dashboard distribution: public link, QR code, and/or printable PDF. Does not create a new link if one already exists. Requires confirmation_token for action create_issuance_link.
confirm_template_creation
ChatGPTCreates the live card template after explicit user confirmation. Requires confirmation_token from validate_template_draft. Returns spoken text: explain that the card is live and offer link, QR, and/or printable PDF — ask if the user wants you to share them here. Then use confirm_issuance_link_creation when they pick formats.
confirm_template_update
ChatGPTApplies an already prepared live-card edit. Prefer update_card_template for new edits (strip-image, colors, logos). Use this if you already have a confirmation_token from validate_template_draft or update_card_template.
create_asset_upload_session
ChatGPTOptional upload form. Use only if the user prefers to drop their own files, or attach_draft_assets cannot use a public https/data URL (sandbox:/mnt/data). Prefer attach_draft_assets so non-technical users stay in ChatGPT. Always show upload_url as a markdown link.
create_location
ChatGPTCreates a store in Habyt (name, address, lat, long, optional geo-push text). Same as habyt_create_location. NEVER tell the user MCP cannot create locations. Do not ask for hours, phone, or radius.
create_template_draft
ChatGPTSave a proposed card template. For new cards, catalog_id is the preferred default because it preserves a complete design from /app/cards/new-card/from-template. Before calling this tool, show the selected template's general defaults and ask one consolidated optional review; omitted values keep the defaults. Skip that question only if the user already provided the relevant general data or explicitly said to use the template values. Use card_family + payload from scratch only when explicitly requested or no compatible catalog entry exists. Apply the user's payload as a minimal patch over the catalog base.
export_account_statistics_pdf
ChatGPTGenerate a downloadable statistics PDF (jsPDF, same KPI style as the dashboard). Ask the user which period in natural language: last month, two months, six months, one year, or custom dates. Map to period preset or date_from/date_to (YYYY-MM-DD). Read-only.
get_account_statistics
ChatGPTStatistics KPIs for any period, including today. Alias: habyt_get_account_statistics. today, yesterday, this_week, last_week, this_month, or custom dates. tracked_revenue is registered sales.
get_account_status
ChatGPTReturns the signed-in owner's Habyt plan (Inicial/Starter, Pro, Corporate), subscription status, trial or next billing date, and usage vs limits (cards, stores, managers). Use for: «cuál es mi plan», «qué plan tengo», «límites de mi cuenta», «¿soy Pro?», billing/trial questions. Read-only; does not change billing. For contacting support use submit_support_bug_report instead.
get_card_template
ChatGPTLoad live Habyt card design, colors, logos, strip-image status, messages, and program rules by card_name (e.g. Club Café Norte). REQUIRED for «muéstrame el diseño y reglas», «cómo está configurada la tarjeta». Returns payload + design + rules_es. Do NOT open habyt.solidsens.com in a browser — this tool has full data.
get_habyt_plan
ChatGPTSame as habyt_get_subscription_plan — Habyt plan, trial, billing, limits (read-only).
get_issuance_form_settings
ChatGPTRead which optional questions the public issuance form asks (phone, birth date, gender, country, city/state). Name, last name, and email are always required. Same as dashboard Distribuir → edit issuance form.
get_issued_pass
ChatGPTRead-only: live balance, points, stamps, sessions, or coupon status for one issued pass. Use card_name + customer_email, or pass_code from QR/manual entry. Use this when the user only asks for current status; never invent balances.
get_mcp_capabilities
ChatGPTAlias of habyt_get_mcp_capabilities. Prefer habyt_get_mcp_capabilities for version and capability checks.
get_template_requirements
ChatGPTReturns required fields, assets, locations, back fields, and rules. For card_family=coupon, includes subtype guidance: recommend coupon-type1 (promotion in offer-title only on front) vs coupon-type2 (up to 3 configurable front slots + title).
habyt_contact_support
ChatGPTSends a message to support.habyt@solidsens.com for the signed-in owner (same email flow as Dashboard «Reportar un error»). REQUIRED when the user says: «contáctame con soporte», «escribe a soporte», «reportar error», or asks whether a configuration is possible and wants Habyt team to answer — use message with their question (Spanish OK, min 10 chars). This connector HAS support email — NEVER say there is no support channel. If they ask «¿se puede configurar X?», call get_mcp_capabilities first to answer what MCP can do; then offer to email support for the rest. Flow: request_token=true → show summary → user confirms → confirmation_token.
habyt_create_location
ChatGPTCreates a real store location in the owner's Habyt account. REQUIRED when the user asks to create/add a sucursal, tienda, or ubicación — NEVER say the connector cannot create locations or only prepare data for the web form. Ask ONLY: name, address (or Maps link you geocode), optional geo-push message. Do NOT ask for opening hours, phone, scan radius, or card assignment (use assign_card_locations after). Then call this tool with latitude/longitude. User saying «crea la sucursal» is explicit consent to create.
habyt_find_customer
ChatGPTRead-only customer resolver. Use for lookup questions or when an action tool cannot resolve customer_name itself. A single person and single card is unambiguous: continue to request_token=true in the same turn and include identity in the final summary. Ask only when several people or cards match. Never invent an email. Same data as search_customer_passes.
habyt_get_account_statistics
ChatGPTAccount statistics for any question: sales/revenue, transactions, stamps, points, new passes, retention, peak hour, by card or store. REQUIRED for «¿cuánto vendí hoy?», «ayer», «esta semana», «cómo voy», «este mes». NEVER say there is no today cut or statistics are unavailable. Periods (America/Mexico_City): today, yesterday, this_week, last_week, this_month, one_month, two_months, six_months, one_year, or custom + date_from/date_to. Optional card_name and location_name. tracked_revenue is registered sales; $0 is valid. Read spoken.
habyt_get_card_design_and_rules
ChatGPTSame as get_card_template. Use for design + rules of a named Habyt card. Never browse the Habyt website.
habyt_get_mcp_capabilities
ChatGPTREAD mcp_server_version and which habyt_* tools exist (notifications, locations, managers, push, plan). REQUIRED when the user asks «mcp_server_version», «qué versión MCP», «qué puedes hacer», or before saying a feature is unavailable. NEVER say get_mcp_capabilities is not exposed — this tool IS the connector capability map.
habyt_get_setup_guide
ChatGPTRead-only onboarding checklist aligned with Habyt web tutorials: first location, first card, assign stores, issuance link, optional geo-push/managers. REQUIRED when the user asks to set up their program, «dejar listo», «por dónde empiezo», first connection, or step-by-step launch guide. NEVER auto-run create/update tools — user must opt in to follow each suggestion. Returns pending steps, MCP tools per step, and opt_in_prompt_es.
habyt_get_subscription_plan
ChatGPTREAD Habyt subscription plan for the signed-in owner. REQUIRED when the user asks: «cuál es mi plan de Habyt», «qué plan tengo», plan name, Inicial/Pro/Corporate, trial, billing renewal, or resource limits. Returns plan_label_es and usage vs limits. This connector HAS subscription access — never tell the user you only see cards.
habyt_issue_gift_card
ChatGPTEmite una tarjeta regalo con saldo y envía correo con enlace/PDF al destinatario (flujo Regalar del dashboard). Igual que issue_gift_card. Requiere confirmación. No sustituye cobro con terminal Point. Si el correo ya se envió y solo hay que reenviarlo, usa habyt_resend_gift_card_email — no emitas otra tarjeta.
habyt_list_automated_notifications
ChatGPTREAD automated notification rules for the account (active/inactive, trigger type, configuration, message) — same as /app/notifications/automated-notifications. REQUIRED for «mi configuración de notificaciones automatizadas», «reglas de cumpleaños/inactividad», «qué tengo activo». NEVER say permission is disabled, Sandbox lacks access, or you cannot consult/modify from this connection — READ always works; omit card_name for all cards with full rules. Edit with habyt_upsert_automated_notification (confirm). include_history=true for run history.
habyt_list_favorite_customers
ChatGPTREAD organization-wide favorite customers (marcados como favorito en Habyt). REQUIRED when the user asks «quiénes son mis clientes favoritos», «mis favoritos», etc. — NOT recent_transactions or rankings. Returns count=0 and empty favorites when none (success, not error). To mark or remove, use habyt_set_customer_favorite.
habyt_list_managers
ChatGPTREAD managers for the signed-in account owner: name, email, assigned stores, card templates they can scan, PIN requirement, statistics access. REQUIRED when the user asks «mis gerentes», «quién puede escanear», manager permissions, or team — NEVER say the connector cannot list managers, cannot open /app/managers, or ask for panel screenshots. Do NOT use get_account_status usage.managers alone (call this tool). count=0 is valid. Does NOT create/delete managers.
habyt_list_notification_history
ChatGPTREAD sent/scheduled manual Wallet push and automated runs (same as /app/notifications history). REQUIRED for «notificaciones enviadas», «últimos dos meses», «qué push mandé», message content with date and card — NEVER say history is disabled, missing permission, or that you only have cards/transactions/recent_transactions. Default last 60 days; pass days=60 for two months. Geo-push lock-screen deliveries are NOT logged per send (see geo_push.note_es).
habyt_record_direct_sale
ChatGPTREQUIRED for a cash or manual sale with no wallet pass: «registra un cobro de 300 con concepto desayuno». Saves a direct_sale row in transactions (statistics + concepto). Location rule matches Point: no active stores → save without store; exactly one → use it automatically; more than one → location_name is required, ask which store. request_token=true → user confirms → confirmation_token. NOT a Mercado Pago Point charge and NOT a stamp/points movement on a pass.
habyt_resend_gift_card_email
ChatGPTREQUIRED for «reenvíale el correo del pase», «no le llegó el correo de la tarjeta regalo», «mándale otra vez el enlace». Finds the existing Regalar gift (by customer_name or recipient_email) and resends that install email. Does NOT issue a new card or change the balance. If several gifts match, ask which (card, amount, date) then call again with recipient_email and amount or card_name. request_token=true → confirm → confirmation_token. Optional send_to_email only if they want a different inbox; default is the original recipient.
habyt_send_customer_push
ChatGPTREQUIRED for a push/aviso to ONE named person. NEVER use the mass-send tool for one customer. A unique customer and card are resolved automatically; call request_token=true immediately and use the final summary as the sole confirmation. Ask only if several people or cards match. Sends only to that person's active pass. Max 100 characters; emojis only for in-house cards.
habyt_send_push_notification
ChatGPTSend or schedule manual Wallet push (Habyt Sandbox and prod). REQUIRED for «manda/envía notificación/push/aviso», all holders or filtered audience, now or scheduled_for. ONE named person → habyt_send_customer_push, never audience=all. This connector INCLUDES send — NEVER say Sandbox lacks push, notifications are disabled, or browser must open /app/notifications. Guide: card_name + message; audience=all or filtered+filters; request_token=true → recipient_count → user confirms → confirmation_token. Parámetros push manual (habyt_send_push_notification): • card_name — nombre de la tarjeta (list_card_templates si dudas). • message — texto del aviso (máx. 100 caracteres; emojis solo si la tarjeta usa motor in-house). • audience=all — todos los titulares activos de esa tarjeta; audience=filtered + filters — segmento. • filters (opcional): birthday (today|thisMonth), retention (active|atRisk|churned), gender, activity, age_group, country, city_state, tier, issued_from/to, transaction_count_min/max. • scheduled_for — ISO en el futuro para programar; omitir = enviar al confirmar. Flujo: request_token=true → muestra recipient_count y resumen → usuario confirma → misma llamada con confirmation_token. Nunca digas que Sandbox no incluye envío ni uses el navegador para mandar push.
habyt_set_customer_favorite
ChatGPTREQUIRED to mark or remove a favorite. A unique customer name resolves automatically; call request_token=true immediately and use the final summary as the sole confirmation. Ask only when several people match. Does not issue a pass. Organization-wide by email.
habyt_update_location
ChatGPTUpdates an existing store: name, address, coordinates, geo-push global, or weekly geo_push_messages (monday–sunday + global). REQUIRED when the user asks to edit/change a sucursal, tienda, or geo-push text — NEVER say the connector cannot edit locations or only the web form. Use location_name (not UUID). request_token=true → show summary → confirmation_token. User «edita la sucursal X» is explicit consent for this flow.
habyt_upsert_automated_notification
ChatGPTCreate/update automated notification rules (message, active/inactive, days/points config) — same as editing /app/notifications/automated-notifications. REQUIRED to change automated rules from chat. Flow: request_token=true → confirm → confirmation_token. Types: birthday, anniversary, inactivity, welcome_followup, expiration_reminder, points_milestone, next_reward.
issue_gift_card
ChatGPTIssue a gift card pass with balance and email the recipient a gift link/PDF (same as Dashboard Regalar on gift templates). Not Mercado Pago Point. Requires request_token then confirmation_token. MCP owner account only.
list_automated_notification_history
ChatGPTHistory of automated notification job runs that sent to your passes (status, dates, rule types). Same data as History on /app/notifications/automated-notifications. Optional card_name filter.
list_automated_notifications
ChatGPTSame as habyt_list_automated_notifications. Full rules all cards when card_name omitted. NEVER refuse read citing disabled permission.
list_card_templates
ChatGPTList Habyt card templates (includes account_plan with subscription plan_label_es). For plan-only questions prefer habyt_get_subscription_plan. Design edits: get_card_template then update_card_template.
list_catalog_templates
ChatGPTList Habyt catalog pass templates (same as /app/cards/new-card/from-template), ordered by product priority. This is the default first step for creating a card unless the user explicitly asks to start from scratch. Choose a clear closest match automatically; ask one choice only when 2–3 materially different styles fit. Use catalog_id with create_template_draft and preserve the complete seeded design.
list_favorite_customers
ChatGPTAlias of habyt_list_favorite_customers — favorite customers by email. Prefer habyt_list_favorite_customers for Spanish prompts. count=0 when empty (not an error).
list_issued_passes
ChatGPTList customer passes issued for a card template. Resolve the card by card_name (preferred) or card_id. Speak in natural Spanish; do not ask the user for internal IDs.
list_locations
ChatGPTList store locations with geo-push config. Each row includes geo_push_messages_configured (global + lunes–domingo, labeled day_es), geo_push_mode_es, geo_push_message (vigente hoy), geo_push_vigente_fuente_es. Optional location_name for one store. REQUIRED for sucursales/tiendas/geo-push — NEVER say unavailable without calling this tool.
list_managers
ChatGPTSame as habyt_list_managers. List managers with stores, cards, PIN and statistics flags. NEVER refuse listing or ask for browser/screenshots.
list_sent_notifications
ChatGPTAlias of habyt_list_notification_history. Manual push history, pending scheduled, automated runs. days=60 for two months. NEVER refuse without calling this tool.
preview_and_send_notification
ChatGPTAlias of habyt_send_push_notification — manual Wallet push with confirmation. Prefer habyt_send_push_notification for Spanish «manda notificación» prompts.
rank_pass_holders
ChatGPTRead-only leaderboards for a card template: current stamps/points/sessions/gift balance/rewards, or period-based transactions/spend/points earned/stamps earned, or most recently issued. Periods include today, yesterday, this_week, last_week, this_month, and custom dates (America/Mexico_City). Optional favorites_only and location_name (period metrics). Live balances scan up to 120 newest passes.
recent_transactions
ChatGPTRecent scanner transactions (includes account_plan). For subscription/plan questions use habyt_get_subscription_plan instead of guessing. Each row has location_name and location_address.
recharge_sessions
ChatGPTAdd sessions to one issued session pass. Requires confirmation before writing.
record_direct_sale
ChatGPTRecord a manual sale with no issued pass (amount + concept) into transactions as direct_sale. Location rule matches Point: zero stores → no location; one store → auto; several → location_name required. Same as habyt_record_direct_sale. Requires confirmation. This does not charge Mercado Pago Point or change a wallet pass.
redeem_coupon
ChatGPTMark one issued coupon pass as redeemed after validating its current state. Requires confirmation before writing.
redeem_gift_balance
ChatGPTSubtract an amount in MXN from one issued gift pass after validating its current balance. Requires confirmation before writing.
redeem_loyalty_reward
ChatGPTRedeem a quantity of rewards from one issued loyalty pass after validating its current state. Requires confirmation before writing.
redeem_sessions
ChatGPTUse sessions from one issued session pass after validating its current balance. Requires confirmation before writing.
redeem_stamp_reward
ChatGPTRedeem a quantity of completed rewards from one issued stamp pass after validating its current state. Requires confirmation before writing.
search_customer_passes
ChatGPTRead-only. Find issued passes by email or name. Continue automatically when one person/card matches; ask one disambiguation question only for multiple matches. Never invent an email. Same as habyt_find_customer.
set_all_automated_notifications
ChatGPTTurn all applicable automated notification rules on or off for one card (same as Turn on/off all in /app/notifications/automated-notifications). Requires confirmation_token.
set_issuance_link_status
ChatGPTSet the public distribution link to active or inactive (same as the dashboard Distribuir toggle). Requires confirmation_token. Set request_token=true first.
submit_support_bug_report
ChatGPTAlias of habyt_contact_support — sends to support.habyt@solidsens.com via Habyt bug-report email flow. Prefer habyt_contact_support for «contáctame con soporte» and product/configuration questions. request_token → confirm → confirmation_token.
top_up_gift_balance
ChatGPTIncrease the balance of one issued gift pass by an amount in MXN. Requires confirmation before writing and does not charge a payment terminal.
update_card_template
ChatGPTEdit a published Habyt card in place (images, logos, colors, copy). For stamp/sessions cards, strip-image input is automatically treated as strip-background-image so the existing stamp design is preserved and the composed strip is regenerated. Reads current config first, applies a partial patch, then requires confirmation_token. Fields disabled in the template edit form are rejected, including coupon type 2 Valor de Campo Personalizado (custom-field-*). Image/color/logo changes update issued passes on Wallet sync. apple-icon is the Apple lock-screen icon and often does NOT change on already-installed iPhones — warn before changing it. Do not draw a fake Wallet mockup; call this tool.
update_issuance_form_settings
ChatGPTChange optional issuance form questions (show/hide and required). Name, last name, and email stay mandatory. Requires confirmation_token. Set request_token=true first.
update_location
ChatGPTSame as habyt_update_location: edit name, address, coords, geo_push_global, geo_push_messages (weekly). location_name preferred. NEVER say MCP cannot edit stores.
update_manager
ChatGPTEdit an existing manager: full name, assigned store names, require PIN for transactions, allow statistics. Does NOT change email, password, profile photo, PIN value, create managers, or delete managers. Requires confirmation_token.
upsert_automated_notification
ChatGPTActivate/deactivate or edit message and configuration for one automated rule on a card (confirm). Prefer habyt_upsert_automated_notification. configuration_value: days/years/points or reward distance shortcut matching the UI edit form.
validate_template_draft
ChatGPTRecompute missing fields, warnings and summary. When ready, returns a short-lived confirmation_token for create_template_creation (show full summary to the user first).