MyHairMail Agent Tools

Check wig stock by colour

check_stock

Read-onlyIdempotent

Live availability of one wig or hairpiece style at MyHairMail, per colour, from the manufacturer's factory feed (not a nightly sync). Distinguishes backordered and discontinued colours, which the Shopify catalog reports as 'available' or omits. availability is one of in_stock | backordered (orderable now, ships when restocked; restock_eta_week given when known) | out_of_stock | discontinued (will not restock). Returns price_usd, compare_at_price_usd and a product_url to buy on myhairmail.com. With color: one product; without color: up to 12 colours (has_more=true means query a specific colour). Not found: did_you_mean styles, or supported_brands if the brand is not carried. When a colour is not buyable now, the response includes next_step naming the tool that finds an equivalent. Never returns quantities. Terms: https://mcp.myhairmailtools.com/terms

Input Schema

TableJSON Schema

Name	Required	Description
`brand`	Yes	Brand name, e.g. 'Jon Renau', 'Raquel Welch', 'Belle Tress'
`color`	No	Color code or name, e.g. '12FS8' or 'Shaded Praline'. Optional; if omitted, returns per-color availability for up to 12 colors.
`style`	Yes	Style name, e.g. 'Luna', 'Vesper'

Output Schema

TableJSON Schema

Name	Required	Description	Default
`note`	No
`match`	Yes
`colors`	No
`product`	No
`has_more`	No
`retailer`	Yes
`next_step`	No
`did_you_mean`	No
`supported_brands`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 27, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": {},
+  "properties": {
+    "colors": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "availability": {
+            "enum": [
+              "in_stock",
+              "out_of_stock",
+              "backordered",
+              "discontinued"
+            ],
+            "type": "string"
+          },
+          "brand": {
+            "type": "string"
+          },
+          "color": {
+            "type": "string"
+          },
+          "compare_at_price_usd": {
+            "type": "number"
+          },
+          "eta_display": {
+            "type": "string"
+          },
+          "price_usd": {
+            "type": "number"
+          },
+          "product_url": {
+            "type": "string"
+          },
+          "restock_eta_week": {
+            "type": "string"
+          },
+          "ships_today_cutoff": {
+            "type": "string"
+          },
+          "style": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "brand",
+          "style",
+          "availability",
+          "price_usd",
+          "product_url"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "did_you_mean": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "brand": {
+            "type": "string"
+          },
+          "color": {
+            "type": "string"
+          },
+          "style": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "brand",
+          "style"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "has_more": {
+      "type": "boolean"
+    },
+    "match": {
+      "type": "boolean"
+    },
+    "next_step": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "type": "string"
+        },
+        "tool": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "tool",
+        "reason"
+      ],
+      "type": "object"
+    },
+    "note": {
+      "type": "string"
+    },
+    "product": {
+      "additionalProperties": {},
+      "properties": {
+        "availability": {
+          "enum": [
+            "in_stock",
+            "out_of_stock",
+            "backordered",
+            "discontinued"
+          ],
+          "type": "string"
+        },
+        "brand": {
+          "type": "string"
+        },
+        "color": {
+          "type": "string"
+        },
+        "compare_at_price_usd": {
+          "type": "number"
+        },
+        "eta_display": {
+          "type": "string"
+        },
+        "price_usd": {
+          "type": "number"
+        },
+        "product_url": {
+          "type": "string"
+        },
+        "restock_eta_week": {
+          "type": "string"
+        },
+        "ships_today_cutoff": {
+          "type": "string"
+        },
+        "style": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "brand",
+        "style",
+        "availability",
+        "price_usd",
+        "product_url"
+      ],
+      "type": "object"
+    },
+    "retailer": {
+      "type": "string"
+    },
+    "supported_brands": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "match",
+    "retailer"
+  ],
+  "type": "object"
+}

First observedSep 26, 2026

TDQS

Score is being calculated.

All MyHairMail Agent Tools tools Inspect

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

Need Help?