{
    "openapi": "3.1.0",
    "info": {
        "title": "SooCare Storefront & WP MCP Nexus API",
        "description": "Public Storefront AI Assistant, Product Search, Order Status Tracking, and Streamable HTTP Model Context Protocol (MCP) Server for soocare.net.",
        "version": "1.0.6"
    },
    "x-service-info": {
        "name": "SooCare",
        "categories": [
            "ecommerce",
            "retail",
            "storefront"
        ],
        "docs": "https://soocare.net/llms.txt"
    },
    "servers": [
        {
            "url": "https://soocare.net",
            "description": "Production Storefront & MCP Server"
        }
    ],
    "paths": {
        "/wp-json/nexus/mcp": {
            "post": {
                "operationId": "mcpStreamableHttp",
                "summary": "Streamable HTTP MCP Endpoint (Protocol 2025-06-18)",
                "security": [
                    {
                        "basicAuth": []
                    },
                    {
                        "oauth2": [
                            "mcp:tools"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "JSON-RPC 2.0 MCP Response"
                    },
                    "401": {
                        "description": "Authentication required"
                    }
                }
            }
        },
        "/wp-json/nexus/v1/storefront/chat": {
            "post": {
                "operationId": "storefrontChat",
                "summary": "Public Customer Storefront Assistant (Product Search with Images, Order Tracking & Policies)",
                "x-payment-info": {
                    "intent": "session",
                    "method": "card",
                    "amount": "0.00",
                    "currency": "EGP",
                    "description": "Free public AI shopping & order tracking assistant for SooCare."
                },
                "responses": {
                    "200": {
                        "description": "Assistant reply and structured product/order cards"
                    }
                }
            }
        },
        "/wp-json/nexus/v1/storefront/order": {
            "post": {
                "operationId": "createCodOrder",
                "summary": "Agentic Cash on Delivery (COD) Order Creation on soocare.net",
                "x-payment-info": {
                    "intent": "charge",
                    "method": "card",
                    "amount": "0.00",
                    "currency": "EGP",
                    "description": "Place a verified Cash on Delivery (COD) order with customer_name, phone, city, address, and product_id."
                },
                "responses": {
                    "201": {
                        "description": "Created WooCommerce & ERP COD order confirmation"
                    }
                }
            }
        },
        "/wp-json/wc/store/v1/checkout": {
            "post": {
                "operationId": "storefrontCheckout",
                "summary": "WooCommerce Store API Checkout (Cash on Delivery & Card)",
                "x-payment-info": {
                    "intent": "charge",
                    "method": "card",
                    "amount": "250.00",
                    "currency": "EGP",
                    "description": "Order checkout for store products."
                },
                "responses": {
                    "200": {
                        "description": "Order confirmation payload"
                    }
                }
            }
        },
        "/.well-known/mcp/server-card.json": {
            "get": {
                "operationId": "getMcpServerCard",
                "summary": "SEP-1649 MCP Server Card",
                "responses": {
                    "200": {
                        "description": "MCP Server Card JSON"
                    }
                }
            }
        }
    },
    "components": {
        "securitySchemes": {
            "basicAuth": {
                "type": "http",
                "scheme": "basic",
                "description": "WordPress Application Password over HTTPS."
            },
            "oauth2": {
                "type": "oauth2",
                "openIdConnectUrl": "https://soocare.net/.well-known/openid-configuration"
            }
        }
    }
}