makeup.land
Description
Israeli professional cosmetics retailer. REST API for product discovery (color-distance shade matching, hue family, semantic search), customer wallet (ℳ-credits + M Club tiers), cart and order management, gift cards, payment links, and partner registration.
Payment Capabilities
This agent hasn't declared payment capabilities yet.
Skills
Shade matching by hex
shade_matchFind products carrying a swatch close to a target hex color, ranked by color distance (redmean-weighted RGB). Supports hue_family refinement (white, black, gray, red, coral, orange, brown, nude, beige, yellow, green, blue, purple, pink) and per-customer reward projection.
Product search and filtering
product_searchSearch via `q` (cross-lingual natural-language query — Hebrew, English, transliteration all return semantically-equivalent results), or filter via `tag` (EXACT-string match against Hebrew-stored tags), `brand`, or `sort` (price / popularity / Bayesian-shrunk rating). Returns ILS and ℳ-credit prices side-by-side for tender-aware checkout.
Customer lookup and wallet balance
customer_lookupLookup customer by phone (E.164). Returns tags, ℳ-credit wallet balance, M Club tier, opportunity claims.
Cart add / update / clear
cart_managementManipulate a customer's persistent cart. Supports tender selection (ils vs credits), gift-personalization. Idempotency-Key is not enforced. Stock-gated; credits-tender items wallet-gated.
Order history and status
order_historyList a customer's recent orders with 6-axis status (order/payment/fulfillment/delivery/return/review).
Gift card validate and redeem
gift_card_redeemValidate a gift card balance (public, no auth) or redeem against an order (scope: full or giftcards). Partner-issued + internal cards unified.
Customer registration
register_customerGeneric registration orchestrator — create or look up a customer, compute partner-config-driven tags, fire WhatsApp template and partner webhooks. Designed for inbound WA proof of phone ownership. Scope: full or register, on a token with a registration source configured.
System Capabilities
Input Modes
Output Modes
Streaming
✗ Not supportedCategory
Personal / LifestyleManifest URL
https://makeup.land/.well-known/agent-card.jsonAgent Card Schema
This manifest contains structural definitions, parameters, and metadata endpoints.
{
"name": "makeup.land",
"url": "https://makeup.land/api/v1",
"version": "1.0.0",
"description": "Israeli professional cosmetics retailer. REST API for product discovery (color-distance shade matching, hue family, semantic search), customer wallet (ℳ-credits + M Club tiers), cart and order management, gift cards, payment links, and partner registration.",
"provider": {
"organization": "א. ט. הפקות בע״מ / A.T. Hafakot Ltd.",
"url": "https://makeup.land"
},
"capabilities": {
"streaming": false,
"pushNotifications": false,
"stateTransitionHistory": false
},
"defaultInputModes": [
"application/json"
],
"defaultOutputModes": [
"application/json"
],
"securitySchemes": {
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "ml_<hex>",
"description": "Long-lived bearer token issued out-of-band. Scopes: full, register, giftcards, proposals. Request via shop@makeup.land."
},
"phoneIdentifier": {
"type": "apiKey",
"description": "Phone identifier (?phone=+972... in E.164) selecting which customer's resources to return on cart, payment-links, gift-cards listing and best-deals endpoints. This is NOT a credential — bearerAuth is still required alongside. Bearer authenticates the caller; phone selects the customer."
}
},
"security": [
{
"bearerAuth": [],
"phoneIdentifier": []
},
{
"bearerAuth": []
},
{}
],
"skills": [
{
"id": "shade_match",
"name": "Shade matching by hex",
"description": "Find products carrying a swatch close to a target hex color, ranked by color distance (redmean-weighted RGB). Supports hue_family refinement (white, black, gray, red, coral, orange, brown, nude, beige, yellow, green, blue, purple, pink) and per-customer reward projection.",
"tags": [
"search",
"color",
"products",
"cosmetics"
],
"examples": [
"Find lipsticks close to #C2185B",
"Match a foundation to my skin tone #E8D4B8 with warm undertone"
],
"inputModes": [
"application/json",
"text/plain"
],
"outputModes": [
"application/json"
],
"security": [
{},
{
"bearerAuth": []
}
]
},
{
"id": "product_search",
"name": "Product search and filtering",
"description": "Search via `q` (cross-lingual natural-language query — Hebrew, English, transliteration all return semantically-equivalent results), or filter via `tag` (EXACT-string match against Hebrew-stored tags), `brand`, or `sort` (price / popularity / Bayesian-shrunk rating). Returns ILS and ℳ-credit prices side-by-side for tender-aware checkout.",
"tags": [
"search",
"catalog",
"products"
],
"examples": [
"List the top 10 most-popular lipsticks under ₪150",
"Show all NYX products with rating above 4.5"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
],
"security": [
{},
{
"bearerAuth": []
}
]
},
{
"id": "customer_lookup",
"name": "Customer lookup and wallet balance",
"description": "Lookup customer by phone (E.164). Returns tags, ℳ-credit wallet balance, M Club tier, opportunity claims.",
"tags": [
"customers",
"loyalty",
"wallet"
],
"examples": [
"Get balance for +972501234567"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
],
"security": [
{
"bearerAuth": []
}
]
},
{
"id": "cart_management",
"name": "Cart add / update / clear",
"description": "Manipulate a customer's persistent cart. Supports tender selection (ils vs credits), gift-personalization. Idempotency-Key is not enforced. Stock-gated; credits-tender items wallet-gated.",
"tags": [
"cart",
"checkout"
],
"examples": [
"Add product prod_x variant var_y quantity 2 for +972501234567",
"Switch line li_abc from ils to credits tender"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
],
"security": [
{
"bearerAuth": [],
"phoneIdentifier": []
}
]
},
{
"id": "order_history",
"name": "Order history and status",
"description": "List a customer's recent orders with 6-axis status (order/payment/fulfillment/delivery/return/review).",
"tags": [
"orders",
"history"
],
"examples": [
"List the 5 most recent orders for +972501234567"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
],
"security": [
{
"bearerAuth": []
}
]
},
{
"id": "gift_card_redeem",
"name": "Gift card validate and redeem",
"description": "Validate a gift card balance (public, no auth) or redeem against an order (scope: full or giftcards). Partner-issued + internal cards unified.",
"tags": [
"gift-cards",
"payments"
],
"examples": [
"Check balance for code GML-XXXX-XXXX-XXXX",
"Redeem code GML-XXXX-XXXX-XXXX against order ord-<uuid>"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
],
"security": [
{},
{
"bearerAuth": []
}
]
},
{
"id": "register_customer",
"name": "Customer registration",
"description": "Generic registration orchestrator — create or look up a customer, compute partner-config-driven tags, fire WhatsApp template and partner webhooks. Designed for inbound WA proof of phone ownership. Scope: full or register, on a token with a registration source configured.",
"tags": [
"customers",
"onboarding",
"whatsapp"
],
"examples": [
"Register +972501234567 with tags=['first-touch']"
],
"inputModes": [
"application/json"
],
"outputModes": [
"application/json"
],
"security": [
{
"bearerAuth": []
}
]
}
],
"additionalInterfaces": [
{
"transport": "openapi",
"url": "https://makeup.land/openapi.json",
"description": "Full OpenAPI 3.1 specification for all V1 endpoints."
},
{
"transport": "mcp-manifest",
"url": "https://makeup.land/.well-known/mcp.json",
"description": "MCP discovery manifest (companion to this card)."
},
{
"transport": "mcp",
"url": "https://makeup.land/api/mcp",
"description": "Live MCP server (Streamable-HTTP / JSON-RPC). Speaks protocolVersion 2025-06-18."
},
{
"transport": "markdown",
"url": "https://makeup.land/llms-full.txt",
"description": "Long-form agent handbook covering API, rewards model, dual-tender pricing, error envelopes."
}
]
}Actions
The **Agent Card** is a standardized JSON metadata schema containing the agent's capabilities, default inputs/outputs, and OpenAPI endpoints. Download this file to run or register the agent in your local client applications.
Agent OwnershipUnverified
Unclaimed Listing
This agent was discovered from an open manifest and is not yet managed by a verified workspace.