MCP.so
登录

makeup.land MCP Server

@edwinux

基本信息

分类

数据与分析

传输方式

stdio

作者

edwinux

提交者

Edwin Terek

关于 makeup.land MCP Server

Israeli professional cosmetics retailer. MCP server exposes ΔE-ranked shade matching, customer wallet lookup, cart and order tools, and gift-card validation. Catalog tools work anonymously; customer-data tools require a bearer token issued via shop@makeup.land.

#ecommerce#cosmetics#makeup#shade-matching#delta-e#hebrew#israel#retail#loyalty-wallet#shopping

makeup.land MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "makeup.land": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://makeup.land/api/mcp"
      ]
    }
  }
}

makeup.land MCP Server 工具

8

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

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

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

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

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

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

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

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

概览

What is makeup.land?

makeup.land is an Israeli professional cosmetics retailer. Its MCP server exposes the retailer’s catalog and customer‑data surfaces to AI agents via Streamable HTTP at https://makeup.land/api/mcp.

How to use makeup.land?

Call the API endpoint with JSON‑RPC requests. Anonymous catalog browsing works without a token; for authenticated tools you need a Bearer token issued out‑of‑band by emailing shop@makeup.land. See the quickstart curl example in the README for an anonymous list_products call.

Key features of makeup.land

  • Catalog browse with ΔE‑ranked shade matching, tag/brand filters, and sort.
  • Gift‑card balance validation by code.
  • Brand directory of 140+ brands (Yossi Bitton, da Vinci, INGLOT, NYX, etc.).
  • Customer profile, ℳ‑credit wallet, and M Club tier.
  • Most‑recent cart retrieval with reward projection.
  • Order history with 6‑axis status.
  • Pending payment links and personalised deal suggestions.

Use cases of makeup.land

  • Let an AI assistant search the cosmetics catalog by shade, brand, or tag.
  • Validate a gift card balance during customer service interactions.
  • Retrieve a customer’s loyalty‑tier info, wallet balance, and last cart.
  • Show recent order status and pending payment links.
  • Generate personalised offers based on customer tags and tier.

常见问题

1

What is the makeup.land MCP server?

It is an MCP server that exposes makeup.land’s catalog and customer‑data endpoints to AI agents via Streamable HTTP.

2

How do I get a Bearer token for authenticated tools?

Bearer tokens are issued out‑of‑band. Write to `shop@makeup.land` with your integration use case.

3

Which tools require authentication?

`list_brands`, `get_customer`, `get_cart`, `list_orders`, `list_payment_links`, and `get_customer_best_deals` require a Bearer token; some also need a phone number. `list_products` and `validate_gift_card` are anonymous/public.

4

Can I browse the catalog without a token?

Yes. `list_products` is anonymous, and `validate_gift_card` is public. The quickstart example shows an anonymous catalog call.

5

Where is the API hosted?

The API is hosted at `https://makeup.land/api/mcp` and uses Streamable HTTP transport.

评论

数据与分析 分类下的更多 MCP 服务器