Koskamo

Leal MCP

The Leal MCP server enables AI assistants to design, preview, and launch Apple Wallet and Google Wallet loyalty cards for local businesses. It allows agents to extract brand kits from websites, compare card designs, and configure rewards, locations, and promotional posters without requiring manual form filling.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Leal MCP logo, by LealVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Leal
You need:Free on every planNo API keys, just sign inComplete the authorization flow with your Leal account
MCP endpoint (Streamable HTTP)
https://mcp.getleal.com/mcp
Vendor documentation

What its tools do

15 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (7)

Can change data (8)

15 of 15 have a description · 15 of 15 declare behavior hints · 12 of 13 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to getleal.com ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Extract brand kit from a business website
  • Preview Apple and Google Wallet card designs
  • Create and update loyalty cards and rewards
  • Generate printable QR posters for stores

Source and maintenance

Vendor evidenceRegistry 1.0.0
mcp-registry: com.getleal/leal@1.0.0Project website

Protocol and capabilities

Server
leal 1.0.0
MCP protocol negotiated in check
2025-06-18
Tools
15 advertised
Resources
1 advertised
Resource templates
0 advertised
Prompts
2 advertised
Server-advertised capabilities
{
  "tools": {},
  "prompts": {},
  "resources": {},
  "extensions": {
    "io.modelcontextprotocol/ui": {
      "mimeTypes": [
        "text/html;profile=mcp-app"
      ]
    }
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Leal runs digital loyalty stamp cards for independent shops, cafés and salons: customers keep the card in Apple Wallet or Google Wallet and staff stamp it with the Leal app. Use these tools to set up and change a store's loyalty programme. A typical setup: get_brand_kit on the business's website, preview_card_designs with two or three designs built from its colours and logo, then (after the person picks one) create_card with a reward, create_poster for the counter, and create_location. To set up a new business, client or demo alongside the stores a login already has, create_store first and pass its store_id to the other tools; never put another business's card into an existing store. get_brand_kit, list_design_options and preview_card_designs work without an account; the others ask the person to sign in or create a free Leal account the first time. Leal's free plan has one card with one reward, one poster and one location. Deleting, billing and customer data are managed in the Leal app.

Tools

15 advertised

get_brand_kit — Get brand kit from a website
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_brand_kit input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "The business's website, e.g. https://beanthere.coffee or beanthere.coffee."
    }
  }
}
get_brand_kit annotations
{
  "title": "Get brand kit from a website",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
list_design_options — List card design options
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

list_design_options input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}
list_design_options annotations
{
  "title": "List card design options",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
preview_card_designs — Preview loyalty card designs
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

preview_card_designs input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "designs"
  ],
  "properties": {
    "designs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 60,
            "description": "Internal name for the card, e.g. \"Coffee card\". Shown in Leal, not on the pass."
          },
          "label": {
            "type": "string",
            "maxLength": 30,
            "description": "Short name for this direction, e.g. \"Espresso\" or \"Light & airy\"."
          },
          "reward": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "stamps_required": {
                "type": "integer",
                "minimum": 1
              }
            },
            "description": "The main reward, shown under the preview."
          },
          "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."
          },
          "rationale": {
            "type": "string",
            "maxLength": 160,
            "description": "One sentence on why this design suits the brand."
          },
          "card_color": {
            "type": "string",
            "description": "Pass background colour, hex (#RRGGBB)."
          },
          "stamp_icon": {
            "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"
            ],
            "type": "string",
            "description": "Icon shown in each collected stamp."
          },
          "strip_type": {
            "enum": [
              "color",
              "preset",
              "image"
            ],
            "type": "string",
            "description": "Background of the stamp strip: a flat colour, one of Leal's preset photos, or an image from strip_image_url."
          },
          "text_color": {
            "type": "string",
            "description": "Colour of all text on the pass, hex. Must read clearly on card_color (4.5:1 contrast or better)."
          },
          "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."
          },
          "stamp_color": {
            "type": "string",
            "description": "Colour of the icon inside a collected stamp, hex. Must read clearly on stamp_background_color."
          },
          "strip_color": {
            "type": "string",
            "description": "Strip colour, hex. Also shows behind preset and image strips when strip_opacity is below 100."
          },
          "strip_preset": {
            "enum": [
              "coffee_beans",
              "coffee_cup",
              "bakery",
              "pizza",
              "sushi",
              "burger",
              "ice_cream",
              "smoothie",
              "flowers",
              "spa"
            ],
            "type": "string",
            "description": "Preset strip photo, used when strip_type is preset."
          },
          "strip_opacity": {
            "type": "integer",
            "maximum": 100,
            "minimum": 0,
            "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."
          },
          "initial_stamps": {
            "type": "integer",
            "minimum": 0,
            "description": "Stamps a new customer starts with (a head start). Must be less than stamps_required."
          },
          "square_logo_url": {
            "type": "string",
            "description": "Public https URL of a square logo or icon, used as the round logo on Google Wallet."
          },
          "stamps_required": {
            "type": "integer",
            "maximum": 21,
            "minimum": 1,
            "description": "Stamps needed to fill the card. 6, 8 or 10 are common."
          },
          "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."
          },
          "auxiliary_fields": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "value"
              ],
              "properties": {
                "label": {
                  "type": "string",
                  "maxLength": 20
                },
                "value": {
                  "type": "string",
                  "maxLength": 30
                }
              }
            },
            "maxItems": 2,
            "description": "Up to two extra front-of-pass fields, e.g. {label: \"Perk\", value: \"10% off pastries\"}."
          },
          "show_member_field": {
            "type": "boolean",
            "description": "Show the customer's name on the front of the pass. Default true."
          },
          "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."
          },
          "show_stamps_to_reward_field": {
            "type": "boolean",
            "description": "Show how many stamps until the next reward. Default true."
          }
        }
      },
      "maxItems": 4,
      "minItems": 1,
      "description": "The designs to show side by side."
    },
    "store_name": {
      "type": "string",
      "description": "The business name, shown where the pass shows the store."
    }
  }
}
preview_card_designs annotations
{
  "title": "Preview loyalty card designs",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
list_stores — List stores
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

list_stores input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}
list_stores annotations
{
  "title": "List stores",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_store_setup — Get store setup
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_store_setup input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "store_id": {
      "type": "integer",
      "description": "Store id from list_stores. Optional when the login has one store."
    }
  }
}
get_store_setup annotations
{
  "title": "Get store setup",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
list_cards — List loyalty cards
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lists a store's loyalty cards with their rewards.

list_cards input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "store_id": {
      "type": "integer",
      "description": "Store id from list_stores. Optional when the login has one store."
    },
    "include_archived": {
      "type": "boolean",
      "description": "Include archived cards. Default false."
    }
  }
}
list_cards annotations
{
  "title": "List loyalty cards",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_card — Show a loyalty card
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

get_card input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "card_id"
  ],
  "properties": {
    "card_id": {
      "type": "integer",
      "description": "Card id from list_cards."
    }
  }
}
get_card annotations
{
  "title": "Show a loyalty card",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
create_store — Create a store
Advertised by the server during the last successful anonymous check.
Open-world

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.

create_store input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 60,
      "description": "Store name in Leal, usually the business or client name, e.g. \"Bean There Coffee\"."
    },
    "logo_url": {
      "type": "string",
      "description": "Public https URL of the wide logo (PNG, JPEG, WebP, GIF or SVG), e.g. from get_brand_kit."
    },
    "agency_id": {
      "type": "integer",
      "description": "Agency id from list_stores. Only needed when this login runs several agencies."
    },
    "store_name": {
      "type": "string",
      "maxLength": 60,
      "description": "Public name customers see on cards and signup pages, if different from name."
    },
    "square_logo_url": {
      "type": "string",
      "description": "Public https URL of a square logo or icon."
    }
  }
}
create_store annotations
{
  "title": "Create a store",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
update_store — Update store name and logo
Advertised by the server during the last successful anonymous check.
Advertised destructiveOpen-world

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.

update_store input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "logo_url": {
      "type": "string",
      "description": "Public https URL of the wide logo."
    },
    "store_id": {
      "type": "integer",
      "description": "Store id from list_stores. Optional when the login has one store."
    },
    "store_name": {
      "type": "string",
      "maxLength": 60,
      "description": "The business name customers know, e.g. \"Bean There Coffee\"."
    },
    "square_logo_url": {
      "type": "string",
      "description": "Public https URL of a square logo or icon."
    }
  }
}
update_store annotations
{
  "title": "Update store name and logo",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": true
}
create_card — Create a loyalty card
Advertised by the server during the last successful anonymous check.
Open-world

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.

create_card input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name",
    "rewards"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 60,
      "description": "Internal name for the card, e.g. \"Coffee card\". Shown in Leal, not on the pass."
    },
    "rewards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "stamps_required"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 60
          },
          "description": {
            "type": "string",
            "maxLength": 200
          },
          "stamps_required": {
            "type": "integer",
            "minimum": 1,
            "description": "Stamps spent to redeem. Usually equal to the card's stamps_required."
          }
        }
      },
      "maxItems": 5,
      "minItems": 1,
      "description": "Rewards customers can redeem, e.g. [{name: \"Free coffee\", stamps_required: 10}]. The free plan allows one reward per card."
    },
    "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."
    },
    "store_id": {
      "type": "integer",
      "description": "Store id from list_stores. Optional when the login has one store."
    },
    "card_color": {
      "type": "string",
      "description": "Pass background colour, hex (#RRGGBB)."
    },
    "stamp_icon": {
      "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"
      ],
      "type": "string",
      "description": "Icon shown in each collected stamp."
    },
    "strip_type": {
      "enum": [
        "color",
        "preset",
        "image"
      ],
      "type": "string",
      "description": "Background of the stamp strip: a flat colour, one of Leal's preset photos, or an image from strip_image_url."
    },
    "text_color": {
      "type": "string",
      "description": "Colour of all text on the pass, hex. Must read clearly on card_color (4.5:1 contrast or better)."
    },
    "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."
    },
    "stamp_color": {
      "type": "string",
      "description": "Colour of the icon inside a collected stamp, hex. Must read clearly on stamp_background_color."
    },
    "strip_color": {
      "type": "string",
      "description": "Strip colour, hex. Also shows behind preset and image strips when strip_opacity is below 100."
    },
    "strip_preset": {
      "enum": [
        "coffee_beans",
        "coffee_cup",
        "bakery",
        "pizza",
        "sushi",
        "burger",
        "ice_cream",
        "smoothie",
        "flowers",
        "spa"
      ],
      "type": "string",
      "description": "Preset strip photo, used when strip_type is preset."
    },
    "strip_opacity": {
      "type": "integer",
      "maximum": 100,
      "minimum": 0,
      "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."
    },
    "initial_stamps": {
      "type": "integer",
      "minimum": 0,
      "description": "Stamps a new customer starts with (a head start). Must be less than stamps_required."
    },
    "square_logo_url": {
      "type": "string",
      "description": "Public https URL of a square logo or icon, used as the round logo on Google Wallet."
    },
    "stamps_required": {
      "type": "integer",
      "maximum": 21,
      "minimum": 1,
      "description": "Stamps needed to fill the card. 6, 8 or 10 are common."
    },
    "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."
    },
    "auxiliary_fields": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "value"
        ],
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 20
          },
          "value": {
            "type": "string",
            "maxLength": 30
          }
        }
      },
      "maxItems": 2,
      "description": "Up to two extra front-of-pass fields, e.g. {label: \"Perk\", value: \"10% off pastries\"}."
    },
    "show_member_field": {
      "type": "boolean",
      "description": "Show the customer's name on the front of the pass. Default true."
    },
    "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."
    },
    "show_stamps_to_reward_field": {
      "type": "boolean",
      "description": "Show how many stamps until the next reward. Default true."
    }
  }
}
create_card annotations
{
  "title": "Create a loyalty card",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
update_card — Update a loyalty card
Advertised by the server during the last successful anonymous check.
Advertised destructiveOpen-world

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.

update_card input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "card_id"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 60,
      "description": "Internal name for the card, e.g. \"Coffee card\". Shown in Leal, not on the pass."
    },
    "card_id": {
      "type": "integer",
      "description": "Card id from list_cards."
    },
    "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."
    },
    "card_color": {
      "type": "string",
      "description": "Pass background colour, hex (#RRGGBB)."
    },
    "stamp_icon": {
      "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"
      ],
      "type": "string",
      "description": "Icon shown in each collected stamp."
    },
    "strip_type": {
      "enum": [
        "color",
        "preset",
        "image"
      ],
      "type": "string",
      "description": "Background of the stamp strip: a flat colour, one of Leal's preset photos, or an image from strip_image_url."
    },
    "text_color": {
      "type": "string",
      "description": "Colour of all text on the pass, hex. Must read clearly on card_color (4.5:1 contrast or better)."
    },
    "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."
    },
    "stamp_color": {
      "type": "string",
      "description": "Colour of the icon inside a collected stamp, hex. Must read clearly on stamp_background_color."
    },
    "strip_color": {
      "type": "string",
      "description": "Strip colour, hex. Also shows behind preset and image strips when strip_opacity is below 100."
    },
    "strip_preset": {
      "enum": [
        "coffee_beans",
        "coffee_cup",
        "bakery",
        "pizza",
        "sushi",
        "burger",
        "ice_cream",
        "smoothie",
        "flowers",
        "spa"
      ],
      "type": "string",
      "description": "Preset strip photo, used when strip_type is preset."
    },
    "strip_opacity": {
      "type": "integer",
      "maximum": 100,
      "minimum": 0,
      "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."
    },
    "initial_stamps": {
      "type": "integer",
      "minimum": 0,
      "description": "Stamps a new customer starts with (a head start). Must be less than stamps_required."
    },
    "square_logo_url": {
      "type": "string",
      "description": "Public https URL of a square logo or icon, used as the round logo on Google Wallet."
    },
    "stamps_required": {
      "type": "integer",
      "maximum": 21,
      "minimum": 1,
      "description": "Stamps needed to fill the card. 6, 8 or 10 are common."
    },
    "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."
    },
    "auxiliary_fields": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "value"
        ],
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 20
          },
          "value": {
            "type": "string",
            "maxLength": 30
          }
        }
      },
      "maxItems": 2,
      "description": "Up to two extra front-of-pass fields, e.g. {label: \"Perk\", value: \"10% off pastries\"}."
    },
    "show_member_field": {
      "type": "boolean",
      "description": "Show the customer's name on the front of the pass. Default true."
    },
    "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."
    },
    "show_stamps_to_reward_field": {
      "type": "boolean",
      "description": "Show how many stamps until the next reward. Default true."
    }
  }
}
update_card annotations
{
  "title": "Update a loyalty card",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": true
}
create_reward — Add a reward to a card
Advertised by the server during the last successful anonymous check.

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

create_reward input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "card_id",
    "name",
    "stamps_required"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 60,
      "description": "What the customer gets, e.g. \"Free coffee\"."
    },
    "card_id": {
      "type": "integer",
      "description": "Card id from list_cards."
    },
    "description": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional details, e.g. \"Any size, any drink\"."
    },
    "stamps_required": {
      "type": "integer",
      "minimum": 1,
      "description": "Stamps spent to redeem it."
    }
  }
}
create_reward annotations
{
  "title": "Add a reward to a card",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
update_reward — Update a reward
Advertised by the server during the last successful anonymous check.
Advertised destructive

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

update_reward input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "reward_id"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 60
    },
    "active": {
      "type": "boolean",
      "description": "false hides the reward from customers and staff."
    },
    "reward_id": {
      "type": "integer",
      "description": "Reward id from list_cards or get_store_setup."
    },
    "description": {
      "type": "string",
      "maxLength": 200
    },
    "stamps_required": {
      "type": "integer",
      "minimum": 1
    }
  }
}
update_reward annotations
{
  "title": "Update a reward",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": true
}
create_location — Add a store location
Advertised by the server during the last successful anonymous check.

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

create_location input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name",
    "address"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 60,
      "description": "e.g. \"Main Street\" or the store name for a single shop."
    },
    "address": {
      "type": "string",
      "maxLength": 300,
      "description": "Full street address including town and postcode."
    },
    "store_id": {
      "type": "integer",
      "description": "Store id from list_stores. Optional when the login has one store."
    }
  }
}
create_location annotations
{
  "title": "Add a store location",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
create_poster — Create a signup poster
Advertised by the server during the last successful anonymous check.
Open-world

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.

create_poster input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "card_id"
  ],
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 60,
      "description": "Headline, e.g. \"Join our coffee club\". Defaults to the card name."
    },
    "card_id": {
      "type": "integer",
      "description": "Card id from list_cards."
    },
    "paper_size": {
      "enum": [
        "a4",
        "a5",
        "a6",
        "letter"
      ],
      "type": "string",
      "description": "Default a4."
    },
    "text_color": {
      "type": "string",
      "description": "Poster text colour, hex. Defaults to the card's text colour."
    },
    "primary_color": {
      "type": "string",
      "description": "Poster background colour, hex. Defaults to the card colour."
    },
    "secondary_color": {
      "type": "string",
      "description": "Accent panel colour, hex."
    },
    "require_birthday": {
      "type": "boolean",
      "description": "Ask for a birthday (for birthday rewards). Default false."
    },
    "contact_collection_mode": {
      "enum": [
        "email_and_phone",
        "email_only",
        "phone_only"
      ],
      "type": "string",
      "description": "What the signup form asks for. Default email_and_phone."
    }
  }
}
create_poster annotations
{
  "title": "Create a signup poster",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

2 advertised

setup_loyalty_program — Set up a loyalty programme

Advertised by the server during the last successful anonymous check.

Walks through setting up a store on Leal from its website: card design, reward, poster and location.

website
The business's website, e.g. beanthere.coffee
business
What the business is, if there's no website, e.g. "a small bakery in Galway"
design_card_from_website — Design a card from my website

Advertised by the server during the last successful anonymous check.

Proposes loyalty card designs that match a website's brand. No Leal account needed.

website
e.g. beanthere.coffee (required)

Resources

1 advertised

card_preview — Loyalty card preview

Advertised by the server during the last successful anonymous check.

Apple Wallet and Google Wallet previews of Leal loyalty card designs.

card_preview URI
ui://leal/card-preview-v1.html

MIME type: text/html;profile=mcp-app

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (3 of 3 answered).

  1. 2026-11-02: 3 of 3 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
2599 ms
95th percentile latency
2599 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 2599 ms · metadata changed · 15 tool(s), 1 resource(s), 0 resource template(s), 2 prompt(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http leal-mcp https://mcp.getleal.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add leal-mcp --url https://mcp.getleal.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable leal-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "leal-mcp": {
      "url": "https://mcp.getleal.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "leal-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.getleal.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start leal-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "leal-mcp": {
      "type": "http",
      "url": "https://mcp.getleal.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http leal-mcp https://mcp.getleal.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "leal-mcp": {
      "url": "https://mcp.getleal.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "leal-mcp": {
      "serverUrl": "https://mcp.getleal.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Leal MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 1,029

Do you run Leal MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing