makeup.land

Working · 2.8 s

land.makeup/v1v1.0.0 Domain verified

Israeli cosmetics retailer: ΔE shade matching, customer wallet, cart, orders, gift cards.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://makeup.land/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_cart

Return the customer's most-recently-updated cart with per-line and total reward projection. Bearer + phone required.

phonestring, required

E.164 phone selecting the customer whose cart to return.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (8)

get_cart

Return the customer's most-recently-updated cart with per-line and total reward projection. Bearer + phone required.

Argument	Type	Description
phone*	string	E.164 phone selecting the customer whose cart to return.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "phone"
  ],
  "properties": {
    "phone": {
      "type": "string",
      "pattern": "^\\+\\d{6,15}$",
      "description": "E.164 phone selecting the customer whose cart to return."
    }
  }
}

get_customer

Return tags, ℳ-credit balance, M Club tier for the customer with the given E.164 phone. Bearer required.

Argument	Type	Description
phone*	string	E.164 phone number, e.g. +972501234567.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "phone"
  ],
  "properties": {
    "phone": {
      "type": "string",
      "pattern": "^\\+\\d{6,15}$",
      "description": "E.164 phone number, e.g. +972501234567."
    }
  }
}

get_customer_best_deals

Top deal projections based on the customer's tags + M Club tier. Bearer + phone required.

Argument	Type	Description
limit	integer	Ignored: /api/v1/customers/best-deals takes no limit.
phone*	string	E.164 phone selecting the customer.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "phone"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Ignored: /api/v1/customers/best-deals takes no limit."
    },
    "phone": {
      "type": "string",
      "pattern": "^\\+\\d{6,15}$",
      "description": "E.164 phone selecting the customer."
    }
  }
}

list_brands

Return every brand with product counts and slugs. Bearer required.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_orders

Recent orders with 6-axis status (order / payment / fulfillment / delivery / return / review). Bearer + phone required.

Argument	Type	Description
page	integer	Ignored: /api/v1/orders has no paging and returns the most recent `limit` orders.
limit	integer	Page size.
phone*	string	E.164 phone selecting the customer.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "phone"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Ignored: /api/v1/orders has no paging and returns the most recent `limit` orders."
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Page size."
    },
    "phone": {
      "type": "string",
      "pattern": "^\\+\\d{6,15}$",
      "description": "E.164 phone selecting the customer."
    }
  }
}

list_payment_links

Pending payment_requests on the customer's unpaid orders. Bearer + phone required.

Argument	Type	Description
phone*	string	E.164 phone selecting the customer.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "phone"
  ],
  "properties": {
    "phone": {
      "type": "string",
      "pattern": "^\\+\\d{6,15}$",
      "description": "E.164 phone selecting the customer."
    }
  }
}

list_products

Browse the catalog with tag, brand, near_hex (color-distance shade match), hue_family, and sort filters. Bearer becomes required when passing `phone` (rewards projection).

Argument	Type	Description
q	string	Natural-language query. Cross-lingual semantic search — `lipstick`, `שפתון`, `lápiz labial` each return Hebrew-tagged lipsticks (the sets may differ across languages but are semantically equivalent). Prefer this over `tag` for any category lookup that isn't already in exact Hebrew.
tag	string	Filter by an EXACT tag string (case-insensitive, whitespace-trimmed; no translation, no substring). Tags are Hebrew (e.g. שפתון, ביוטי, עיניים, שפתיים). English category names rarely match — use `q` instead for natural-language queries.
page	integer	1-indexed page number.
sort	string	Sort order. Default: relevance.
brand	string	Filter by brand slug or name.
limit	integer	Page size, default 10.
phone	string	E.164 phone for per-customer rewards projection. REQUIRES bearer auth. Omit for anonymous catalog browse.
near_hex	string	Target hex color for shade matching ranked by color distance (redmean-weighted RGB, not CIE ΔE). Examples: '#C2185B', 'E8D4B8'. Each returned product carries a `shade_match: {hex, delta_e}` field with the closest variant swatch and its perceptual distance.

validate_gift_card

Check a gift card's remaining balance using its code. Public endpoint — no bearer required (gated on knowledge of the code).

Argument	Type	Description
code*	string	Gift card code (full string as printed on the card).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "minLength": 1,
      "description": "Gift card code (full string as printed on the card)."
    }
  }
}

{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "q": { "type": "string", "description": "Natural-language query. Cross-lingual semantic search — `lipstick`, `שפתון`, `lápiz labial` each return Hebrew-tagged lipsticks (the sets may differ across languages but are semantically equivalent). Prefer this over `tag` for any category lookup that isn't already in exact Hebrew." }, "tag": { "type": "string", "description": "Filter by an EXACT tag string (case-insensitive, whitespace-trimmed; no translation, no substring). Tags are Hebrew (e.g. שפתון, ביוטי, עיניים, שפתיים). English category names rarely match — use `q` instead for natural-language queries." }, "page": { "type": "integer", "maximum": 9007199254740991, "minimum": 1, "description": "1-indexed page number." }, "sort": { "enum": [ "price_asc", "price_desc", "popularity", "rating", "relevance" ], "type": "string", "description": "Sort order. Default: relevance." }, "brand": { "type": "string", "description": "Filter by brand slug or name." }, "limit": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Page size, default 10." }, "phone": { "type": "string", "pattern": "^\\+\\d{6,15}$", "description": "E.164 phone for per-customer rewards projection. REQUIRES bearer auth. Omit for anonymous catalog browse." }, "near_hex": { "type": "string", "pattern": "^#?[0-9A-Fa-f]{6}$", "description": "Target hex color for shade matching ranked by color distance (redmean-weighted RGB, not CIE ΔE). Examples: '#C2185B', 'E8D4B8'. Each returned product carries a `shade_match: {hex, delta_e}` field with the closest variant swatch and its perceptual distance." }, "hue_family": { "enum": [ "red", "orange", "yellow", "green", "blue", "purple", "pink", "brown", "neutral" ], "type": "string", "description": "Post-filter on hue family. Must be paired with another filter. `neutral` is not a V1 hue family and is ignored." } } }