{"openapi":"3.1.0","info":{"title":"Jennifer Furniture WebMCP Platform","description":"Agent-native capability layer for Jennifer Furniture (Shopify Plus). Exposes 14,447 catalog products, live variant stock verification, living room fit & clearance calculations, deep spec comparisons, 3-piece coordinated room bundles, and 1-click Shopify direct checkout permalinks.","version":"1.2.0"},"servers":[{"url":"https://jennifer-webmcp.vercel.app","description":"Production WebMCP Server"}],"paths":{"/api/products/search":{"post":{"operationId":"find_products_by_constraints","summary":"Search live in-stock catalog by constraints and natural query","description":"Search Jennifer Furniture's 14,447 catalog items for in-stock products matching category, budget, material, or natural language query.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"Furniture category to search (e.g., 'sectional', 'sofa', 'loveseat', 'dining table', 'bed', 'recliner', 'accent chair')"},"max_price":{"type":"number","description":"Maximum budget in USD (e.g., 4000)"},"min_price":{"type":"number","description":"Minimum price in USD (e.g., 500)"},"material":{"type":"string","description":"Material or upholstery type (e.g., 'leather', 'fabric', 'velvet', 'microfiber', 'wood')"},"features":{"type":"array","items":{"type":"string"},"description":"List of desired features (e.g., ['sleeper', 'power-reclining', 'storage', 'chaise'])"},"in_stock_only":{"type":"boolean","description":"Whether to return only in-stock items with inventory > 0 (defaults to true)","default":true},"query":{"type":"string","description":"Conversational natural query (e.g. 'sofa under $4000 for family with pets')"},"limit":{"type":"integer","description":"Maximum number of results to return (1-25, defaults to 10)","default":10}}}}}},"responses":{"200":{"description":"Matching products found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"count":{"type":"integer"},"products":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"handle":{"type":"string"},"minPrice":{"type":"number"},"inStock":{"type":"boolean"},"matchedVariantId":{"type":"string"}}}}}}}}}}}},"/api/tools/room-fit":{"post":{"operationId":"calculate_room_fit_and_clearance","summary":"Calculate living room fit & perimeter walking clearance","description":"Evaluates whether a sofa or sectional fits a customer's specific room dimensions, checking for the 30-36 inch walking clearance standard.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"room_width_feet":{"type":"number","description":"Width of the living room space in feet (e.g. 12)"},"room_length_feet":{"type":"number","description":"Length of the living room space in feet (e.g. 10)"},"product_handle":{"type":"string","description":"Product handle (e.g. 'monika-sleeper-sofa' or 'mason-leather-89-sofa-1')"},"include_coffee_table":{"type":"boolean","description":"Whether a standard 36x24 inch coffee table is placed in front of the sofa","default":true}},"required":["room_width_feet","room_length_feet","product_handle"]}}}},"responses":{"200":{"description":"Room fit verdict and clearance analysis returned","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"clearanceAnalysis":{"type":"object","properties":{"verdict":{"type":"string"},"fitScore":{"type":"number"},"frontWalkwayClearanceInches":{"type":"number"},"expertFeedback":{"type":"string"}}}}}}}}}}}}},"/api/tools/compare-deep":{"post":{"operationId":"compare_products_deep_matrix","summary":"Deep side-by-side spec comparison with materials & warranty","description":"Compares 2 to 4 products across frame construction, fabric grade, cushion density, dimensions, warranty, and value.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_handles":{"type":"array","items":{"type":"string"},"description":"Array of 2 to 4 product handles to compare (e.g. ['kirby-chaise', 'mason-leather-89-sofa-1'])","minItems":2,"maxItems":4}},"required":["product_handles"]}}}},"responses":{"200":{"description":"Deep comparison matrix returned","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"valueWinnerTitle":{"type":"string"},"expertRecommendation":{"type":"string"}}}}}}}}}}},"/api/tools/bundle-builder":{"post":{"operationId":"build_coordinated_room_bundle","summary":"Build 3-piece living room suite with 15% discount","description":"Pairs a sofa with matching ottoman and accent chair, applying a 15% promotional bundle discount and generating a 1-click checkout permalink.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base_product_handle":{"type":"string","description":"Anchor sofa or sectional handle (e.g. 'monika-sleeper-sofa')"},"budget_cap":{"type":"number","description":"Maximum budget cap for the entire 3-piece room bundle in USD (e.g. 3500)"}},"required":["base_product_handle"]}}}},"responses":{"200":{"description":"Coordinated bundle generated","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"bundleName":{"type":"string"},"pricing":{"type":"object","properties":{"bundlePrice":{"type":"string"},"instantSavings":{"type":"string"}}},"checkout":{"type":"object","properties":{"oneClickBundleCheckoutUrl":{"type":"string"}}}}}}}}}}}}},"/api/tools/room-designer":{"post":{"operationId":"analyze_room_photo_and_recommend","summary":"Multimodal AI Room Designer & Photo Staging Recommendation","description":"Analyzes an uploaded photo of a living room or hall, evaluates architectural structure, color palette, and cushion comfort needs, calculates spatial clearance, and recommends in-stock sofas under budget with 1-click cart permalinks.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"image_data":{"type":"string","description":"Base64 encoded image string or publicly accessible URL of the customer's room or living hall photo."},"budget_cap":{"type":"number","description":"Maximum budget in USD for the sofa/furniture piece (e.g., 2500). Defaults to 2500.","default":2500},"material_preference":{"type":"string","enum":["any","leather","fabric","velvet","performance"],"description":"Desired upholstery material. If omitted or 'any', the AI will recommend the ideal material based on room lighting and flooring."},"comfort_type":{"type":"string","description":"Desired comfort profile (e.g. 'deep-seating', 'plush-cushions', 'firm-lumbar', 'sofa-bed', 'pillows')."},"has_sleeper_need":{"type":"boolean","description":"Whether the customer requires a sleeper / sofa bed function for overnight guests."},"room_dimensions":{"type":"object","properties":{"width_feet":{"type":"number"},"length_feet":{"type":"number"}},"description":"Optional estimated room dimensions in feet (e.g. 12x10 or 15x12)."}}}}}},"responses":{"200":{"description":"Room analysis, matched in-stock sofa recommendations, and bundle summary returned","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"}}}}}}}}},"/api/tools/visual-asset":{"post":{"operationId":"get_product_visual_asset","summary":"Get Canonical Base64 Product Visual Asset & Geometry Preservation Directives","description":"Fetches byte-level Base64 image data and explicit geometry preservation prompt for high-fidelity room staging with GPT-4o Vision and diffusion image generation.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"The Shopify product URL handle (e.g., 'stacey-sofa' or 'monika-sleeper-sofa')."},"product_id":{"type":"string","description":"The Shopify Product ID (e.g., '5408176341160' or 'gid://shopify/Product/5408176341160')."}}}}}},"responses":{"200":{"description":"Byte-level visual asset, dimensions, and geometry prompt returned","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"content":{"type":"array"},"structuredContent":{"type":"object"}}}}}}}}},"/api/products/details":{"post":{"operationId":"get_product_details","summary":"Get deep specifications and variant matrix","description":"Fetch parsed dimensions, materials, care instructions, warranty details, and complete variant matrix for a product.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string","description":"The Shopify Product ID (e.g., 'gid://shopify/Product/5826780551' or numeric ID)"},"handle":{"type":"string","description":"The Shopify product URL handle (e.g., 'tess-3-piece-sleeper-sectional')"}}}}}},"responses":{"200":{"description":"Product details returned","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}}}}}}}}},"/api/products/variant-check":{"post":{"operationId":"check_variant_availability","summary":"Check variant option combination and live stock","description":"Verify live stock counts and variant IDs for specific color, size, and layout options.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string","description":"The Shopify Product ID to check variants for"},"selected_options":{"type":"object","description":"Key-value dictionary of desired variant options (e.g., { 'Color': 'Gray', 'Mattress': 'Memory Foam', 'Size': 'Queen' })","additionalProperties":{"type":"string"}}},"required":["product_id"]}}}},"responses":{"200":{"description":"Variant availability returned","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}}}}}}}}},"/api/cart/checkout":{"post":{"operationId":"create_checkout_handoff","summary":"Generate 1-click Shopify direct checkout link","description":"Generate an official direct Shopify Cart Permalink URL preloading selected items and promotional discount codes.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"variant_id":{"type":"string","description":"The Shopify ProductVariant GID or numeric ID"},"quantity":{"type":"integer","description":"Quantity to purchase (defaults to 1)","default":1},"title":{"type":"string","description":"Item title for receipt/cart summary"},"price":{"type":"number","description":"Item unit price"}},"required":["variant_id"]},"description":"Array of line items to add to the checkout cart"},"discount_code":{"type":"string","description":"Optional promotional code to apply at checkout (e.g., 'WEBMCP10')"},"note":{"type":"string","description":"Optional delivery instructions to attach to the order"}},"required":["items"]}}}},"responses":{"200":{"description":"Checkout URL generated","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}}}}}}}}},"/api/admin/revenue":{"post":{"operationId":"get_store_revenue_and_analytics","summary":"Executive store sales revenue report","description":"Store Owner Tool: Real-time sales revenue, average order value, category breakdowns, and WebMCP agent conversion rates.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"timeframe":{"type":"string","enum":["today","last_7_days","this_month"],"description":"Timeframe for revenue and order breakdown (defaults to 'last_7_days')","default":"last_7_days"},"category":{"type":"string","description":"Optional category filter (e.g., 'Sectional', 'Dining')"},"session_token":{"type":"string","description":"Admin session token returned by authenticate_admin"}}}}}},"responses":{"200":{"description":"Revenue analytics returned","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}}}}}}}}},"/api/admin/inventory-health":{"post":{"operationId":"get_inventory_health_and_restock_alerts","summary":"Scan catalog for stockout risks and reorder counts","description":"Store Owner Tool: Scans 14,447 products for low stock levels and recommended reorder quantities.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"threshold":{"type":"number","description":"Stock count threshold to flag as low stock (defaults to 3)","default":3},"session_token":{"type":"string","description":"Admin session token returned by authenticate_admin"}}}}}},"responses":{"200":{"description":"Inventory health alerts returned","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}}}}}}}}}}}