MCP App Store
by KeenEthics
Habyt icon

Habyt MCP Server for ChatGPT

By Habyt

Overview

Habyt ayuda a negocios a operar sus programas de lealtad digital desde ChatGPT. Los propietarios autenticados pueden consultar tarjetas, clientes, pases, sucursales y estadísticas; crear y actualizar tarjetas; registrar sellos o puntos; y preparar notificaciones. Habyt solo accede a la cuenta conectada y solicita confirmación explícita antes de aplicar cambios.

How to connect

  1. ChatGPT: Open the Habyt listing in the ChatGPT app directory and choose Connect. ChatGPT listing Habyt exposes 71 tools here.

Tools

add_loyalty_points

ChatGPT
Add 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

ChatGPT
Add 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

ChatGPT
Link 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

ChatGPT
Assign 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

ChatGPT
Cancel 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_template_creation

ChatGPT
Creates 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

ChatGPT
Applies 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

ChatGPT
Optional 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

ChatGPT
Creates 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

ChatGPT
Save 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

ChatGPT
Generate 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

ChatGPT
Statistics 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

ChatGPT
Returns 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

ChatGPT
Load 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

ChatGPT
Same as habyt_get_subscription_plan — Habyt plan, trial, billing, limits (read-only).

get_issuance_form_settings

ChatGPT
Read 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

ChatGPT
Read-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

ChatGPT
Alias of habyt_get_mcp_capabilities. Prefer habyt_get_mcp_capabilities for version and capability checks.

get_template_requirements

ChatGPT
Returns 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

ChatGPT
Sends 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

ChatGPT
Creates 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

ChatGPT
Read-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

ChatGPT
Account 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

ChatGPT
Same as get_card_template. Use for design + rules of a named Habyt card. Never browse the Habyt website.

habyt_get_mcp_capabilities

ChatGPT
READ 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

ChatGPT
Read-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

ChatGPT
READ 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

ChatGPT
Emite 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

ChatGPT
READ 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

ChatGPT
READ 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

ChatGPT
READ 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

ChatGPT
READ 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

ChatGPT
REQUIRED 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

ChatGPT
REQUIRED 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

ChatGPT
REQUIRED 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

ChatGPT
Send 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

ChatGPT
REQUIRED 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

ChatGPT
Updates 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

ChatGPT
Create/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

ChatGPT
Issue 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

ChatGPT
History 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

ChatGPT
Same as habyt_list_automated_notifications. Full rules all cards when card_name omitted. NEVER refuse read citing disabled permission.

list_card_templates

ChatGPT
List 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

ChatGPT
List 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

ChatGPT
Alias 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

ChatGPT
List 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

ChatGPT
List 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

ChatGPT
Same as habyt_list_managers. List managers with stores, cards, PIN and statistics flags. NEVER refuse listing or ask for browser/screenshots.

list_sent_notifications

ChatGPT
Alias 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

ChatGPT
Alias of habyt_send_push_notification — manual Wallet push with confirmation. Prefer habyt_send_push_notification for Spanish «manda notificación» prompts.

rank_pass_holders

ChatGPT
Read-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

ChatGPT
Recent 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

ChatGPT
Add sessions to one issued session pass. Requires confirmation before writing.

record_direct_sale

ChatGPT
Record 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

ChatGPT
Mark one issued coupon pass as redeemed after validating its current state. Requires confirmation before writing.

redeem_gift_balance

ChatGPT
Subtract an amount in MXN from one issued gift pass after validating its current balance. Requires confirmation before writing.

redeem_loyalty_reward

ChatGPT
Redeem a quantity of rewards from one issued loyalty pass after validating its current state. Requires confirmation before writing.

redeem_sessions

ChatGPT
Use sessions from one issued session pass after validating its current balance. Requires confirmation before writing.

redeem_stamp_reward

ChatGPT
Redeem a quantity of completed rewards from one issued stamp pass after validating its current state. Requires confirmation before writing.

search_customer_passes

ChatGPT
Read-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

ChatGPT
Turn 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.

submit_support_bug_report

ChatGPT
Alias 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

ChatGPT
Increase 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

ChatGPT
Edit 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

ChatGPT
Change 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

ChatGPT
Same 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

ChatGPT
Edit 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

ChatGPT
Activate/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

ChatGPT
Recompute missing fields, warnings and summary. When ready, returns a short-lived confirmation_token for create_template_creation (show full summary to the user first).

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/habyt"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/habyt)