Datos para agentes y desarrolladores

Descubrimiento

• Catálogo de APIs (RFC 9727): /.well-known/api-catalog
• Especificación OpenAPI 3.1: /mcp/openapi.json
• Agent Card de A2A: /.well-known/agent-card.json. Describe las habilidades del sitio; no hay un servicio A2A que reciba mensajes, las habilidades se cumplen leyendo los JSON de abajo.
• Estado: /mcp/status.json responde {"status":"pass"} cuando la API está publicada.
• Autenticación de agentes: /auth.md (acceso anónimo, sin registro ni credenciales)
• Índice para modelos de lenguaje: /llms.txt

Endpoints

Todos se piden con GET y responden application/json.

• /mcp/business-info.json

  Información del negocio. Contacto, ubicación, horarios y redes sociales.

• /mcp/categories.json

  Categorías. Categorías del catálogo.

• /mcp/products.json

  Productos. Diseños publicados con descripción, categorías, precio de referencia y enlace a su ficha.

• /mcp/faqs.json

  Preguntas frecuentes. Preguntas y respuestas sobre pedidos, envíos y pagos.

• /mcp/seasons.json

  Temporadas. Temporadas del año con su guía, categorías y piezas.

• /mcp/materials.json

  Materiales. Materiales y técnicas, con medidas y precios de referencia.

• /mcp/reviews.json

  Calificaciones. Opiniones aprobadas de clientes.

Herramientas WebMCP

Al abrir cualquier página del sitio en un navegador compatible, se registran 12 herramientas en document.modelContext. Sus esquemas están en /mcp/tools.json. Ninguna envía datos: prepare_quote solo llena el formulario de contacto y el visitante decide si lo envía.

• list_categories: Lista las categorías públicas del catálogo de InspiraArte (taller de corte y grabado láser en CDMX).
• search_products: Busca productos del catálogo por palabras (nombre, descripción, material o categoría) y/o por categoría. Devuelve nombre, referencia, precio de referencia y enlace.
• get_product_detail: Detalle de un producto: descripción, material, medidas, precio de referencia, tiempos de producción y envío, imágenes y calificaciones.
• get_current_product: Devuelve el producto que el visitante está viendo, si está en una ficha de producto.
• list_seasons: Lista las temporadas del año (Navidad, Día de muertos, regreso a clases…) con sus meses, categorías y número de piezas.
• get_season_guide: Guía de compra de una temporada (ideas, tiempos para pedir a tiempo, piezas recomendadas) y sus productos.
• get_materials_guide: Explica los materiales y técnicas (MDF, acrílico, metal, termos; corte y grabado láser) con medidas y precios de referencia.
• search_faq: Busca respuestas en las preguntas frecuentes: tiempos, pedido mínimo, envíos, pagos, garantía.
• get_reviews: Calificaciones y opiniones aprobadas de clientes, de todo el sitio o de un producto.
• get_business_info: Datos de contacto, ubicación, horarios y redes sociales de InspiraArte.
• navigate_to: Lleva al visitante a una página del sitio: la ficha de un producto (productId), una temporada (seasonSlug) o una ruta como "/productos/" o "/faq/".
• prepare_quote: Abre el formulario de cotización (/contacto) con el producto, la cantidad, la fecha y los detalles ya escritos. No envía nada: el visitante revisa, agrega su nombre y correo y pulsa Enviar.