{
    "openapi": "3.1.0",
    "info": {
        "title": "Hollywood Kia Vehicle Inventory API",
        "description": "REST API for searching vehicle inventory and getting dealer information at Hollywood Kia. This API is intended to be consumed by LLMs and autonomous agents. No authentication required.",
        "version": "1.0.0",
        "x-llm-friendly": true
    },
    "servers": [
        {
            "url": "https://www.hollywoodkia.com",
            "description": "Production server"
        }
    ],
    "paths": {
        "/wp-json/di-llm-mcp/v1/inventory": {
            "get": {
                "operationId": "searchInventory",
                "summary": "Search vehicle inventory",
                "description": "Search for vehicles with filters. Returns JSON array of vehicles. This is the recommended endpoint for LLMs.",
                "tags": [
                    "REST API"
                ],
                "parameters": [
                    {
                        "name": "make",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Filter by vehicle make (e.g., Toyota, Jeep, Ford)",
                        "example": "Jeep"
                    },
                    {
                        "name": "model",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Filter by vehicle model (e.g., Cherokee, Camry)",
                        "example": "Cherokee"
                    },
                    {
                        "name": "year",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Filter by exact year",
                        "example": 2024
                    },
                    {
                        "name": "year_min",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Minimum year",
                        "example": 2022
                    },
                    {
                        "name": "year_max",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Maximum year",
                        "example": 2025
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "new",
                                "used",
                                "cpo"
                            ]
                        },
                        "description": "Filter by new or used",
                        "example": "new"
                    },
                    {
                        "name": "bodytype",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "SUVs",
                                "Trucks",
                                "Vans",
                                "Sedans",
                                "Coupes",
                                "Wagons",
                                "Convertibles"
                            ]
                        },
                        "description": "Filter by body type",
                        "example": "SUVs"
                    },
                    {
                        "name": "price_min",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Minimum price in dollars",
                        "example": 20000
                    },
                    {
                        "name": "price_max",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Maximum price in dollars",
                        "example": 50000
                    },
                    {
                        "name": "keyword",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Search keyword (searches color, features, etc.)",
                        "example": "white"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "default": 20,
                            "maximum": 100
                        },
                        "description": "Number of results to return",
                        "example": 10
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "default": 1
                        },
                        "description": "Page number for pagination",
                        "example": 1
                    }
                ],
                "responses": {
                    "200": {
                        "description": "List of vehicles matching the search criteria",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "total": {
                                            "type": "integer",
                                            "description": "Total number of matching vehicles"
                                        },
                                        "page": {
                                            "type": "integer"
                                        },
                                        "limit": {
                                            "type": "integer"
                                        },
                                        "vehicles": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "vin": {
                                                        "type": "string"
                                                    },
                                                    "stock": {
                                                        "type": "string"
                                                    },
                                                    "year": {
                                                        "type": "string"
                                                    },
                                                    "make": {
                                                        "type": "string"
                                                    },
                                                    "model": {
                                                        "type": "string"
                                                    },
                                                    "trim": {
                                                        "type": "string"
                                                    },
                                                    "type": {
                                                        "type": "string"
                                                    },
                                                    "bodytype": {
                                                        "type": "string"
                                                    },
                                                    "exterior_color": {
                                                        "type": "string"
                                                    },
                                                    "interior_color": {
                                                        "type": "string"
                                                    },
                                                    "mileage": {
                                                        "type": "string"
                                                    },
                                                    "price": {
                                                        "type": "string"
                                                    },
                                                    "msrp": {
                                                        "type": "string"
                                                    },
                                                    "url": {
                                                        "type": "string",
                                                        "description": "Link to vehicle detail page"
                                                    }
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "success": true,
                                    "total": 5,
                                    "page": 1,
                                    "limit": 10,
                                    "vehicles": [
                                        {
                                            "vin": "1C4PJMMB0PD104666",
                                            "year": "2023",
                                            "make": "Jeep",
                                            "model": "Cherokee",
                                            "trim": "Altitude Lux",
                                            "bodytype": "SUVs",
                                            "exterior_color": "Bright White",
                                            "mileage": "0",
                                            "price": "36995",
                                            "url": "https://www.hollywoodkia.com/inventory/new-2023-jeep-cherokee/"
                                        }
                                    ]
                                }
                            }
                        }
                    }
                }
            }
        },
        "/wp-json/di-llm-mcp/v1/inventory/{vin}": {
            "get": {
                "operationId": "getVehicleByVin",
                "summary": "Get vehicle details by VIN",
                "description": "Retrieve detailed information about a specific vehicle using its VIN.",
                "tags": [
                    "REST API"
                ],
                "parameters": [
                    {
                        "name": "vin",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "pattern": "^[A-HJ-NPR-Z0-9]{17}$"
                        },
                        "description": "17-character Vehicle Identification Number",
                        "example": "1C4PJMMB0PD104666"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Vehicle details",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "vehicle": {
                                            "type": "object"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Vehicle not found"
                    }
                }
            }
        },
        "/wp-json/di-llm-mcp/v1/dealer": {
            "get": {
                "operationId": "getDealerInfo",
                "summary": "Get dealer information",
                "description": "Retrieve dealership contact information, address, phone, and hours.",
                "tags": [
                    "REST API"
                ],
                "responses": {
                    "200": {
                        "description": "Dealer information",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "success": {
                                            "type": "boolean"
                                        },
                                        "dealer": {
                                            "type": "object",
                                            "properties": {
                                                "name": {
                                                    "type": "string"
                                                },
                                                "address": {
                                                    "type": "string"
                                                },
                                                "city": {
                                                    "type": "string"
                                                },
                                                "state": {
                                                    "type": "string"
                                                },
                                                "zip": {
                                                    "type": "string"
                                                },
                                                "phone": {
                                                    "type": "string"
                                                },
                                                "email": {
                                                    "type": "string"
                                                },
                                                "hours": {
                                                    "type": "object"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/wp-json/di-llm-mcp/v1/health": {
            "get": {
                "operationId": "healthCheck",
                "summary": "Health check endpoint",
                "tags": [
                    "Utility"
                ],
                "responses": {
                    "200": {
                        "description": "Service is healthy",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "status": {
                                            "type": "string"
                                        },
                                        "server": {
                                            "type": "string"
                                        },
                                        "version": {
                                            "type": "string"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/wp-json/di-llm-mcp/v1/mcp": {
            "post": {
                "operationId": "mcpRequest",
                "summary": "MCP JSON-RPC endpoint",
                "description": "Execute MCP tools via JSON-RPC 2.0. For clients that support MCP protocol.",
                "tags": [
                    "MCP Protocol"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "jsonrpc",
                                    "method",
                                    "id"
                                ],
                                "properties": {
                                    "jsonrpc": {
                                        "type": "string",
                                        "enum": [
                                            "2.0"
                                        ]
                                    },
                                    "method": {
                                        "type": "string",
                                        "enum": [
                                            "tools/list",
                                            "tools/call",
                                            "initialize"
                                        ]
                                    },
                                    "params": {
                                        "type": "object"
                                    },
                                    "id": {
                                        "type": "integer"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "JSON-RPC response"
                    }
                }
            }
        }
    },
    "tags": [
        {
            "name": "REST API",
            "description": "Simple REST endpoints - recommended for LLMs"
        },
        {
            "name": "MCP Protocol",
            "description": "MCP JSON-RPC protocol for MCP-compatible clients"
        },
        {
            "name": "Utility",
            "description": "Utility endpoints"
        }
    ]
}