{
    "openapi": "3.1.0",
    "info": {
        "title": "ForkPoint Agentic Storefront API & MCP",
        "description": "Frontend API definitions allowing AI agents and autonomous clients to interact with ForkPoint's Universal Commerce Protocol (UCP) services, evaluations, and Model Context Protocol (MCP) server.",
        "version": "1.0.0",
        "contact": {
            "name": "ForkPoint Sales & Implementation",
            "url": "https://agenticstorefront.com/contact/",
            "email": "hello@forkpoint.com"
        }
    },
    "servers": [
        {
            "url": "https://agenticstorefront.com",
            "description": "Production Server"
        }
    ],
    "paths": {
        "/api/mcp/sse": {
            "get": {
                "summary": "Connect to the Model Context Protocol (MCP) Server",
                "description": "Establishes a Server-Sent Events (SSE) connection. This endpoint allows compatible AI clients (like Claude Desktop or other MCP explorers) to discover and consume remote tools, resources, and defined prompts related to UCP integration.",
                "operationId": "connectMCPServer",
                "responses": {
                    "200": {
                        "description": "Successful SSE connection established.",
                        "content": {
                            "text/event-stream": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/services/readiness-assessment": {
            "get": {
                "summary": "View the Agentic Commerce Readiness Assessment Service",
                "description": "Information regarding the 126-point audit evaluating AI discoverability, protocol readiness, and transaction enablement.",
                "operationId": "getReadinessAssessment",
                "responses": {
                    "200": {
                        "description": "HTML page detailing the service.",
                        "content": {
                            "text/html": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/contact": {
            "post": {
                "summary": "Submit a General Inquiry or Project Request",
                "description": "Endpoint for autonomous agents to submit a service inquiry on behalf of a user (simulating form submission). Note: This endpoint may require human verification (e.g., CAPTCHA) in a fully live environment natively.",
                "operationId": "submitContactForm",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "type": "string",
                                        "description": "Full name of the requester."
                                    },
                                    "email": {
                                        "type": "string",
                                        "format": "email",
                                        "description": "Contact email address."
                                    },
                                    "platform": {
                                        "type": "string",
                                        "enum": [
                                            "salesforce",
                                            "shopify",
                                            "bigcommerce",
                                            "headless",
                                            "other"
                                        ],
                                        "description": "The current commerce platform the user is on."
                                    },
                                    "message": {
                                        "type": "string",
                                        "description": "Details regarding the UCP implementation or strategy needs."
                                    }
                                },
                                "required": [
                                    "name",
                                    "email",
                                    "message"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Form successfully processed"
                    },
                    "400": {
                        "description": "Invalid input parameters"
                    }
                }
            }
        }
    }
}