Available MCP Tools

OptimoCMS provides 62 MCP tools across 19 categories. Every tool is available in Cursor, Claude Desktop, and Lovable.

Sites

list_sites

List all websites accessible with the current API key.

Example prompt: "Show all my active sites."

get_site

Get detailed information about a specific website including design tokens, domain, and status.

Example prompt: "What are the details of site site_abc123?"

create_site

Create a new website. Requires admin role. Enforces site limit based on billing tier.

Example prompt: "Create a new website called 'De Molen Bakery'."

delete_site

Delete a website and all its data. Requires admin role. Confirmation via site name required.

Example prompt: "Delete site site_abc123 (confirm: De Molen Bakery)."

---

Pages

list_pages

List all pages for a website with titles, slugs, and status.

Example prompt: "Show all published pages of site site_abc123."

get_page

Get full page detail including content blocks, SEO metadata, and timestamps.

Example prompt: "Get the content of page page_xyz789 on site site_abc123."

create_page

Create a new page. Requires write permission.

Example prompt: "Create an 'About Us' page on site site_abc123."

update_page

Update an existing page. Can change title, slug, blocks, SEO, or status.

Example prompt: "Set page page_xyz789 to draft."

delete_page

Delete (archive) a page. The page is soft-deleted and can be recovered.

Example prompt: "Delete page page_xyz789 from site site_abc123."

---

Publishing

publish_site

Publish (deploy) a website to production. Rate limited: max 1 deploy per 5 minutes per site. Requires publish permission.

Example prompt: "Publish site site_abc123."

---

Media

search_media

Search the media library by filename or alt text. Optionally filter by MIME type.

Example prompt: "Find all images with 'logo' in the name on site site_abc123."

---

Analytics

get_analytics

Get analytics summary: pageviews, unique visitors, average session duration, bounce rate, and top pages.

Example prompt: "How has site site_abc123 performed in the last 7 days?"

---

AI

generate_page

Generate a new page using AI from a text prompt. Optionally include an AI-generated hero video (Professional+ plans). Choose a video model: seedance-fast (1 credit, default), seedance-standard (2 credits, max quality), kling-standard (1 credit, budget). Requires ai permission. Rate limited: 2 calls per minute. Cost: ~€0.30 per call (excl. video).

AI media generation: When useHeroVideo is set to true, a short background video is automatically generated for the hero section. This is available for Professional and Agency plans. On lower plans, the parameter is ignored.

Video models: Use videoModelId to select the model. Default is seedance-fast (best balance of quality/speed). seedance-standard delivers maximum quality but costs 2 credits. kling-standard is the budget option.

Example prompt: "Generate a landing page for a bakery with hero video."

Example prompt (with model): "Generate a landing page for a bakery with a high-quality hero video."

Example prompt (without video): "Generate a modern landing page for a bakery in minimalist style."

translate_page

Translate all content blocks of a page to another language. Requires ai permission. Rate limited: 5 calls per minute.

Example prompt: "Translate page page_xyz789 to German."

assist_content

AI-powered content improvement for an existing page. Describe what to change. Requires ai permission. Rate limited: 5 calls per minute.

Example prompt: "Make the tone of page page_xyz789 more professional."

generate_template

Generate a reusable component template from a description. Requires ai permission. Rate limited: 2 calls per minute.

Example prompt: "Create a pricing table template with 3 tiers."

generate_template_variants

Generate style variants of an existing template. Produces multiple visual variations. Requires ai permission.

Example prompt: "Create 3 variants of template tmpl_abc: dark, playful, and corporate."

---

Import

preview_import

Crawl a website URL and return a preview of what the import would produce. Does NOT create a site. Requires ai permission.

Example prompt: "Preview what would be imported from https://example.com."

import_website

Import a website by URL into OptimoCMS. Crawls the site, detects layout, maps sections to components, and creates a new site. Requires ai permission.

Example prompt: "Import https://example.com as 'Example Site' with all sub-pages."

---

Booking

get_available_slots

Get available booking time slots for a specific date. Requires verticals permission.

Example prompt: "What time slots are available on 2026-06-15 for site site_abc123?"

create_booking

Create a new booking. Check available slots first. Requires verticals permission.

Example prompt: "Book an appointment for John Smith on 2026-06-15 at 14:00."

list_bookings

List bookings, optionally filtered by status or date. Requires verticals or read permission.

Example prompt: "Show all confirmed bookings for today."

---

E-commerce

list_products

List products in the site shop. Requires verticals or read permission.

Example prompt: "Show all products in the 'Bread' category of site site_abc123."

create_product

Create a new product. Price in cents (e.g. 1999 = €19.99). Requires verticals permission.

Example prompt: "Add a product 'Sourdough Bread' for €4.50 with 50 in stock."

update_product

Update an existing product. Only provided fields are changed. Requires verticals permission.

Example prompt: "Increase the price of product prod_123 to €5.99."

list_orders

List shop orders. Requires verticals or read permission.

Example prompt: "Show all unpaid orders for site site_abc123."

---

Loyalty

get_member_status

Get loyalty program member status including points balance and tier. Requires verticals or read permission.

Example prompt: "How many points does member mem_456 have on site site_abc123?"

earn_points

Award loyalty points to a member. Requires verticals permission.

Example prompt: "Give member mem_456 100 points for a €50 purchase."

list_rewards

List available loyalty rewards. Requires verticals or read permission.

Example prompt: "What rewards can members redeem on site site_abc123?"

---

Reviews

list_reviews

List reviews, optionally filtered by status. Requires verticals or read permission.

Example prompt: "Show all pending reviews for site site_abc123."

---

Jobs

list_jobs

List job vacancies. Requires verticals or read permission.

Example prompt: "Show all open vacancies for site site_abc123."

create_job

Create a new job vacancy in draft status. Requires verticals permission.

Example prompt: "Create a job posting for Senior Frontend Developer in Amsterdam."

---

Delivery

list_delivery_orders

List delivery orders with optional filters. Requires verticals permission.

Example prompt: "Show all delivery orders that are in transit."

update_delivery_status

Update the status of a delivery order. Requires verticals permission.

Example prompt: "Mark delivery order ord_123 as delivered."

get_delivery_kpis

Get delivery dashboard KPIs: total orders, today's orders, average delivery time, active drivers. Requires verticals permission.

Example prompt: "What are the delivery KPIs for site site_abc123?"

---

Rental

list_rental_units

List available accommodations/rental units. Requires verticals permission.

Example prompt: "Show all available accommodations on site site_abc123."

check_rental_availability

Check if a rental unit is available for given dates. Returns availability status and total price.

Example prompt: "Is unit unit_456 available from July 1 to 8, 2026 for 4 guests?"

create_rental_booking

Create a rental booking. Check availability first with check_rental_availability. Requires verticals permission.

Example prompt: "Book unit unit_456 from July 1-8 for John Smith."

list_rental_bookings

List rental bookings. Requires verticals permission.

Example prompt: "Show all approved rental bookings."

---

Real Estate

list_realestate_listings

List real estate listings with optional filters. Requires verticals permission.

Example prompt: "Show all published properties for sale on site site_abc123."

create_realestate_listing

Create a new real estate listing. Requires verticals permission.

Example prompt: "Add a 2-bedroom apartment in Amsterdam for €425,000."

search_realestate

Search real estate listings by location (geo search). Returns listings within a given radius of coordinates.

Example prompt: "Find rental properties within 5 km of central Amsterdam."

---

Voice Agent

get_voice_agent_config

Get voice agent configuration (language, greeting, hours, voice). Sensitive fields are masked. Requires verticals permission.

Example prompt: "What is the current voice agent config for site site_abc123?"

update_voice_agent_config

Update voice agent settings (language, greeting, voice, after-hours action). Cannot set API keys. Requires verticals permission.

Example prompt: "Set the voice agent greeting to 'Welcome to our business'."

get_voice_agent_analytics

Get voice agent call analytics: total calls, average duration, missed calls, top intents. Requires verticals permission.

Example prompt: "Show call statistics for the last 30 days."

---

SEO & Design

update_site_seo

Update site-level SEO settings: meta title, description, OG image, and robots directive. Requires write permission.

Example prompt: "Set the SEO title to 'Amsterdam Bakery' for site site_abc123."

update_page_seo

Update page-level SEO settings: meta title, description, and canonical URL. Requires write permission.

Example prompt: "Set the meta description for page page_xyz789."

update_design_tokens

Update design tokens for a site: colors, fonts, spacing, and border-radius. Changes are merged with existing tokens. Requires write permission.

Example prompt: "Change the primary color to #ff6600 and the heading font to Inter."

---

Push Notifications

send_push_campaign

Send a push notification to all subscribers of a site. Requires write permission.

Example prompt: "Send a push notification 'Summer Sale 20%!' to all subscribers of site site_abc123."

---

Webhooks

create_webhook

Register a webhook for events on a site. Requires write permission.

Example prompt: "Register a webhook at https://my-crm.com/hook for order.created events."

list_webhooks

List all webhooks for a site. Requires read permission.

Example prompt: "Show all webhooks for site site_abc123."

---

Chatbot

configure_chatbot

Activate and configure the chatbot for a site. Requires write permission.

Example prompt: "Activate the chatbot on site site_abc123 with an English greeting."

get_chatbot_config

Get the current chatbot configuration. Requires read permission.

Example prompt: "What is the chatbot config for site site_abc123?"

---

Domains

check_domain_availability

Check if a domain is available for registration. Returns availability, price, and whether it's free with the current plan. Requires domains or admin permission.

Example prompt: "Is the domain bakery-amsterdam.nl available?"

register_domain

Register a domain and automatically link it to Cloudflare for hosting. Checks tier limits. Not available during trial. Requires domains or admin permission.

Example prompt: "Register bakery-amsterdam.nl for site site_abc123."

transfer_domain

Transfer a domain to OptimoCMS using an authorization code. Not available during trial. Requires domains or admin permission.

Example prompt: "Transfer mydomain.nl to OptimoCMS with auth code ABC123."

get_domain_status

Get detailed status and registration info for a domain. Requires domains or admin permission.

Example prompt: "What is the status of bakery-amsterdam.nl?"

list_domains

List all domains belonging to the agency. Requires domains or admin permission.

Example prompt: "Show all my registered domains."

---

Email

create_mailbox

Create a mailbox for a site domain. Generates a secure password that is returned once. Checks tier limits. Not available during trial. Requires write permission.

Example prompt: "Create an info@ mailbox for site site_abc123."

list_mailboxes

List all mailboxes for a site. Requires read permission.

Example prompt: "Show all mailboxes for site site_abc123."

get_email_dns_records

Get DNS records required for email (MX, SPF, DKIM). Also shows verification status per record. Requires read permission.

Example prompt: "What DNS records are needed for email on site site_abc123?"

---

Orchestration

create_business

Launch a complete online business in one call. Generates a website, optionally registers a domain, sets up email, activates booking/ecommerce/voice agent/chatbot/loyalty, configures SEO, and publishes — all in a single orchestrated workflow. Site generation is the only hard blocker; all other steps are best-effort. Requires write + ai permission.

Example prompt: "Create a dental practice in Valencia with online bookings and a voice agent. Register the domain tandarts-valencia.es."

Example prompt (minimal): "Create a website for Golden Crust Bakery."

See the Business Orchestrator guide for full documentation, error handling, and tier requirements.

---

Team Management

list_team_members

List all team members of the agency with name, email, role, and assigned sites. Requires admin role.

Example prompt: "Show all team members."

add_team_member

Add a new team member. Creates a user account. Enforces team member limit based on billing tier.

Example prompt: "Add jan@example.com as editor with access to site_abc123."

remove_team_member

Remove a team member. Deletes their account and access. Cannot remove super_admin.

Example prompt: "Remove user uid_xyz789 from the team."

update_team_member_role

Update the role and/or assigned sites for a team member. Cannot modify super_admin.

Example prompt: "Make user uid_xyz789 an admin."

---

Permissions per tool