Servers Playground How we check Add a server Log in

Apostle — AI Men's Skincare Commerce

Working · 2.4 s

ai.searchshop/apostlemanv1.0.2 Domain verified

Search, compare, and buy Apostle men's skincare: tinted moisturizer, face wash, and sets.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

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

https://searchshopai-mcp.fly.dev/mcp/apostleman

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.

check_compatibility Read-only

Check which products are compatible with a given product. For devices, shows required consumables (e.g., conductive gel for MIRA). For topicals, shows which devices they work with. Use when a customer asks 'what gel do I need with MIRA?' or 'does this serum work with CryoSculpt?'

productstring, required

Product name or SKU to check compatibility for

Apostle — AI Men's Skincare Commerce MCP server | mcptry

Tools (10)

check_compatibility

read-only

Argument	Type	Description
product*	string	Product name or SKU to check compatibility for

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "product"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 200,
      "description": "Product name or SKU to check compatibility for"
    }
  },
  "additionalProperties": false
}

check_inventory

Check if a product is currently available. Uses Shopify Storefront API to verify real-time stock status. Use when a customer asks 'is MIRA in stock?' or before recommending a product.

read-only

Argument	Type	Description
product*	string	Product name or SKU to check availability for

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "product"
  ],
  "properties": {
    "product": {
      "type": "string",
      "maxLength": 200,
      "description": "Product name or SKU to check availability for"
    }
  },
  "additionalProperties": false
}

compare_products

Compare two or more products side by side. Use when the user asks to compare, says 'X vs Y', or wants to decide between options. Do not use for single product lookup — use get_product instead. Returns structured comparison with shared attributes, differences, tradeoffs, and a decision hint.

read-only

Argument	Type	Description
products*	array	Product titles or SKUs to compare (e.g. ['MIRA', 'CryoSculpt'])

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "products"
  ],
  "properties": {
    "products": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200
      },
      "maxItems": 5,
      "minItems": 2,
      "description": "Product titles or SKUs to compare (e.g. ['MIRA', 'CryoSculpt'])"
    }
  },
  "additionalProperties": false
}

create_checkout

Create a checkout URL for one or more products. Pass variant IDs (items) and/or product URLs (product_urls). When a product URL is provided (e.g. https://laluer.com/products/mira), the tool resolves it to a variant ID automatically — no catalog import needed. Supports discount codes, cart notes, and selling plans. Do not use unless the user wants to buy — use search_products or skincare_recommend first. Returns a direct Shopify checkout link the user can click to buy.

Argument	Type	Description
note	string	Cart note visible to the merchant
items	array	Products to add to cart by variant ID
decision_id	string	Optional — leave unset unless an earlier create_checkout error asked for it.
product_urls	array	Products to add to cart by URL — resolved to variant IDs automatically
discount_code	string	Discount code to apply (e.g. 'WELCOME10')

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 500,
      "description": "Cart note visible to the merchant"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "variant_id"
        ],
        "properties": {
          "quantity": {
            "type": "integer",
            "default": 1,
            "maximum": 10,
            "minimum": 1,
            "description": "Quantity (default 1)"
          },
          "variant_id": {
            "type": [
              "string",
              "number"
            ],
            "description": "Shopify variant ID (numeric or GID format)"
          },
          "selling_plan_id": {
            "type": "string",
            "description": "Shopify selling plan ID for subscriptions"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 20,
      "description": "Products to add to cart by variant ID"
    },
    "decision_id": {
      "type": "string",
      "maxLength": 100,
      "description": "Optional — leave unset unless an earlier create_checkout error asked for it."
    },
    "product_urls": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Shopify product URL (e.g. https://store.com/products/handle)"
          },
          "quantity": {
            "type": "integer",
            "default": 1,
            "maximum": 10,
            "minimum": 1,
            "description": "Quantity (default 1)"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 20,
      "description": "Products to add to cart by URL — resolved to variant IDs automatically"
    },
    "discount_code": {
      "type": "string",
      "maxLength": 50,
      "description": "Discount code to apply (e.g. 'WELCOME10')"
    }
  },
  "additionalProperties": false
}

deals_discounts

Show available bundles, deals, and ask about discount codes. Use when a customer asks about deals, bundles, savings, or says 'do you have any discounts?' Also use when multiple items are in cart to suggest bundle savings. Always ask if the customer has a discount code.

read-only

Argument	Type	Description
discount_code	string	Customer's discount code if they have one

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "discount_code": {
      "type": "string",
      "maxLength": 50,
      "description": "Customer's discount code if they have one"
    }
  },
  "additionalProperties": false
}

get_product

Get full details for a specific product by SKU or title. Use when the user asks about a specific product by name (e.g. 'tell me about MIRA', 'show me the serum'). Do not use for browsing or recommendations — use search_products or skincare_recommend. Returns a widget card with the product details, image, price, and checkout button.

read-only

Argument	Type	Description
sku	string	Exact product SKU (e.g. 'LL-4632379916336')
title	string	Product title to search for (fuzzy match)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "sku": {
      "type": "string",
      "description": "Exact product SKU (e.g. 'LL-4632379916336')"
    },
    "title": {
      "type": "string",
      "description": "Product title to search for (fuzzy match)"
    }
  },
  "additionalProperties": false
}

get_research_note

Get the summary and URL of a specific SearchShopAI Research Note by its slug (returned by search_research_notes).

read-only

Argument	Type	Description
slug*	string	The note slug, e.g. 'the-ai-attribution-blind-spot'

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "maxLength": 120,
      "description": "The note slug, e.g. 'the-ai-attribution-blind-spot'"
    }
  },
  "additionalProperties": false
}

search_products

Browse and search the product catalog. Use when the user wants to see what's available, look up specific products, browse by category, compare options, or asks 'show me' / 'what do you have.' Do not use when the user needs personalized recommendations based on skin concerns — use skincare_recommend instead. Returns all matching products with prices, images, and checkout. Unlike skincare_recommend, this does not score or filter — it shows everything that matches so the user can decide.

read-only

Argument	Type	Description
query*	string	Search query (e.g. 'vitamin c serum', 'anti-aging', 'moisturizer under $50')
category	string	Filter by exact product category from the catalog (e.g. 'serum', 'treatment', 'cleanser', 'moisturizer'). Do not guess categories — only use this if the user explicitly mentions a catalog category. For general queries like 'devices' or 'bundles', use the query parameter instead.
max_price	number	Filter to products at or below this price
max_results	integer	Maximum products to return (default 10). Only set this if the user specifies a count — e.g. 'show me 2 devices' → 2. Otherwise leave it unset and the default will return all relevant matches up to 10.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 500,
      "description": "Search query (e.g. 'vitamin c serum', 'anti-aging', 'moisturizer under $50')"
    },
    "category": {
      "type": "string",
      "description": "Filter by exact product category from the catalog (e.g. 'serum', 'treatment', 'cleanser', 'moisturizer'). Do not guess categories — only use this if the user explicitly mentions a catalog category. For general queries like 'devices' or 'bundles', use the query parameter instead."
    },
    "max_price": {
      "type": "number",
      "description": "Filter to products at or below this price"
    },
    "max_results": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Maximum products to return (default 10). Only set this if the user specifies a count — e.g. 'show me 2 devices' → 2. Otherwise leave it unset and the default will return all relevant matches up to 10."
    }
  },
  "additionalProperties": false
}

search_research_notes

Search SearchShopAI's Research Notes blog — data studies, playbooks, and field notes on agentic commerce (AI attribution, MCP, AI catalog accuracy, ChatGPT ads). Returns matching articles with titles, summaries, and URLs. Use when asked what SearchShopAI has written or published about a topic.

read-only

Argument	Type	Description
query*	string	Topic or keywords, e.g. 'attribution', 'MCP', 'hallucinated prices'

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "Topic or keywords, e.g. 'attribution', 'MCP', 'hallucinated prices'"
    }
  },
  "additionalProperties": false
}

shop

Start here for any shopping request. Pass the shopper's COMPLETE request in their own words and this tool will understand it and route to the right capability (personalized recommendation, catalog search, product lookup, or comparison), preserving every qualifier — concerns, skin type, budget, brand. Prefer this tool whenever the request is conversational or carries any nuance. The granular tools (search_products, get_product, compare_products, create_checkout) remain available as precise follow-ups.

read-only

Argument	Type	Description
brand	string	Secondary hint only — brand filter if stated.
intent	string	Secondary hint only — the primary signal is `request`.
request*	string	The shopper's complete request in their own words. Include every detail: concern, skin type, budget, brand, product names, questions. Do not summarize or drop qualifiers.
budget_max	number	Secondary hint only — maximum budget if stated.
product_refs	array	Secondary hint only — exact product titles/SKUs when already known.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "request"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "maxLength": 100,
      "description": "Secondary hint only — brand filter if stated."
    },
    "intent": {
      "enum": [
        "advice",
        "browse",
        "product",
        "compare",
        "buy",
        "question"
      ],
      "type": "string",
      "description": "Secondary hint only — the primary signal is `request`."
    },
    "request": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 1,
      "description": "The shopper's complete request in their own words. Include every detail: concern, skin type, budget, brand, product names, questions. Do not summarize or drop qualifiers."
    },
    "budget_max": {
      "type": "number",
      "description": "Secondary hint only — maximum budget if stated."
    },
    "product_refs": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200
      },
      "maxItems": 5,
      "description": "Secondary hint only — exact product titles/SKUs when already known."
    }
  },
  "additionalProperties": false
}