Leal

by com.getleal

Overview Discussions Admin

Server Details

Design and launch Apple Wallet and Google Wallet loyalty stamp cards for your shop, café or salon.

Ownership verified

Status: Healthy
Last Tested: 2026-10-28 16:50
Transport: Streamable HTTP · MCP 2025-11-25
URL

TDQS

Score is being calculated.

Available Tools

15 tools

create_cardCreate a loyalty cardInspect

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.

Name	Required	Description
`name`	Yes	Internal name for the card, e.g. "Coffee card". Shown in Leal, not on the pass.
`rewards`	Yes	Rewards customers can redeem, e.g. [{name: "Free coffee", stamps_required: 10}]. The free plan allows one reward per card.
`logo_url`	No	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.
`store_id`	No	Store id from list_stores. Optional when the login has one store.
`card_color`	No	Pass background colour, hex (#RRGGBB).
`stamp_icon`	No	Icon shown in each collected stamp.
`strip_type`	No	Background of the stamp strip: a flat colour, one of Leal's preset photos, or an image from strip_image_url.
`text_color`	No	Colour of all text on the pass, hex. Must read clearly on card_color (4.5:1 contrast or better).
`header_text`	No	Text at the top of the pass. Defaults to the store name. Wallet apps truncate long headers, so keep it short.
`stamp_color`	No	Colour of the icon inside a collected stamp, hex. Must read clearly on stamp_background_color.
`strip_color`	No	Strip colour, hex. Also shows behind preset and image strips when strip_opacity is below 100.
`strip_preset`	No	Preset strip photo, used when strip_type is preset.
`strip_opacity`	No	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.
`initial_stamps`	No	Stamps a new customer starts with (a head start). Must be less than stamps_required.
`square_logo_url`	No	Public https URL of a square logo or icon, used as the round logo on Google Wallet.
`stamps_required`	No	Stamps needed to fill the card. 6, 8 or 10 are common.
`strip_image_url`	No	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.
`auxiliary_fields`	No	Up to two extra front-of-pass fields, e.g. {label: "Perk", value: "10% off pastries"}.
`show_member_field`	No	Show the customer's name on the front of the pass. Default true.
`stamp_background_color`	No	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.
`show_stamps_to_reward_field`	No	Show how many stamps until the next reward. Default true.

create_locationAdd a store locationInspect

Adds a physical location to a store. The address is geocoded so wallet passes can remind customers nearby.

Name	Required	Description
`name`	Yes	e.g. "Main Street" or the store name for a single shop.
`address`	Yes	Full street address including town and postcode.
`store_id`	No	Store id from list_stores. Optional when the login has one store.

create_posterCreate a signup posterInspect

Creates a printable poster with a QR code for a card. Customers scan it, fill in a short form on a public Leal signup page, and add the card to their wallet. Returns the signup link and a print link. Colours default to the card's.

Name	Required	Description
`title`	No	Headline, e.g. "Join our coffee club". Defaults to the card name.
`card_id`	Yes	Card id from list_cards.
`paper_size`	No	Default a4.
`text_color`	No	Poster text colour, hex. Defaults to the card's text colour.
`primary_color`	No	Poster background colour, hex. Defaults to the card colour.
`secondary_color`	No	Accent panel colour, hex.
`require_birthday`	No	Ask for a birthday (for birthday rewards). Default false.
`contact_collection_mode`	No	What the signup form asks for. Default email_and_phone.

create_rewardAdd a reward to a cardInspect

Adds a reward that customers can redeem with stamps from a card, e.g. a free coffee at 10 stamps.

Name	Required	Description
`name`	Yes	What the customer gets, e.g. "Free coffee".
`card_id`	Yes	Card id from list_cards.
`description`	No	Optional details, e.g. "Any size, any drink".
`stamps_required`	Yes	Stamps spent to redeem it.

create_storeCreate a storeInspect

Adds a new, empty store to the login's agency, with its own cards, posters and locations: for a client, a second business, or a demo to show a prospect. Then set it up with create_card, create_poster and create_location using the returned store_id. Don't use this to set up a store the login already has: call list_stores first and use the existing store if it's the same business.

Name	Required	Description
`name`	Yes	Store name in Leal, usually the business or client name, e.g. "Bean There Coffee".
`logo_url`	No	Public https URL of the wide logo (PNG, JPEG, WebP, GIF or SVG), e.g. from get_brand_kit.
`agency_id`	No	Agency id from list_stores. Only needed when this login runs several agencies.
`store_name`	No	Public name customers see on cards and signup pages, if different from name.
`square_logo_url`	No	Public https URL of a square logo or icon.

get_brand_kitGet brand kit from a website

Read-onlyIdempotent

Inspect

Reads a business's public website and returns its name, a colour palette (with where each colour was found; colours read from the logo are the most reliable, and website-builder default colours are filtered out), logo and icon image URLs, a hero image, a guess at the type of business, and a suggested starting card design built from those. Works without a Leal account. Use the result to propose card designs with preview_card_designs.

Name	Required	Description	Default
`url`	Yes	The business's website, e.g. https://beanthere.coffee or beanthere.coffee.

get_cardShow a loyalty card

Read-onlyIdempotent

Inspect

Shows a saved loyalty card's design and rewards, with an Apple and Google Wallet preview.

Name	Required	Description	Default
`card_id`	Yes	Card id from list_cards.

get_store_setupGet store setup

Read-onlyIdempotent

Inspect

Shows a store's setup checklist (store details, card, poster, first customer, staff app), plan limits and usage, and its cards with rewards, locations and posters.

Name	Required	Description	Default
`store_id`	No	Store id from list_stores. Optional when the login has one store.

list_cardsList loyalty cards

Read-onlyIdempotent

Inspect

Lists a store's loyalty cards with their rewards.

Name	Required	Description	Default
`store_id`	No	Store id from list_stores. Optional when the login has one store.
`include_archived`	No	Include archived cards. Default false.

list_design_optionsList card design options

Read-onlyIdempotent

Inspect

Lists what a Leal loyalty card can look like: stamp icons, preset strip photos, limits, and how the pass is laid out on Apple and Google Wallet. Works without a Leal account.

Name	Required	Description	Default
No parameters

list_storesList stores

Read-onlyIdempotent

Inspect

Lists the Leal stores this login can manage, with each store's id, plan and how far through setup it is, and the agencies it can add new stores to with create_store.

Name	Required	Description	Default
No parameters

preview_card_designsPreview loyalty card designs

Read-onlyIdempotent

Inspect

Renders one to four loyalty card designs as Apple Wallet and Google Wallet passes so the person can compare them and pick one. Checks each design against Leal's rules and flags hard-to-read colour combinations. Returns a shareable preview link per design. Works without a Leal account; nothing is saved.

Name	Required	Description	Default
`designs`	Yes	The designs to show side by side.
`store_name`	No	The business name, shown where the pass shows the store.

update_cardUpdate a loyalty card

DestructiveIdempotent

Inspect

Changes a saved card's design. Only the fields passed change; the rest stay as they are. Customers' passes in Apple Wallet and Google Wallet update automatically.

Name	Required	Description
`name`	No	Internal name for the card, e.g. "Coffee card". Shown in Leal, not on the pass.
`card_id`	Yes	Card id from list_cards.
`logo_url`	No	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.
`card_color`	No	Pass background colour, hex (#RRGGBB).
`stamp_icon`	No	Icon shown in each collected stamp.
`strip_type`	No	Background of the stamp strip: a flat colour, one of Leal's preset photos, or an image from strip_image_url.
`text_color`	No	Colour of all text on the pass, hex. Must read clearly on card_color (4.5:1 contrast or better).
`header_text`	No	Text at the top of the pass. Defaults to the store name. Wallet apps truncate long headers, so keep it short.
`stamp_color`	No	Colour of the icon inside a collected stamp, hex. Must read clearly on stamp_background_color.
`strip_color`	No	Strip colour, hex. Also shows behind preset and image strips when strip_opacity is below 100.
`strip_preset`	No	Preset strip photo, used when strip_type is preset.
`strip_opacity`	No	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.
`initial_stamps`	No	Stamps a new customer starts with (a head start). Must be less than stamps_required.
`square_logo_url`	No	Public https URL of a square logo or icon, used as the round logo on Google Wallet.
`stamps_required`	No	Stamps needed to fill the card. 6, 8 or 10 are common.
`strip_image_url`	No	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.
`auxiliary_fields`	No	Up to two extra front-of-pass fields, e.g. {label: "Perk", value: "10% off pastries"}.
`show_member_field`	No	Show the customer's name on the front of the pass. Default true.
`stamp_background_color`	No	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.
`show_stamps_to_reward_field`	No	Show how many stamps until the next reward. Default true.

update_rewardUpdate a reward

DestructiveIdempotent

Inspect

Changes a reward's name, stamps needed or description, or turns it off. Only the fields passed change.

Name	Required	Description
`name`	No
`active`	No	false hides the reward from customers and staff.
`reward_id`	Yes	Reward id from list_cards or get_store_setup.
`description`	No
`stamps_required`	No

update_storeUpdate store name and logo

DestructiveIdempotent

Inspect

Sets a store's public name and logos, which Leal uses on cards, posters and signup pages. Logos are fetched from public image URLs (PNG, JPEG, WebP, GIF or SVG). Replaces the current values.

Name	Required	Description
`logo_url`	No	Public https URL of the wide logo.
`store_id`	No	Store id from list_stores. Optional when the login has one store.
`store_name`	No	The business name customers know, e.g. "Bean There Coffee".
`square_logo_url`	No	Public https URL of a square logo or icon.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

15 tool updatesOct 28, 2026
- First observedcreate_card
- First observedcreate_location
- First observedcreate_poster
- First observedcreate_reward
- First observedcreate_store
- First observedget_brand_kit
- First observedget_card
- First observedget_store_setup
- First observedlist_cards
- First observedlist_design_options
- First observedlist_stores
- First observedpreview_card_designs
- First observedupdate_card
- First observedupdate_reward
- First observedupdate_store

Publisher details

Operator: Jemcode International Limited (trading as Leal) · Publisher source
Operator website: https://www.getleal.com
Vendor relationship: First-party
Documentation: https://www.getleal.com/mcp
Trust center: Not available
Restrictions: Design-preview tools work without signing in. Saving cards, rewards, posters and locations needs a Leal account (free plan available: one card with one reward, one poster and one location; more on paid plans). Sign-in is OAuth 2.1 with dynamic client registration, so no custom OAuth app is needed. · Publisher source

Related MCP Connectors

WalletPassBuilder AOAuth
com.walletpassbuilder
Create, update and message Apple Wallet and Google Wallet passes and loyalty cards.
Developer Tools Marketing Social Media
1
https://walletpassbuilder.com/api/mcp
Stampcard — digital stamp cards for small shops, no app for the customer A
app.rowb.stampcard
Create a shop program, hand customers a browser stamp card by QR poster, stamp it from a phone.
E-commerce & Retail
51
https://stampcard.rowb.app/mcp
walletmcppass: Apple Wallet passes A
com.walletmcppass
Create signed Apple Wallet passes (.pkpass): boarding passes, tickets, coupons, store cards.
E-commerce & Retail Travel & Transportation
21
https://walletmcppass.com/mcp
FidelipOAuth
com.fidelip
Set up and run a business's Fidelip loyalty cards, rewards, surveys and customer sign-up page.
CRM Marketing Customer Data Platforms
1
https://fidelip.com/mcp

Related MCP Servers

@walletap/mcp-serverofficial
E-commerce & Retail Marketing
walletap
A
license
A
quality
C
maintenance
Enables AI assistants to issue and manage Apple Wallet and Google Wallet passes, including template creation, pass issuance, notifications, stamping, and loyalty management.
Updated 2 months ago (2026-08-16 09:46 UTC)
26
20 npm
MIT
Bonus Pink MCP Server
CRM Customer Data Platforms
MK-Chan-MECACA
F
license
Not graded
quality
D
maintenance
Enables Bonus Pink sub-accounts to manage loyalty programs via AI agents, offering 84 tools for card issuance, points, stamps, visits, rewards, and communications.
Updated 4 months ago (2026-07-13 03:39 UTC)
-
VoucherVault MCP Server
E-commerce & Retail Payments & Billing
mmarquezs
A
license
A
quality
B
maintenance
Enables AI agents to list, search, create, update, mark used, and delete vouchers, coupons, gift cards, and loyalty cards via a token-authenticated JSON API.
Updated 3 days ago (2026-10-25 17:12 UTC)
6
MIT
OpenQRofficial
Marketing
open-qr
A
license
Not graded
quality
A
maintenance
Generate QR codes and create, edit and track dynamic (editable) QR codes with scan analytics, folders, style themes and branded subdomain management. Free REST API with an OpenAPI spec alongside; every tool takes a free API key.
Updated a month ago (2026-09-15 20:29 UTC)
12
AGPL 3.0