Skip to main content
Glama
Sign In

Tanatasa Beauty

by sg.tanatasa
OverviewDiscussionsAdmin

search_products

Read-onlyIdempotent

Find Tanatasa products to buy for Singapore delivery: pantry, household, health, personal care and beauty, 100% authentic. Delivery is free anywhere in Singapore with no minimum spend, so prices shown are delivered prices. Searches by words, brand, category, purpose, skin type, ingredient, stock, price (SGD cents) and delivery time; sort by price, unit_price or delivery. Each result has variant_id, price, unit pricing, stock and estimated_delivery_date; store-wide terms are in offer_terms. Follow next_page for more.

Input Schema

NameRequiredDescriptionDefault
qNoSearch words, e.g. "cerave cleanser" or "gift for dad under $40". A price phrase sets max_price when it is absent.
pageNoResult page; use next_page from the previous result.
sortNorelevance (default), price (lowest first), price_desc, unit_price (lowest price per 100ml/100g first; items without a comparable size last) or delivery (fastest first).relevance
brandNoBrand name or slug.
limitNoResults per page (1-50).
purposeNoWhat it is for, e.g. "sensitive-skin".
categoryNoCategory name or slug, e.g. "pantry" or "skincare".
in_stockNoOnly variants available now.
max_priceNoHighest price in SGD cents (S$40 is 4000).
min_priceNoLowest price in SGD cents.
skin_typeNoe.g. "oily", "dry", "sensitive".
ingredientNoA key ingredient, e.g. "ceramides".
guest_tokenNoOptional. Your guest_token from create_cart, if you have one, so this lookup belongs to your shopping session. Not needed to search or read products.
max_delivery_daysNoOnly items delivered within this many Singapore working days (each result shows its estimated_delivery_date).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
-  "anyOf": [
-    {
-      "$schema": "http://json-schema.org/draft-07/schema#",
-      "additionalProperties": true,
-      "properties": {
-        "catalog_observed_at": {
-          "anyOf": [
-            {
-              "format": "date-time",
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "When catalogue rows were read, retained on cache hits. Null for a batch (see each result) or a query needing no catalogue read. Not supplier verification time."
-        },
-        "currency": {
-          "const": "SGD",
-          "type": "string"
-        },
-        "freshness": {
-          "additionalProperties": true,
-          "properties": {
-            "catalog_cache_max_age_seconds": {
-              "type": "integer"
-            },
-            "revalidation": {
-              "type": "string"
-            },
-            "stock_reserved": {
-              "const": false,
-              "type": "boolean"
-            }
-          },
-          "required": [
-            "catalog_cache_max_age_seconds",
-            "stock_reserved",
-            "revalidation"
-          ],
-          "type": "object"
-        },
-        "generated_at": {
-          "description": "Response generation time, not the supplier's stock-verification time.",
-          "format": "date-time",
-          "type": "string"
-        },
-        "money_unit": {
-          "const": "cents",
-          "type": "string"
-        },
-        "next_action": {
-          "type": "string"
-        },
-        "next_page": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "offer_terms": {
-          "additionalProperties": true,
-          "properties": {
-            "account_required": {
-              "type": "boolean"
-            },
-            "authentic": {
-              "type": "boolean"
-            },
-            "delivery_area": {
-              "type": "string"
-            },
-            "free_delivery": {
-              "type": "boolean"
-            },
-            "minimum_spend": {
-              "description": "Integer SGD cents; 1690 means S$16.90.",
-              "minimum": 0,
-              "type": "integer"
-            },
-            "return_policy": {
-              "additionalProperties": true,
-              "properties": {
-                "condition": {
-                  "type": "string"
-                },
-                "policy_url": {
-                  "format": "uri",
-                  "type": "string"
-                },
-                "summary": {
-                  "type": "string"
-                },
-                "window_days": {
-                  "type": "integer"
-                }
-              },
-              "required": [
-                "window_days",
-                "condition",
-                "summary",
-                "policy_url"
-              ],
-              "type": "object"
-            },
-            "seller": {
-              "type": "string"
-            },
-            "shipping_cost": {
-              "description": "Integer SGD cents; 1690 means S$16.90.",
-              "minimum": 0,
-              "type": "integer"
-            }
-          },
-          "required": [
-            "seller",
-            "free_delivery",
-            "delivery_area",
-            "minimum_spend",
-            "shipping_cost",
-            "return_policy",
-            "authentic",
-            "account_required"
-          ],
-          "type": "object"
-        },
-        "page": {
-          "type": "integer"
-        },
-        "products": {
-          "items": {
-            "additionalProperties": true,
-            "properties": {
-              "available": {
-                "type": "boolean"
-              },
-              "brand": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "category": {
-                "anyOf": [
-                  {
-                    "additionalProperties": true,
-                    "properties": {
-                      "name": {
-                        "type": "string"
-                      },
-                      "path": {
-                        "items": {
-                          "type": "string"
-                        },
-                        "type": "array"
-                      },
-                      "slug": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "slug",
-                      "name",
-                      "path"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "compare_at_price": {
-                "anyOf": [
-                  {
-                    "description": "Integer SGD cents; 1690 means S$16.90.",
-                    "minimum": 0,
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "Integer SGD cents; 1690 means S$16.90."
-              },
-              "condition": {
-                "type": "string"
-              },
-              "condition_label": {
-                "type": "string"
-              },
-              "currency": {
-                "const": "SGD",
-                "type": "string"
-              },
-              "delivery_estimate": {
-                "additionalProperties": true,
-                "properties": {
-                  "estimated_delivery_date": {
-                    "description": "Estimated Singapore delivery date, YYYY-MM-DD; not a guarantee.",
-                    "type": "string"
-                  },
-                  "working_days": {
-                    "additionalProperties": true,
-                    "properties": {
-                      "max": {
-                        "type": "integer"
-                      },
-                      "min": {
-                        "type": "integer"
-                      }
-                    },
-                    "required": [
-                      "min",
-                      "max"
-                    ],
-                    "type": "object"
-                  }
-                },
-                "required": [
-                  "working_days",
-                  "estimated_delivery_date"
-                ],
-                "type": "object"
-              },
-              "expiry": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "fulfilment": {
-                "additionalProperties": true,
-                "properties": {
-                  "code": {
-                    "type": "string"
-                  },
-                  "label": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "code",
-                  "label"
-                ],
-                "type": "object"
-              },
-              "gtin": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "image": {
-                "anyOf": [
-                  {
-                    "additionalProperties": true,
-                    "properties": {
-                      "alt": {
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "height": {
-                        "anyOf": [
-                          {
-                            "exclusiveMinimum": 0,
-                            "type": "integer"
-                          },
-                          {
-                            "type": "null"
-                          }
-                        ]
-                      },
-                      "mime_type": {
-                        "description": "MIME type inferred from the stored image URL extension; null when unknown.",
-                        "type": [
-                          "string",
-                          "null"
-                        ]
-                      },
-                      "url": {
-                        "format": "uri",
-                        "type": "string"
-                      },
-                      "width": {
-                        "anyOf": [
-                          {
-                            "exclusiveMinimum": 0,
-                            "type": "integer"
-                          },
-                          {
-                            "type": "null"
-                          }
-                        ]
-                      }
-                    },
-                    "required": [
-                      "url",
-                      "alt",
-                      "width",
-                      "height",
-                      "mime_type"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "image_url": {
-                "anyOf": [
-                  {
-                    "format": "uri",
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "max_quantity": {
-                "type": "integer"
-              },
-              "name": {
-                "type": "string"
-              },
-              "option_name": {
-                "type": "string"
-              },
-              "product_id": {
-                "type": "integer"
-              },
-              "product_name": {
-                "type": "string"
-              },
-              "sku": {
-                "type": "string"
-              },
-              "slug": {
-                "type": "string"
-              },
-              "stock_source": {
-                "type": "string"
-              },
-              "tanatasa_pick": {
-                "type": "boolean"
-              },
-              "unit_price": {
-                "description": "Integer SGD cents; 1690 means S$16.90.",
-                "minimum": 0,
-                "type": "integer"
-              },
-              "unit_pricing": {
-                "anyOf": [
-                  {
-                    "additionalProperties": true,
-                    "properties": {
-                      "basis": {
-                        "enum": [
-                          "ml",
-                          "g"
-                        ],
-                        "type": "string"
-                      },
-                      "per_100": {
-                        "description": "Integer SGD cents; 1690 means S$16.90.",
-                        "minimum": 0,
-                        "type": "integer"
-                      },
-                      "per_1000": {
-                        "description": "Integer SGD cents; 1690 means S$16.90.",
-                        "minimum": 0,
-                        "type": "integer"
-                      },
-                      "per_1000_label": {
-                        "type": "string"
-                      },
-                      "per_100_label": {
-                        "type": "string"
-                      },
-                      "total_quantity": {
-                        "type": "number"
-                      }
-                    },
-                    "required": [
-                      "basis",
-                      "total_quantity",
-                      "per_100",
-                      "per_1000",
-                      "per_100_label",
-                      "per_1000_label"
-                    ],
-                    "type": "object"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "url": {
-                "format": "uri",
-                "type": "string"
-              },
-              "variant_id": {
-                "type": "integer"
-              }
-            },
-            "required": [
-              "variant_id",
-              "product_id",
-              "slug",
-              "sku",
-              "name",
-              "option_name",
-              "product_name",
-              "brand",
-              "currency",
-              "unit_price",
-              "compare_at_price",
-              "available",
-              "max_quantity",
-              "url",
-              "image_url",
-              "image",
-              "gtin",
-              "condition",
-              "condition_label",
-              "expiry",
-              "stock_source",
-              "fulfilment",
-              "tanatasa_pick",
-              "unit_pricing",
-              "category",
-              "delivery_estimate"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        }
-      },
-      "required": [
-        "currency",
-        "money_unit",
-        "generated_at",
-        "catalog_observed_at",
-        "freshness",
-        "offer_terms",
-        "products",
-        "page",
-        "next_page",
-        "next_action"
-      ],
-      "type": "object"
-    },
-    {
-      "additionalProperties": true,
-      "properties": {
-        "error": {
-          "additionalProperties": true,
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "code",
-            "message"
-          ],
-          "type": "object"
-        }
-      },
-      "required": [
-        "error"
-      ],
-      "type": "object"
-    }
-  ],
-  "type": "object"
-}New value: +null
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "anyOf": [
+    {
+      "$schema": "http://json-schema.org/draft-07/schema#",
+      "additionalProperties": true,
+      "properties": {
+        "catalog_observed_at": {
+          "anyOf": [
+            {
+              "format": "date-time",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "When catalogue rows were read, retained on cache hits. Null for a batch (see each result) or a query needing no catalogue read. Not supplier verification time."
+        },
+        "currency": {
+          "const": "SGD",
+          "type": "string"
+        },
+        "freshness": {
+          "additionalProperties": true,
+          "properties": {
+            "catalog_cache_max_age_seconds": {
+              "type": "integer"
+            },
+            "revalidation": {
+              "type": "string"
+            },
+            "stock_reserved": {
+              "const": false,
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "catalog_cache_max_age_seconds",
+            "stock_reserved",
+            "revalidation"
+          ],
+          "type": "object"
+        },
+        "generated_at": {
+          "description": "Response generation time, not the supplier's stock-verification time.",
+          "format": "date-time",
+          "type": "string"
+        },
+        "money_unit": {
+          "const": "cents",
+          "type": "string"
+        },
+        "next_action": {
+          "type": "string"
+        },
+        "next_page": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "offer_terms": {
+          "additionalProperties": true,
+          "properties": {
+            "account_required": {
+              "type": "boolean"
+            },
+            "authentic": {
+              "type": "boolean"
+            },
+            "delivery_area": {
+              "type": "string"
+            },
+            "free_delivery": {
+              "type": "boolean"
+            },
+            "minimum_spend": {
+              "description": "Integer SGD cents; 1690 means S$16.90.",
+              "minimum": 0,
+              "type": "integer"
+            },
+            "return_policy": {
+              "additionalProperties": true,
+              "properties": {
+                "condition": {
+                  "type": "string"
+                },
+                "policy_url": {
+                  "format": "uri",
+                  "type": "string"
+                },
+                "summary": {
+                  "type": "string"
+                },
+                "window_days": {
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "window_days",
+                "condition",
+                "summary",
+                "policy_url"
+              ],
+              "type": "object"
+            },
+            "seller": {
+              "type": "string"
+            },
+            "shipping_cost": {
+              "description": "Integer SGD cents; 1690 means S$16.90.",
+              "minimum": 0,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "seller",
+            "free_delivery",
+            "delivery_area",
+            "minimum_spend",
+            "shipping_cost",
+            "return_policy",
+            "authentic",
+            "account_required"
+          ],
+          "type": "object"
+        },
+        "page": {
+          "type": "integer"
+        },
+        "products": {
+          "items": {
+            "additionalProperties": true,
+            "properties": {
+              "available": {
+                "type": "boolean"
+              },
+              "brand": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "category": {
+                "anyOf": [
+                  {
+                    "additionalProperties": true,
+                    "properties": {
+                      "name": {
+                        "type": "string"
+                      },
+                      "path": {
+                        "items": {
+                          "type": "string"
+                        },
+                        "type": "array"
+                      },
+                      "slug": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "slug",
+                      "name",
+                      "path"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "compare_at_price": {
+                "anyOf": [
+                  {
+                    "description": "Integer SGD cents; 1690 means S$16.90.",
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Integer SGD cents; 1690 means S$16.90."
+              },
+              "condition": {
+                "type": "string"
+              },
+              "condition_label": {
+                "type": "string"
+              },
+              "currency": {
+                "const": "SGD",
+                "type": "string"
+              },
+              "delivery_estimate": {
+                "additionalProperties": true,
+                "properties": {
+                  "estimated_delivery_date": {
+                    "description": "Estimated Singapore delivery date, YYYY-MM-DD; not a guarantee.",
+                    "type": "string"
+                  },
+                  "working_days": {
+                    "additionalProperties": true,
+                    "properties": {
+                      "max": {
+                        "type": "integer"
+                      },
+                      "min": {
+                        "type": "integer"
+                      }
+                    },
+                    "required": [
+                      "min",
+                      "max"
+                    ],
+                    "type": "object"
+                  }
+                },
+                "required": [
+                  "working_days",
+                  "estimated_delivery_date"
+                ],
+                "type": "object"
+              },
+              "expiry": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "fulfilment": {
+                "additionalProperties": true,
+                "properties": {
+                  "code": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "code",
+                  "label"
+                ],
+                "type": "object"
+              },
+              "gtin": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "image": {
+                "anyOf": [
+                  {
+                    "additionalProperties": true,
+                    "properties": {
+                      "alt": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "height": {
+                        "anyOf": [
+                          {
+                            "exclusiveMinimum": 0,
+                            "type": "integer"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      },
+                      "mime_type": {
+                        "description": "MIME type inferred from the stored image URL extension; null when unknown.",
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "url": {
+                        "format": "uri",
+                        "type": "string"
+                      },
+                      "width": {
+                        "anyOf": [
+                          {
+                            "exclusiveMinimum": 0,
+                            "type": "integer"
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ]
+                      }
+                    },
+                    "required": [
+                      "url",
+                      "alt",
+                      "width",
+                      "height",
+                      "mime_type"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "image_url": {
+                "anyOf": [
+                  {
+                    "format": "uri",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "max_quantity": {
+                "type": "integer"
+              },
+              "name": {
+                "type": "string"
+              },
+              "option_name": {
+                "type": "string"
+              },
+              "product_id": {
+                "type": "integer"
+              },
+              "product_name": {
+                "type": "string"
+              },
+              "sku": {
+                "type": "string"
+              },
+              "slug": {
+                "type": "string"
+              },
+              "stock_source": {
+                "type": "string"
+              },
+              "tanatasa_pick": {
+                "type": "boolean"
+              },
+              "unit_price": {
+                "description": "Integer SGD cents; 1690 means S$16.90.",
+                "minimum": 0,
+                "type": "integer"
+              },
+              "unit_pricing": {
+                "anyOf": [
+                  {
+                    "additionalProperties": true,
+                    "properties": {
+                      "basis": {
+                        "enum": [
+                          "ml",
+                          "g"
+                        ],
+                        "type": "string"
+                      },
+                      "per_100": {
+                        "description": "Integer SGD cents; 1690 means S$16.90.",
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "per_1000": {
+                        "description": "Integer SGD cents; 1690 means S$16.90.",
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "per_1000_label": {
+                        "type": "string"
+                      },
+                      "per_100_label": {
+                        "type": "string"
+                      },
+                      "total_quantity": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "basis",
+                      "total_quantity",
+                      "per_100",
+                      "per_1000",
+                      "per_100_label",
+                      "per_1000_label"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "url": {
+                "format": "uri",
+                "type": "string"
+              },
+              "variant_id": {
+                "type": "integer"
+              }
+            },
+            "required": [
+              "variant_id",
+              "product_id",
+              "slug",
+              "sku",
+              "name",
+              "option_name",
+              "product_name",
+              "brand",
+              "currency",
+              "unit_price",
+              "compare_at_price",
+              "available",
+              "max_quantity",
+              "url",
+              "image_url",
+              "image",
+              "gtin",
+              "condition",
+              "condition_label",
+              "expiry",
+              "stock_source",
+              "fulfilment",
+              "tanatasa_pick",
+              "unit_pricing",
+              "category",
+              "delivery_estimate"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "currency",
+        "money_unit",
+        "generated_at",
+        "catalog_observed_at",
+        "freshness",
+        "offer_terms",
+        "products",
+        "page",
+        "next_page",
+        "next_action"
+      ],
+      "type": "object"
+    },
+    {
+      "additionalProperties": true,
+      "properties": {
+        "error": {
+          "additionalProperties": true,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "error"
+      ],
+      "type": "object"
+    }
+  ],
+  "type": "object"
+}
  3. Changed2 schema fields changed
    • addedInput schema / properties / max_delivery_days
      Added value: +{
+  "description": "Only items delivered within this many Singapore working days (each result shows its estimated_delivery_date).",
+  "maximum": 30,
+  "minimum": 1,
+  "type": "integer"
+}
    • addedInput schema / properties / sort
      Added value: +{
+  "default": "relevance",
+  "description": "relevance (default), price (lowest first), price_desc, unit_price (lowest price per 100ml/100g first; items without a comparable size last) or delivery (fastest first).",
+  "enum": [
+    "relevance",
+    "price",
+    "price_desc",
+    "unit_price",
+    "delivery"
+  ],
+  "type": "string"
+}
  4. Changed1 schema field changed
    • addedInput schema / properties / guest_token
      Added value: +{
+  "description": "Optional. Your guest_token from create_cart, if you have one, so this lookup belongs to your shopping session. Not needed to search or read products.",
+  "pattern": "^[a-f0-9]{64}$",
+  "type": "string"
+}
  5. Changed11 schema fields changed
    • addedInput schema / properties / brand / description
      Added value: +"Brand name or slug."
    • addedInput schema / properties / category / description
      Added value: +"Category name or slug, e.g. \"pantry\" or \"skincare\"."
    • addedInput schema / properties / in_stock / description
      Added value: +"Only variants available now."
    • addedInput schema / properties / ingredient / description
      Added value: +"A key ingredient, e.g. \"ceramides\"."
    • addedInput schema / properties / limit / description
      Added value: +"Results per page (1-50)."
    • addedInput schema / properties / max_price / description
      Added value: +"Highest price in SGD cents (S$40 is 4000)."
    • addedInput schema / properties / min_price / description
      Added value: +"Lowest price in SGD cents."
    • addedInput schema / properties / page / description
      Added value: +"Result page; use next_page from the previous result."
    • addedInput schema / properties / purpose / description
      Added value: +"What it is for, e.g. \"sensitive-skin\"."
    • addedInput schema / properties / q / description
      Added value: +"Search words, e.g. \"cerave cleanser\" or \"gift for dad under $40\". A price phrase sets max_price when it is absent."
    • addedInput schema / properties / skin_type / description
      Added value: +"e.g. \"oily\", \"dry\", \"sensitive\"."
  6. First observed

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, openWorld and non-destructive, so the description's job is to add commerce semantics — and it does: free delivery with no minimum spend, prices are delivered prices, currency is SGD cents, and it names the result fields (variant_id, price, unit pricing, stock, estimated_delivery_date) plus offer_terms for store-wide terms. It stops short of disclosing result caps, empty-result behavior, or rate limits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose, then capabilities, then output shape, then pagination — a logical order with essentially no filler. It is delivered as one dense block, which slightly hurts scannability for a 14-parameter tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a parameter-heavy search tool with no output schema, the description compensates well by naming the returned fields and the offer_terms block, so the agent knows what comes back. Remaining gaps are behavioral edge cases (no-results handling, page ceiling of 1000, when guest_token matters) rather than core omissions.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description restates the parameter list (words, brand, category, purpose, skin type, ingredient, stock, price, delivery time) and clarifies that prices are in SGD cents and are delivered prices, but adds no filtering syntax or interaction rules beyond what the schema already documents.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb+resource ("Find Tanatasa products to buy for Singapore delivery") and enumerates the domains covered (pantry, household, health, personal care, beauty). What's missing is explicit differentiation from siblings like get_product (single-item lookup) or search_products_batch, so an agent must infer which search surface to use.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by the enumeration of searchable facets (words, brand, category, purpose, skin type, ingredient, stock, price, delivery time), and pagination guidance is given ("Follow next_page for more"). However, there is no statement of when NOT to use it or when to prefer get_product / search_products_batch instead.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Tanatasa Beauty toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources