Leal
v1.0.0Design and launch Apple Wallet and Google Wallet loyalty stamp cards for your shop, café or salon.
Endpoint health
online- Last checked
- 11/20/2026, 7:16:59 AM
- Latency
- 378 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:com.getleal%2Fleal
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"com.getleal/leal": {
"url": "https://mcp.getleal.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
15 shown · authentication unknown
Create a loyalty card
create_card
Saves a loyalty card design and its rewards to a Leal store, ready for customers to add to Apple Wallet or Google Wallet. Takes the same design fields as preview_card_designs. Logos and strip photos are fetched from their URLs; if the store has no logo yet, the card's logo becomes the store logo. Needs a Leal account: the person is asked to sign in or create one.
Schema valid · SHA-256 f619d191b603…
View input schema
{ "type": "object", "properties": { "store_id": { "type": "integer", "description": "Store id from list_stores. Optional when the login has one store." }, "name": { "type": "string", "maxLength": 60, "description": "Internal name for the card, e.g. \"Coffee card\". Shown in Leal, not on the pass." }, "header_text": { "type": "string", "maxLength": 40, "description": "Text at the top of the pass. Defaults to the store name. Wallet apps truncate long headers, so keep it short." }, "card_color": { "type": "string", "description": "Pass background colour, hex (#RRGGBB). Fills the whole screen in Google Wallet, so avoid neon, fully saturated colours such as #00ff00." }, "text_color": { "type": "string", "description": "Colour of all text on the Apple pass, hex. Must read clearly on card_color (4.5:1 contrast or better). Google Wallet ignores it and picks black or white itself." }, "stamp_background_color": { "type": "string", "description": "Fill colour of a collected stamp circle, hex. Empty stamp slots use a translucent version of it, so it should stand out from the strip." }, "stamp_color": { "type": "string", "description": "Colour of the icon inside a collected stamp, hex. Must read clearly on stamp_background_color." }, "stamp_icon": { "type": "string", "enum": [ "star", "heart", "coffee", "coffee_bean", "pint_glass", "cake", "barbell", "check", "spray_bottle", "shopping_trolley", "diamond", "high_heel", "hairdryer", "paw_print", "scissors", "sun", "flower", "coat_hanger" ], "description": "Icon shown in each collected stamp." }, "stamps_required": { "type": "integer", "minimum": 1, "maximum": 21, "description": "Stamps needed to fill the card. 6, 8 or 10 are common." }, "initial_stamps": { "type": "integer", "minimum": 0, "description": "Stamps a new customer starts with (a head start). Must be less than stamps_required." }, "strip_type": { "type": "string", "enum": [ "color", "preset", "image" ], "description": "Background of the stamp strip: a flat colour, one of Leal's preset photos, or an image from strip_image_url." }, "strip_color": { "type": "string", "description": "Strip colour, hex. Also shows behind preset and image strips when strip_opacity is below 100." }, "strip_opacity": { "type": "integer", "minimum": 0, "maximum": 100, "description": "Opacity of the strip colour or image over the card colour. 100 shows it exactly; 60–85 tints a photo with the card colour so stamps stand out." }, "strip_preset": { "type": "string", "enum": [ "coffee_beans", "coffee_cup", "bakery", "pizza", "sushi", "burger", "ice_cream", "smoothie", "flowers", "spa" ], "description": "Preset strip photo, used when strip_type is preset." }, "strip_image_url": { "type": "string", "description": "Public https URL of a wide photo for the strip (strip_type image), e.g. a hero image from the brand's website. Cropped to 375×144 on Apple Wallet; Google Wallet shows the middle of it in its nearly square hero unless google_hero_image_url is given." }, "google_hero_image_url": { "type": "string", "description": "Public https URL of a nearly square photo (1032×812, about 5:4) for Google Wallet's hero image, with no text in it. The stamps are drawn on top. Optional: without it the hero uses the strip background." }, "google_logo_style": { "type": "string", "enum": [ "round", "wide" ], "description": "How the logo sits on Google Wallet. round (default): square_logo_url in a circle with the store name. wide: logo_url in place of the circle and store name, best for wordmarks." }, "logo_url": { "type": "string", "description": "Public https URL of the wide logo shown top-left of the Apple pass (PNG, JPEG, WebP, GIF or SVG; transparent PNG works best). Ideally a version that reads on card_color." }, "square_logo_url": { "type": "string", "description": "Public https URL of a square logo or icon, used as the round logo on Google Wallet." }, "show_member_field": { "type": "boolean", "description": "Show the customer's name on the front of the pass. Default true." }, "show_stamps_to_reward_field": { "type": "boolean", "description": "Show how many stamps until the next reward. Default true." }, "referrals_enabled": { "type": "boolean", "description": "Let customers invite friends from the back of their pass. Both get stamps once the store first stamps the friend's card on a visit, never just for signing up. Default false." }, "referrer_stamps": { "type": "integer", "minimum": 0, "description": "Stamps the inviting customer gets when their friend's first visit is stamped. Less than stamps_required. Default 1." }, "referee_stamps": { "type": "integer", "minimum": 0, "description": "Stamps the invited friend gets on their first stamped visit. Less than stamps_required. Default 1." }, "qr_style": { "type": "string", "enum": [ "link", "code" ], "description": "What the pass QR holds. link (default for new cards): a phone camera opens the store's sign-up page with this customer as referrer, and the store scanner still reads it. code: the bare card code only. Passes showing the old QR keep scanning." }, "auxiliary_fields": { "type": "array", "maxItems": 2, "description": "Up to two extra front-of-pass fields, e.g. {label: \"Perk\", value: \"10% off pastries\"}.", "items": { "type": "object", "properties": { "label": { "type": "string", "maxLength": 20 }, "value": { "type": "string", "maxLength": 30 } }, "required": [ "value" ] } }, "rewards": { "type": "array", "minItems": 1, "maxItems": 5, "description": "Rewards customers can redeem, e.g. [{name: \"Free coffee\", stamps_required: 10}]. The free plan allows one reward per card.", "items": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 60 }, "stamps_required": { "type": "integer", "minimum": 1, "description": "Stamps spent to redeem. Usually equal to the card's stamps_required." }, "description": { "type": "string", "maxLength": 200 } }, "required": [ "name", "stamps_required" ] } }, "intent": { "type": "string", "description": "Optional. One short sentence on what the person asked you to do, e.g. \"Set up a stamp card for Ground Up Café\". Leal shows it in the person's activity log under Settings → AI agents, so they can see what was done for them. Leave out customer details." } }, "required": [ "name", "rewards" ], "$schema": "https://json-schema.org/draft/2020-12/schema" }
Connections
streamable-http
https://mcp.getleal.com/mcp