Skip to main content

​
generate_description

Generate an AI-powered product description from existing product data or an image. Parameters:
ParameterTypeRequiredDescription
product_idstringYesProduct ID or SKU
stylestringNotechnical, lifestyle, seo (default: seo)
max_charsintegerNoMax description length (default: 500)
languagestringNopt-BR or en (default: workspace language)
curl -X POST "https://app.alana.shopping/api/mcp/sse" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"method":"tools/call","params":{"name":"generate_description","arguments":{"product_id":"SKU-001","style":"lifestyle","max_chars":300}}}'
Response: 
{
  "product_id": "SKU-001",
  "description": "Step into effortless comfort with our Blue Cotton T-Shirt. Crafted from 100% pre-shrunk cotton, it keeps you cool and looking sharp from morning meetings to weekend adventures.",
  "style": "lifestyle",
  "char_count": 186
}

​
enhance_images

Analyze product images and return suggestions for improvement (alt text, composition, quality score). Parameters:
ParameterTypeRequiredDescription
product_idstringYesProduct ID or SKU
generate_alt_textbooleanNoGenerate alt text for each image (default: true)
const result = await client.callTool({
  name: "enhance_images",
  arguments: {
    product_id: "SKU-001",
    generate_alt_text: true,
  },
});
Response: 
{
  "product_id": "SKU-001",
  "images": [
    {
      "url": "https://cdn.yourstore.com/blue-tshirt.jpg",
      "quality_score": 0.82,
      "alt_text": "Men's blue cotton t-shirt on white background",
      "suggestions": ["Add lifestyle shot", "Include size reference"]
    }
  ]
}

​
get_brand_context

Retrieve brand guidelines, tone of voice, and positioning data to inform content generation. Parameters:
ParameterTypeRequiredDescription
brand_idstringYesBrand ID
include_keywordsbooleanNoInclude brand keywords (default: true)
const result = await client.callTool({
  name: "get_brand_context",
  arguments: { brand_id: "brand_abc", include_keywords: true },
});
Response: 
{
  "brand_id": "brand_abc",
  "name": "YourBrand",
  "tone": "friendly, approachable, confident",
  "positioning": "Premium casual wear for active professionals",
  "keywords": ["comfort", "quality", "sustainable", "versatile"],
  "forbidden_terms": ["cheap", "discount"]
}
Last modified on March 18, 2026