Changelog

Name: OptimoCMS SDK
Author: OptimoCMS

Track API changes, new features, and breaking changes.

v1.5.0 — June 2026

New MCP tool create_business: A single call to set up a fully operational online business — website, domain, email, webshop, bookings, voice agent, chatbot, loyalty program, SEO, and publication.
10-step orchestration: Sequential execution with best-effort per step. Site generation is the only hard blocker; all other steps continue on failure.
Detailed result: Each step returns status (success, failed, skipped) and duration in milliseconds.
Tier-aware: Automatic checks on plan limits for domain, email, voice agent, and other features. Trial accounts get a site without domain/email.
Permissions: Requires write + ai on the API key.
Total: 55 MCP tools available (was 54).
Backward compatible: Existing integrations work unchanged.

See the Business Orchestrator guide for full documentation.

3 new MCP tools for SEO & design: update_site_seo, update_page_seo, update_design_tokens. Manage SEO settings and design tokens directly via MCP or API.
1 new MCP tool for push notifications: send_push_campaign. Send push notifications to all subscribers.
2 new MCP tools for webhooks: create_webhook, list_webhooks. Register and manage webhooks for events.
2 new MCP tools for chatbot: configure_chatbot, get_chatbot_config. Activate and configure the chatbot.
SDK: New cms.seo module with updateSiteSeo(), updatePageSeo(), updateDesignTokens().
SDK: New cms.chatbot module with configure(), getConfig().
SDK: cms.push.sendCampaign() and cms.webhooks.create() / cms.webhooks.list() added.
Total: 54 MCP tools available (was 46).
Backward compatible: Existing integrations work unchanged.

5 new MCP tools for domains: check_domain_availability, register_domain, transfer_domain, get_domain_status, list_domains. Register and manage domains directly via MCP or API.
3 new MCP tools for email: create_mailbox, list_mailboxes, get_email_dns_records. Create mailboxes and manage DNS records for email.
SDK: New cms.domains module with checkAvailability(), register(), transfer(), getStatus(), list().
SDK: New cms.mail module with createMailbox(), list(), getDnsRecords().
Total: 46 MCP tools available (was 38).
Backward compatible: Existing integrations work unchanged.

Choose video model: New optional videoModelId parameter on POST /v1/sites/{siteId}/ai/generate, SDK and MCP generate_page tool.
Three models: seedance-fast (1 credit, default), seedance-standard (2 credits, maximum quality), kling-standard (1 credit, budget).
Credit system: Professional 5 credits/month, Agency 30 credits/month. High quality videos cost 2 credits.
New response fields: videoModel and videoCreditsUsed in the job result.
Reference images: Upload up to 3 images as visual inspiration for video generation (Fast and High quality models).
Backward compatible: Without videoModelId, seedance-fast is used. Existing integrations work unchanged.

AI hero video: Automatically generate a short background video for hero sections during AI site generation.
New parameter: useHeroVideo (boolean, optional) added to POST /v1/sites/{siteId}/ai/generate and the generate_page MCP tool.
New response field: heroVideoGenerated in the job result indicates whether a video was successfully generated.
SDK: generatePage() and generateSite() now support the useHeroVideo option.
Availability: Professional (5 hero videos/month) and Agency (30 hero videos/month) plans. Free and Starter plans are unaffected.
Backward compatible: Existing integrations work unchanged. Without the useHeroVideo parameter, behavior remains identical (stock photos).