{"openapi":"3.1.0","info":{"title":"Changuito — crear tu tienda online desde una IA","version":"1.0.0","description":"Crear y armar una tienda online (con 10 días de prueba gratis, sin tarjeta). La persona se identifica por OAuth en la página de Changuito."},"servers":[{"url":"https://mcp.changuito.net"}],"paths":{"/ai/v1/tools/get_requirements":{"post":{"operationId":"get_requirements","summary":"Qué hace falta para crear la tienda","description":"Devuelve los países disponibles, los rubros habituales, las plantillas, los datos que hacen falta para crear una tienda y lo que no se hace por el chat (cobros, planes y dominio). Con country incluye también la marca y el idioma de ese país.","x-openai-isConsequential":false,"security":[{"changuito":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","enum":["AR","MX","CO","CL","UY","PE","PY","BR","BO","EC"],"description":"País de la tienda. Define la moneda, el idioma, la marca y los medios de cobro."}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Datos incompletos o inválidos (el detalle está en problems)"},"401":{"description":"Falta autorizar la conexión"},"403":{"description":"Falta un permiso"},"404":{"description":"No existe o no fue creada por esta conexión"}}}},"/ai/v1/tools/check_slug":{"post":{"operationId":"check_slug","summary":"Ver la dirección de la tienda","description":"Informa qué dirección (subdominio) tendría la tienda con ese nombre y si está libre; si no lo está, devuelve la alternativa más parecida.","x-openai-isConsequential":false,"security":[{"changuito":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":80,"description":"Nombre de la tienda, tal como lo dijo la persona."},"country":{"type":"string","enum":["AR","MX","CO","CL","UY","PE","PY","BR","BO","EC"],"description":"País de la tienda. Define la moneda, el idioma, la marca y los medios de cobro."}},"required":["name"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Datos incompletos o inválidos (el detalle está en problems)"},"401":{"description":"Falta autorizar la conexión"},"403":{"description":"Falta un permiso"},"404":{"description":"No existe o no fue creada por esta conexión"}}}},"/ai/v1/tools/preview_store":{"post":{"operationId":"preview_store","summary":"Vista previa de la tienda","description":"Valida los datos de una tienda y devuelve el resumen y la dirección final. No crea nada.","x-openai-isConsequential":false,"security":[{"changuito":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","enum":["AR","MX","CO","CL","UY","PE","PY","BR","BO","EC"],"description":"País de la tienda. Define la moneda, el idioma, la marca y los medios de cobro."},"name":{"type":"string","minLength":2,"maxLength":80,"description":"Nombre de la tienda, tal como lo dijo la persona."},"category":{"type":"string","maxLength":60,"description":"Rubro del negocio (por ejemplo indumentaria, gastronomía, cursos)."},"city":{"type":"string","maxLength":80},"phone":{"type":"string","maxLength":40,"description":"WhatsApp del comercio con código de área."},"description":{"type":"string","maxLength":600,"description":"Descripción corta del negocio."},"address":{"type":"string","maxLength":160}},"required":["country","name","category","city","phone"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Datos incompletos o inválidos (el detalle está en problems)"},"401":{"description":"Falta autorizar la conexión"},"403":{"description":"Falta un permiso"},"404":{"description":"No existe o no fue creada por esta conexión"}}}},"/ai/v1/tools/create_store":{"post":{"operationId":"create_store","summary":"Crear la tienda","description":"Crea la tienda a nombre de la persona conectada. Es repetible: con la misma idempotency_key no crea otra.","x-openai-isConsequential":true,"security":[{"changuito":["store:create"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","enum":["AR","MX","CO","CL","UY","PE","PY","BR","BO","EC"],"description":"País de la tienda. Define la moneda, el idioma, la marca y los medios de cobro."},"name":{"type":"string","minLength":2,"maxLength":80,"description":"Nombre de la tienda, tal como lo dijo la persona."},"category":{"type":"string","maxLength":60,"description":"Rubro del negocio (por ejemplo indumentaria, gastronomía, cursos)."},"city":{"type":"string","maxLength":80},"phone":{"type":"string","maxLength":40,"description":"WhatsApp del comercio con código de área."},"description":{"type":"string","maxLength":600,"description":"Descripción corta del negocio."},"address":{"type":"string","maxLength":160},"idempotency_key":{"type":"string","maxLength":80,"description":"Clave única por intento (por ejemplo un UUID) para que un reintento no duplique la tienda."}},"required":["country","name","category","city","phone"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Datos incompletos o inválidos (el detalle está en problems)"},"401":{"description":"Falta autorizar la conexión"},"403":{"description":"Falta un permiso"},"404":{"description":"No existe o no fue creada por esta conexión"}}}},"/ai/v1/tools/add_products":{"post":{"operationId":"add_products","summary":"Cargar productos","description":"Carga hasta 25 productos por llamada, con nombre, precio, descripción, categoría y hasta 2 fotos por producto (image_urls: direcciones https públicas). Un producto sin precio mayor a 0 no se carga.","x-openai-isConsequential":true,"security":[{"changuito":["store:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store_id":{"type":"string","pattern":"^[a-z0-9]{15}$","description":"Id de la tienda."},"products":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":120},"price":{"type":"number","exclusiveMinimum":0},"description":{"type":"string","maxLength":1000},"category":{"type":"string","maxLength":100},"image_urls":{"type":"array","maxItems":2,"items":{"type":"string","format":"uri"}}},"required":["name","price"],"additionalProperties":false}}},"required":["store_id","products"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Datos incompletos o inválidos (el detalle está en problems)"},"401":{"description":"Falta autorizar la conexión"},"403":{"description":"Falta un permiso"},"404":{"description":"No existe o no fue creada por esta conexión"}}}},"/ai/v1/tools/set_branding":{"post":{"operationId":"set_branding","summary":"Logo, portada, colores y plantilla","description":"Sube el logo y la portada desde direcciones https públicas, y/o cambia los colores (#rrggbb) y la plantilla (optimus, astros, rose_vogue, black_vortex).","x-openai-isConsequential":true,"security":[{"changuito":["store:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store_id":{"type":"string","pattern":"^[a-z0-9]{15}$","description":"Id de la tienda."},"logo_url":{"type":"string","format":"uri"},"cover_url":{"type":"string","format":"uri"},"primary_color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"secondary_color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"accent_color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"template":{"type":"string","enum":["optimus","astros","rose_vogue","black_vortex"]}},"required":["store_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Datos incompletos o inválidos (el detalle está en problems)"},"401":{"description":"Falta autorizar la conexión"},"403":{"description":"Falta un permiso"},"404":{"description":"No existe o no fue creada por esta conexión"}}}},"/ai/v1/tools/get_store_status":{"post":{"operationId":"get_store_status","summary":"Estado y próximos pasos","description":"Devuelve el enlace de la tienda, los días de prueba, la cantidad de productos y lo que falta (logo, cobros, envíos), con los próximos pasos.","x-openai-isConsequential":false,"security":[{"changuito":["store:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store_id":{"type":"string","pattern":"^[a-z0-9]{15}$","description":"Id de la tienda."}},"required":["store_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Datos incompletos o inválidos (el detalle está en problems)"},"401":{"description":"Falta autorizar la conexión"},"403":{"description":"Falta un permiso"},"404":{"description":"No existe o no fue creada por esta conexión"}}}},"/ai/v1/tools/list_my_stores":{"post":{"operationId":"list_my_stores","summary":"Mis tiendas creadas por IA","description":"Lista las tiendas que esta persona creó por este camino.","x-openai-isConsequential":false,"security":[{"changuito":["store:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Datos incompletos o inválidos (el detalle está en problems)"},"401":{"description":"Falta autorizar la conexión"},"403":{"description":"Falta un permiso"},"404":{"description":"No existe o no fue creada por esta conexión"}}}},"/ai/v1/tools/get_panel_link":{"post":{"operationId":"get_panel_link","summary":"Enlace al panel","description":"Devuelve el enlace directo al panel de la tienda, a la sección elegida. Los cobros y los envíos se configuran en el panel, no por el chat.","x-openai-isConsequential":false,"security":[{"changuito":["store:read"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"store_id":{"type":"string","pattern":"^[a-z0-9]{15}$","description":"Id de la tienda."},"section":{"type":"string","enum":["inicio","cobranza","entregas","productos","tienda","diseno","cuenta"]}},"required":["store_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Datos incompletos o inválidos (el detalle está en problems)"},"401":{"description":"Falta autorizar la conexión"},"403":{"description":"Falta un permiso"},"404":{"description":"No existe o no fue creada por esta conexión"}}}}},"components":{"securitySchemes":{"changuito":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://mcp.changuito.net/oauth/authorize","tokenUrl":"https://mcp.changuito.net/oauth/token","refreshUrl":"https://mcp.changuito.net/oauth/token","scopes":{"store:create":"Crear una tienda nueva a tu nombre (con la prueba gratis)","store:write":"Cargar productos, logo y diseño de las tiendas que creó esta conexión","store:read":"Ver el estado de las tiendas que creó esta conexión"}}}}}}}