get_cart
Return the customer's most-recently-updated cart with per-line and total reward projection. Bearer + phone required.
LABSCO SUMMARY
Shade matching that returns a number, and customer state that returns the real cart.
list_products will rank products by delta-E distance from a hex you hand it and give back the delta per product, which is the thing a general shopping search cannot do. The customer half, cart, orders, credit and pending payments, sits behind a token the retailer issues, so integrators start on the catalog.
What it is
The MCP surface of makeup.land, an Israeli professional cosmetics retailer, hosted at https://makeup.land/api/mcp as a stateless Streamable-HTTP endpoint. Catalog browsing works anonymously; the customer-data tools need a bearer token.
What you get
- Catalog browse and search with cross-lingual semantic queries, shade matching ranked by delta-E distance from a near_hex you supply, brand and exact-Hebrew tag filters, and sorting by price, popularity or Bayesian-shrunk rating (list_products)
- A gift card's remaining balance from its code, with no token required (validate_gift_card)
- Every brand carried, with product counts and slugs (list_brands)
- A customer's tags, credit wallet balance and M Club tier, looked up by E.164 phone number (get_customer)
- That customer's most recently updated cart, with per-line and total reward projections (get_cart)
- Recent orders with six-axis status covering order, payment, fulfillment, delivery, return and review (list_orders)
- Pending payment requests on unpaid orders (list_payment_links)
- Deal projections ranked for the customer's own tags and tier (get_customer_best_deals)
Requirements
Nothing for list_products, and validate_gift_card is gated only on knowing the gift-card code. Everything else needs a bearer token issued via shop@makeup.land, and the customer tools additionally need that customer's phone number in E.164 form.
Setup effort
Paste a URL — add the endpoint to your client
USE CASES
01
Finding a product that matches a colour you can point at
Give it the target hex and it ranks the catalog by delta-E distance, returning the shade match and its delta per product. That turns close enough into a number you can compare.
02
Searching a Hebrew catalog in another language
The product search is cross-lingual and semantic, and exact-Hebrew tag filters are there when you do know the term, so a query in English still reaches the right shelf.
03
Answering what is in my cart and what will it earn me
Look the customer up by phone number, then read their most recently updated cart with the reward projection per line and in total, which is the number they are actually asking about.
04
Handling where is my order
Recent orders come back with six separate status axes, so the answer distinguishes not paid yet from packed but not shipped instead of collapsing both into pending.
05
Telling a shopper what they should buy today
Deal projections are computed against that customer's tags and M Club tier, so the recommendation reflects the pricing they will actually be charged rather than the shelf price.
06
Checking a gift card balance without an account
The balance lookup is public and gated only on knowing the code, so it works before any token has been issued, which makes it the easiest way to confirm the integration is live.
8 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_customer
Return tags, ℳ-credit balance, M Club tier for the customer with the given E.164 phone. Bearer required.
get_customer_best_deals
Top deal projections based on the customer's tags + M Club tier. Bearer + phone required.
list_brands
Return every brand with product counts and slugs. Bearer required.
list_orders
Recent orders with 6-axis status (order / payment / fulfillment / delivery / return / review). Bearer + phone required.
list_payment_links
Pending payment_requests on the customer's unpaid orders. Bearer + phone required.
list_products
Browse the catalog with tag, brand, near_hex (ΔE shade match), hue_family, and sort filters. Bearer becomes required when passing phone (rewards projection).
validate_gift_card
Check a gift card's remaining balance using its code. Public endpoint — no bearer required (gated on knowledge of the code).
BEFORE YOU INSTALL
What to know first
Tools you get
8 tools when we connected.
CONTEXT COST
Light Standing cost
Rated by the size of the 8 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the endpoint to your client.
Server setup
ENDPOINT URL
https://makeup.land/api/mcp
