makeup.land

land.makeup/v1

This server connects Claude to makeup.land, an Israeli professional cosmetics retailer carrying brands like Inglot, Malu Wilz, and Adah Lazorgan. The standout feature is ΔE shade matching, which uses color science to match foundation and concealer tones to customer skin. Beyond catalog browsing, you get full e-commerce operations: customer wallet management, cart operations, order placement and tracking, and gift card handling. Useful when you need to build conversational shopping experiences for cosmetics where precise color matching matters, or when integrating makeup retail into broader beauty and styling workflows. The Hebrew-English bilingual inventory covers face, eye, lip, and special effects makeup plus brushes and tools.

tools: 8
transport: HTTP
last updated: May 24, 2026

Open website

Install

From registry metadata

$ npx add-mcp https://makeup.land/api/mcp --name v1

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http v1 https://makeup.land/api/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 8 tools

Verified live against the running server on Nov 6, 2026.

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

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).

Parameters* required

brandstring

Filter by brand slug or name.

hue_familystring

Post-filter on hue family. Must be paired with another filter. `neutral` is not a V1 hue family and is ignored.one of red · orange · yellow · green · blue · purple

limitinteger

Page size, default 10.

near_hexstring

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 w...

pageinteger

1-indexed page number.

phonestring

E.164 phone for per-customer rewards projection. REQUIRES bearer auth. Omit for anonymous catalog browse.

qstring

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

sortstring

Sort order. Default: relevance.one of price_asc · price_desc · popularity · rating · relevance

tagstring

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

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

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

No parameters. Call it with no arguments.

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

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

Parameters* required

code*string

Gift card code (full string as printed on the card).

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

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

Parameters* required

phone*string

E.164 phone number, e.g. +972501234567.

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

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

Parameters* required

phone*string

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

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

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

Parameters* required

limitinteger

Page size.

pageinteger

Ignored: /api/v1/orders has no paging and returns the most recent `limit` orders.

phone*string

E.164 phone selecting the customer.

list_payment_linksPending payment_requests on the customer's unpaid orders. Bearer + phone required.1 params

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

Parameters* required

phone*string

E.164 phone selecting the customer.

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

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

Parameters* required

limitinteger

Ignored: /api/v1/customers/best-deals takes no limit.

phone*string

E.164 phone selecting the customer.

Details

Website: makeup.land
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026