ProtoClinical Commerce

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Search ProtoClinical's current K-beauty catalog and manage buyer-approved carts and checkouts.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "ProtoClinical Commerce": {
      "url": "https://www.theprotoclinical.com/api/ucp/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• get_checkout

  Returns details about the checkout, including line items, totals, and any applicable discounts or taxes. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • id (required) — string — The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_checkout

  Creates a checkout. Returns checkout details, including line items, totals, and any applicable discounts or taxes. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • checkout (required) — object — Checkout properties.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• update_checkout

  Updates a checkout. Returns checkout details, including line items, totals, and any applicable discounts or taxes. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • checkout (required) — object — Checkout properties.
  • id (required) — string — The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• complete_checkout

  Completes a checkout and returns the checkout result. Returns details about the completed checkout, including order ID, Thank You Page URL, or any errors encountered. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • id (required) — string — The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'
  • checkout (required) — object — Checkout properties.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• cancel_checkout

  Cancels a checkout. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • id (required) — string — The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_cart

  Get the cart contents Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • id (required) — string — The ID of the cart. Format: 'gid://shopify/Cart/abc123'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_cart

  Creates a new cart Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • cart (required) — object — Cart properties.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• update_cart

  Perform updates to a cart. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • cart (required) — object — Cart properties.
  • id (required) — string — The ID of the cart. Format: 'gid://shopify/Cart/abc123'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• cancel_cart

  Cancels a cart. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • id (required) — string — The ID of the cart. Format: 'gid://shopify/Cart/abc123'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_order

  Get the details of an order Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • id (required) — string — The ID of the order. Format: 'gid://shopify/Order/123'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_catalog

  Search for products from the online store, hosted on Shopify. This tool can be used to search for products using natural language queries, specific filter criteria, or both. At least one of query or filters must be provided. Results are paginated, with initial results limited to improve experience. Use the pagination.cursor from the response to fetch additional pages when users request more results. Response conforms to the UCP catalog search capability (dev.ucp.shopping.catalog.search). Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • catalog (required) — object — Catalog search parameters.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• lookup_catalog

  Look up multiple products or variants by identifier. Use this tool to resolve multiple product/variant IDs in a single request. Supports: - Product IDs (gid://shopify/Product/...): Returns product with match: "featured" - Variant IDs (gid://shopify/ProductVariant/...): Returns parent product with the exact variant Results are grouped by product. Each variant includes an inputs array showing which request ID resolved to it and whether the match was exact or featured. In versions that require input correlations, only matched variants are returned. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units). Maximum 10 IDs per request.

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • catalog (required) — object — Catalog lookup parameters.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_product

  Retrieve complete product detail by identifier. Returns a singular product with a relevant set of variants, exact pricing, and real-time availability. Supports interactive option selection via selected and preferences parameters for variant narrowing and availability signals. Use for product detail page rendering and purchase decisions. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

  Parameters:

  • meta (required) — object — Metadata for UCP agent profile discovery.
  • catalog (required) — object — Product detail parameters.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.