Server definition
- Hash
- sha256:5ed2a49c5cc1a11e247ebf2d4542506ff203e990401aa67d5781066b8bb13d6b
- What it is
- What a remote MCP server returned when asked what it offers: 10 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Generate the direct 1-click checkout purchase URL for a specific product and size index (https://s.polopan.com/p/{handle}/{size_index}).\n\nMANDATORY AGENT INSTRUCTION:\nOnly generate or provide this direct link with /{size_index} after the user has explicitly selected/confirmed their size from the available in-stock options. If there is any confusion regarding sizes or if the user is still browsing, provide ONLY the clean base link (https://s.polopan.com/p/{handle}) without /{size_index}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"coupon": {
"description": "Optional discount coupon code to pre-apply",
"type": "string"
},
"handle": {
"description": "Unique product handle identifier",
"minLength": 1,
"type": "string"
},
"quantity": {
"default": 1,
"description": "Number of units to purchase (1-10)",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"size": {
"description": "Size label confirmed by the user (e.g. 'M', 'L', 'XL')",
"type": "string"
},
"size_index": {
"description": "Zero-based index of the chosen size variant",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"handle"
],
"type": "object"
},
"name": "checkout.links.get_direct_url",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"checkout_url": {
"description": "Direct 1-click purchase permalink (https://s.polopan.com/p/{handle}/{size_index})",
"type": "string"
},
"handle": {
"description": "Product handle",
"type": "string"
},
"size": {
"description": "Selected size",
"type": "string"
},
"size_index": {
"description": "Selected size index",
"type": "number"
}
},
"required": [
"handle",
"size_index",
"checkout_url"
],
"type": "object"
}
},
{
"description": "Discover complete curated fashion looks styled for specific occasions (e.g., 'Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal'). All returned looks are verified 100% in-stock (any look with an out-of-stock item is excluded).\n\nMANDATORY AGENT INSTRUCTIONS:\n1. Always inform the user of available in-stock sizes, shipping SLA, and return policy for each item. Format negative return days as 'Exchange only |X| days' (e.g. -7 -> 'Exchange only 7 days').\n2. When shortlisting a look, render the product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care).\n3. Provide the clean base link (https://s.polopan.com/p/{handle}) during browsing/shortlisting. Provide direct 1-click checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"age": {
"default": 25,
"description": "Target demographic age",
"maximum": 99,
"minimum": 16,
"type": "integer"
},
"gender": {
"default": "women",
"description": "Target gender filter: 'women' or 'men'",
"enum": [
"women",
"men",
"female",
"male"
],
"type": "string"
},
"occasion": {
"description": "Target occasion or vibe: 'Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal'",
"type": "string"
},
"page": {
"default": 1,
"description": "Page number for looks pagination",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"page_size": {
"default": 10,
"description": "Number of looks per page",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"vendor": {
"description": "Optional brand filter",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": "looks.curation.by_occasion",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"looks": {
"description": "List of verified in-stock occasion looks",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Unique look ID",
"type": "string"
},
"image_url": {
"description": "Main styled look image",
"type": "string"
},
"occasion": {
"description": "Occasion tag",
"type": "string"
},
"products": {
"description": "100% in-stock items in this outfit",
"items": {
"additionalProperties": false,
"properties": {
"handle": {
"description": "Product handle",
"type": "string"
},
"price": {
"description": "Price",
"type": "number"
},
"title": {
"description": "Product title",
"type": "string"
},
"url": {
"description": "Purchase link",
"type": "string"
}
},
"required": [
"handle",
"title",
"price",
"url"
],
"type": "object"
},
"type": "array"
},
"title": {
"description": "Look title",
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"looks"
],
"type": "object"
}
},
{
"description": "Get complete recommended outfits. Pass a product 'handle' to find complementary items that style with it, OR pass an 'occasion' (e.g. 'Wedding', 'Party', 'Cocktail', 'Date Night') and 'gender' to discover full occasion looks. All returned looks are verified 100% in-stock (any look with an out-of-stock item is excluded).\n\nMANDATORY AGENT INSTRUCTIONS:\n1. Always inform the user of available in-stock sizes, shipping SLA, and return policy for each item. Format negative return days as 'Exchange only |X| days' (e.g. -7 -> 'Exchange only 7 days').\n2. When shortlisting a look, render the product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care).\n3. Provide the base link (https://s.polopan.com/p/{handle}) during shortlisting. Provide direct 1-click checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"gender": {
"default": "women",
"description": "Target gender filter: 'women' or 'men'",
"enum": [
"women",
"men",
"female",
"male"
],
"type": "string"
},
"handle": {
"description": "Product handle to build coordinating outfits around",
"type": "string"
},
"occasion": {
"description": "Target occasion or aesthetic theme (e.g. 'Wedding', 'Party', 'Cocktail', 'Date Night')",
"type": "string"
},
"page": {
"default": 1,
"description": "Page number for pagination",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Number of outfits per page",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "looks.curation.recommend",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"handle": {
"description": "Base product handle",
"type": "string"
},
"looks": {
"description": "List of recommended outfits",
"items": {
"additionalProperties": false,
"properties": {
"image_url": {
"description": "Look image URL",
"type": "string"
},
"title": {
"description": "Outfit title",
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Verify real-time stock availability, live discounted pricing, product specifications table (Fabric, Collar, Sleeves, Fit, Bottom, Care Instructions), shipping/return policies, and available sizes for a product. \n\nMANDATORY AGENT INSTRUCTIONS:\n1. Always tell the user the available in-stock sizes, and display returning & shipping policies (Negative return days = 'Exchange only |X| days').\n2. When presenting/shortlisting products, display the product specifications table.\n3. Return the base link (https://s.polopan.com/p/{handle}) during browsing. Provide the direct checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"desired_size": {
"description": "Optional size query to verify (e.g. 'M', 'L', 'XL', '32', '40')",
"type": "string"
},
"handle": {
"description": "Unique product handle identifier",
"minLength": 1,
"type": "string"
},
"size_index": {
"description": "Zero-based index of the size variant",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"handle"
],
"type": "object"
},
"name": "products.items.check_stock",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"available_sizes": {
"description": "List of currently available in-stock sizes",
"items": {
"type": "string"
},
"type": "array"
},
"direct_checkout_url": {
"description": "Verified 1-click checkout permalink",
"type": "string"
},
"handle": {
"description": "Product handle",
"type": "string"
},
"is_in_stock": {
"description": "Overall stock status",
"type": "boolean"
},
"out_of_stock_sizes": {
"description": "List of out-of-stock sizes",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Product title",
"type": "string"
}
},
"required": [
"handle",
"title",
"is_in_stock",
"available_sizes",
"out_of_stock_sizes",
"direct_checkout_url"
],
"type": "object"
}
},
{
"description": "Fetch a single product document by product handle. Returns detailed metadata, variants, in-stock sizes, price details, and the verified short purchase link (https://s.polopan.com/p/{handle}).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"handle": {
"description": "Unique product handle identifier (e.g. 'solid-linen-shirt')",
"minLength": 1,
"type": "string"
}
},
"required": [
"handle"
],
"type": "object"
},
"name": "products.items.get_by_handle",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"handle": {
"description": "Product handle identifier",
"type": "string"
},
"price": {
"description": "Price",
"type": "number"
},
"title": {
"description": "Product title",
"type": "string"
},
"url": {
"description": "Verified purchase link",
"type": "string"
},
"variants": {
"description": "Variant size list",
"items": {
"additionalProperties": false,
"properties": {
"in_stock": {
"description": "Stock availability",
"type": "boolean"
},
"size": {
"description": "Size label",
"type": "string"
}
},
"required": [
"size",
"in_stock"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"handle",
"title",
"price",
"url"
],
"type": "object"
}
},
{
"description": "Find product alternatives within a selected budget range using product image similarity (same logic as extension). Every product url is the PoloPan short purchase link from GET /products/link/{handle} (https://s.polopan.com/p/{handle}; never the raw catalog URL).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"budget_range": {
"default": "1501-3000",
"description": "Target price bracket in local currency",
"enum": [
"0-1500",
"1501-3000",
"3001-5000",
"5000+"
],
"type": "string"
},
"handle": {
"description": "Base product handle to find alternatives for",
"minLength": 1,
"type": "string"
},
"limit": {
"default": 6,
"description": "Maximum number of filtered alternatives to return",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"page": {
"default": 1,
"description": "Page number for pagination",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"page_size": {
"default": 8,
"description": "Number of items to fetch per page",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"personalize": {
"default": false,
"description": "Whether to apply personalized ranking",
"type": "boolean"
},
"sort_by": {
"default": "relevance",
"description": "Sorting criteria",
"enum": [
"relevance",
"price",
"title"
],
"type": "string"
},
"sort_order": {
"default": "desc",
"description": "Sort order: 'asc' or 'desc'",
"enum": [
"asc",
"desc"
],
"type": "string"
}
},
"required": [
"handle"
],
"type": "object"
},
"name": "products.search.alternatives",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"budget_range": {
"description": "Applied budget bracket",
"type": "string"
},
"products": {
"description": "List of visual alternatives within budget",
"items": {
"additionalProperties": false,
"properties": {
"handle": {
"description": "Alternative product handle",
"type": "string"
},
"price": {
"description": "Alternative product price",
"type": "number"
},
"title": {
"description": "Alternative product title",
"type": "string"
},
"url": {
"description": "Purchase link",
"type": "string"
}
},
"required": [
"handle",
"title",
"price",
"url"
],
"type": "object"
},
"type": "array"
},
"source_handle": {
"description": "Source product handle",
"type": "string"
}
},
"required": [
"budget_range",
"source_handle",
"products"
],
"type": "object"
}
},
{
"description": "Upload a local image file (or base64 string) and search PoloPan products using the uploaded image URL. Returns products with available in-stock sizes, pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"content_type": {
"default": "image/jpeg",
"description": "MIME type of the image, e.g. 'image/jpeg', 'image/png'",
"type": "string"
},
"expiry_hours": {
"default": 24,
"description": "Temporary upload URL lifetime in hours",
"maximum": 168,
"minimum": 1,
"type": "integer"
},
"gender": {
"description": "Target gender filter",
"type": "string"
},
"image_base64": {
"description": "Base64-encoded image data string",
"minLength": 1,
"type": "string"
},
"image_path": {
"description": "Local file system path to the image file",
"minLength": 1,
"type": "string"
},
"page": {
"default": 1,
"description": "Page number for pagination",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Number of items to return per page",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"personalize": {
"default": false,
"description": "Whether to personalize search ranking",
"type": "boolean"
},
"price_max": {
"description": "Maximum price",
"type": "number"
},
"price_min": {
"description": "Minimum price",
"type": "number"
},
"size": {
"description": "Array of sizes to filter by",
"items": {
"type": "string"
},
"type": "array"
},
"sort_by": {
"default": "relevance",
"description": "Sorting criteria",
"enum": [
"relevance",
"price",
"title"
],
"type": "string"
},
"sort_order": {
"default": "desc",
"description": "Sort order: 'asc' or 'desc'",
"enum": [
"asc",
"desc"
],
"type": "string"
},
"vendor": {
"description": "List of brand names",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"name": "products.search.image_upload",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"products": {
"description": "Matching products",
"items": {
"additionalProperties": false,
"properties": {
"handle": {
"description": "Product handle",
"type": "string"
},
"price": {
"description": "Price",
"type": "number"
},
"title": {
"description": "Product title",
"type": "string"
},
"url": {
"description": "Purchase link",
"type": "string"
}
},
"required": [
"handle",
"title",
"price",
"url"
],
"type": "object"
},
"type": "array"
},
"uploaded_image_url": {
"description": "Temporary URL of the uploaded image",
"type": "string"
}
},
"required": [
"uploaded_image_url",
"products"
],
"type": "object"
}
},
{
"description": "Search PoloPan products using image_url and optional filters. Returns products with available in-stock sizes, pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"gender": {
"description": "Target gender filter: 'men', 'women', or 'unisex'",
"type": "string"
},
"image_url": {
"description": "Publicly accessible URL of the fashion image to search for visual matches",
"format": "uri",
"type": "string"
},
"page": {
"default": 1,
"description": "Page number for pagination",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Number of items to return per page",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"personalize": {
"default": false,
"description": "Whether to apply personalized ranking",
"type": "boolean"
},
"price_max": {
"description": "Maximum price in local currency",
"type": "number"
},
"price_min": {
"description": "Minimum price in local currency",
"type": "number"
},
"size": {
"description": "Array of sizes to filter by",
"items": {
"type": "string"
},
"type": "array"
},
"sort_by": {
"default": "relevance",
"description": "Sorting criteria for search results",
"enum": [
"relevance",
"price",
"title"
],
"type": "string"
},
"sort_order": {
"default": "desc",
"description": "Sort order: 'asc' or 'desc'",
"enum": [
"asc",
"desc"
],
"type": "string"
},
"vendor": {
"description": "List of brand names to filter by",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"image_url"
],
"type": "object"
},
"name": "products.search.image_url",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"products": {
"description": "List of matching fashion products",
"items": {
"additionalProperties": false,
"properties": {
"handle": {
"description": "Unique product handle identifier",
"type": "string"
},
"price": {
"description": "Current selling price",
"type": "number"
},
"title": {
"description": "Product name and title",
"type": "string"
},
"url": {
"description": "Verified purchase link",
"type": "string"
}
},
"required": [
"handle",
"title",
"price",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"products"
],
"type": "object"
}
},
{
"description": "Search PoloPan products using a text query and optional filters. Returns products with available in-stock sizes, specifications table, shipping/return policies, pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}).\n\nMANDATORY AGENT INSTRUCTIONS:\n1. Always tell the user the available sizes for items, and display returning & shipping policies (Negative return days = 'Exchange only |X| days').\n2. When presenting/shortlisting products, display the product specifications table.\n3. Return the base link (https://s.polopan.com/p/{handle}) during browsing. Provide the direct checkout link (https://s.polopan.com/p/{handle}/{size_index}) ONLY after the user's size is finalized.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"gender": {
"description": "Target gender filter: 'men', 'women', or 'unisex'",
"type": "string"
},
"page": {
"default": 1,
"description": "Page number for pagination (starts at 1)",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"page_size": {
"default": 20,
"description": "Number of items to return per page (max 100)",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"price_max": {
"description": "Maximum price in local currency",
"type": "number"
},
"price_min": {
"description": "Minimum price in local currency",
"type": "number"
},
"query": {
"description": "The search query or style keyword to find fashion items (e.g. 'black leather jacket', 'floral summer midi dress')",
"minLength": 1,
"type": "string"
},
"size": {
"description": "Array of sizes to filter by, e.g. ['S', 'M', 'L', 'XL']",
"items": {
"type": "string"
},
"type": "array"
},
"sort_by": {
"default": "relevance",
"description": "Sorting criteria for the search results",
"enum": [
"relevance",
"price",
"title"
],
"type": "string"
},
"sort_order": {
"default": "desc",
"description": "Sort order: 'asc' for ascending, 'desc' for descending",
"enum": [
"asc",
"desc"
],
"type": "string"
},
"vendor": {
"description": "List of brand or vendor names to filter by",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "products.search.text",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"pagination": {
"additionalProperties": false,
"description": "Pagination metadata",
"properties": {
"page": {
"description": "Current page number",
"type": "number"
},
"page_size": {
"description": "Number of items per page",
"type": "number"
},
"total": {
"description": "Total number of matching products",
"type": "number"
}
},
"required": [
"page",
"page_size"
],
"type": "object"
},
"products": {
"description": "List of matching fashion products",
"items": {
"additionalProperties": false,
"properties": {
"brand": {
"description": "Brand or vendor name",
"type": "string"
},
"discount_percent": {
"description": "Discount percentage",
"type": "number"
},
"handle": {
"description": "Unique product handle identifier",
"type": "string"
},
"mrp": {
"description": "Original maximum retail price",
"type": "number"
},
"price": {
"description": "Current selling price",
"type": "number"
},
"sizes": {
"description": "List of available in-stock sizes",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Product name and title",
"type": "string"
},
"url": {
"description": "Verified purchase link",
"type": "string"
}
},
"required": [
"handle",
"title",
"price",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"products"
],
"type": "object"
}
},
{
"description": "Deconstruct an outfit image or photo into individual fashion pieces (e.g. Upper-body garment, Lower-body garment, Dress, Footwear, Bag, Headwear) with bounding box coordinates and confidence scores. Use this to break down full-body look photos and search for matching catalog items for each piece individually.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"image_base64": {
"description": "Base64-encoded image string for outfit piece detection",
"minLength": 1,
"type": "string"
},
"image_path": {
"description": "Local path to the outfit image file to deconstruct",
"minLength": 1,
"type": "string"
},
"image_url": {
"description": "Public HTTP(S) URL of the fashion image to deconstruct",
"format": "uri",
"type": "string"
},
"threshold": {
"default": 0.22,
"description": "Confidence threshold for object detection bounding boxes (0.05 to 0.95)",
"maximum": 0.95,
"minimum": 0.05,
"type": "number"
}
},
"type": "object"
},
"name": "vision.outfit.detect_pieces",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"pieces": {
"description": "List of detected fashion pieces",
"items": {
"additionalProperties": false,
"properties": {
"box": {
"description": "Normalized bounding box coordinates [ymin, xmin, ymax, xmax]",
"items": {
"type": "number"
},
"type": "array"
},
"confidence": {
"description": "Confidence score between 0.0 and 1.0",
"type": "number"
},
"label": {
"description": "Detected clothing category (e.g. Upper-body garment, Lower-body garment, Footwear, Bag)",
"type": "string"
}
},
"required": [
"label",
"confidence",
"box"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"pieces"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:5ed2a49c5cc1a11e247ebf2d4542506ff203e990401aa67d5781066b8bb13d6b | sha256sum