All servers / Marketing / CMO.so MCP server
CMO.so MCP server
CMO.so's MCP server for Claude Desktop, Cursor, VS Code and other MCP clients: manage your websites, blog posts, LinkedIn queue and results with Maggie.
Tested by ConnectATDScore 89 out of 100. Tested 2026-11-19 on package version 0.13.26. Package: @cmo-so/mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 19 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (1.2 seconds including download)
- Tools offered: 373
- Last published: 2026-11-18
- Weekly downloads (npm): 1,499
- License: SEE LICENSE IN LICENSE · Direct dependencies: 0
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
workspaces_list1 of 1 parameter describedList the websites (workspaces) this user can manage.
profile_get1 of 1 parameter describedThe signed-in person: name and email.
maggie_usage_get1 of 1 parameter describedHow many messages to Maggie and AI generations (ideas, LinkedIn drafts, voices) are left today, and when they reset.
website_add4 of 4 parameters describedAdd a new website for Maggie to work on: she reads it and builds its business profile (takes a few minutes). Use the address the user gave. (uses an AI generation.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
workspace_summary1 of 1 parameter describedThe current website: the user's role and permissions, plan, quota left, and the blog autopilot (on/off, paused, platform, posts per day).
inbox_list1 of 1 parameter describedWhat needs the user now: LinkedIn posts to review, failures, setup steps, low quota, pauses.
setup_status_get1 of 1 parameter describedHow far setting up this website has got: Maggie's reading steps, whether it is verified, whether it is connected for publishing, and whether the user can edit its profile.
connect_guides_get1 of 1 parameter describedHow to connect this website for publishing, per platform (WordPress plugin or push with an application password, Shopify, Wix, API): the steps, what to prepare (keys, permissions) and the setup page. The user enters keys in the app's connect form (connect_form_open); never ask for passwords or keys in chat.
connect_form_open2 of 2 parameters describedGive the user the cmo.so app's own form to connect this website for publishing: WordPress (the AI CMO plugin or an application password), Shopify (Dev Dashboard app client ID and secret), Wix (API key), api (any site, by API) or vibe (a site they build with an AI coding tool such as Claude Code, Codex or Cursor: install CMO.so there and paste one prompt). In the app chat it shows a button under your message; elsewhere it returns a link. The details go from the form straight to CMO.so: never ask for them in chat.
verify_email_start4 of 4 parameters describedProve the user owns the website: send a 6-digit code to a work email at the website's own domain (free email providers are refused). Then ask the user for the code. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
verify_email_confirm3 of 4 parameters describedCheck the 6-digit code the user received and verify the website. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
dns_record_get1 of 1 parameter describedProve the user owns the website by DNS: the exact TXT record (name and value) to add at their domain's DNS provider. Shows nothing once the website is verified. Use the email code instead when they have an address at the domain.
dns_verify_check3 of 3 parameters describedLook for the DNS TXT record now and verify the website if it is there. DNS changes can take minutes to hours to show; if it isn't visible yet, say so and offer to check again later. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wordpress_plugin_get1 of 1 parameter describedThe AI CMO connector plugin for WordPress: latest version and its download link, install guide, and whether this website already runs it (version, up to date, key added, enabled).
handoff_to_desktop4 of 4 parameters describedEmail the user a link to finish something on a computer: connecting their website (optionally for one platform), claiming or verifying by DNS, team, API keys or advanced settings. Never for plans or payment. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
maggie_actions_list1 of 2 parameters describedWhat Maggie has changed for this user on this website (newest first), with the result of each.
plan_quota_get1 of 1 parameter describedThe plan for this website and what is left: posts this month and today. Needs permission to see the plan.
dashboard_link1 of 2 parameters describedA link to the screen in the cmo.so app (app.cmo.so) for things the user does there themselves: team (add or remove people, change access), api_access (create or revoke API keys, disconnect apps), autopilot (publishing settings), report (full reports), rewrites (rewrite queue, find articles in the sitemap), brand_voices; account (email and password) is on ai.cmo.so.
api_keys_list1 of 1 parameter describedThe user's API keys: name, first characters, read or read-write, last used. Never the key itself; the user makes or revokes keys themselves in the app (dashboard_link api_access).
connected_apps_list1 of 1 parameter describedApps connected to the user's account (ChatGPT, Claude, the cmo.so app…), what they may do and when they were last used. `current` is the one in this conversation.
connected_app_revoke4 of 5 parameters describedDisconnect an app from the user's account (from connected_apps_list); it stops working at once and has to be connected again. Not the app in use now. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
standing_permissions_list1 of 1 parameter describedStanding permissions on the user's API keys: which key (a scheduled agent's) may run which writes on which website without a preview, each tool's daily cap and how much is used today.
standing_permission_set7 of 8 parameters describedLet one of the user's own API keys (from api_keys_list; a scheduled agent's, not the one in use) run some writes on one website without a preview, each up to a daily cap: idea_add, ideas_add_list, idea_priority, rewrite_request. Replaces any earlier one for that key and website. Leave a cap empty for the default (ideas 10 a day, priority changes 25, rewrites 2). Every run is in the action log; standing_permission_revoke ends it. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
standing_permission_revoke4 of 5 parameters describedEnd a standing permission (from standing_permissions_list): its key goes back to previews for every write. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
invoices_list1 of 1 parameter describedThe user's latest invoices across the subscriptions they pay for: date, amount, status and a link to view or download each.
profile_update3 of 4 parameters describedChange the user's display name (the only profile field Maggie changes; email and password are on ai.cmo.so). Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
notifications_get1 of 1 parameter describedWhich app notifications the user gets: LinkedIn posts to review (social_review), LinkedIn posts that failed (social_failed), new blog posts published (published).
notifications_set3 of 6 parameters describedTurn app notifications on or off by kind; only the kinds sent change. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
results_summary2 of 2 parameters describedResults for the current website: posts published, ideas waiting, AI visibility average.
ai_visibility_get1 of 1 parameter describedAI visibility: how often AI answers (Google AI Mode and similar) mention or cite the website. Average score, each watched prompt with its score, position and the site's pages AI cited, and the 30-day trend.
gsc_status_get1 of 1 parameter describedWhether Google Search Console is connected for this website and when its numbers were last fetched.
gsc_connect_link3 of 3 parameters describedA Google sign-in link for the user to connect Google Search Console for this website (or reconnect). Give them the link to open; never ask for their Google password. They must sign in with a Google account that can see this website in Search Console; if it can't, the page says which account and how to add it. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
gsc_performance_get1 of 2 parameters describedGoogle Search Console for the period (30d, 90d or 12m): clicks, impressions, CTR and average position, with the change against the period before (clicks and impressions as a ratio: -0.25 = 25% fewer, null when there was nothing before; ctr in points as a fraction; position in places, lower is better), the daily trend and the top pages.
gsc_queries_get1 of 4 parameters describedSearch queries people found the website with. filter: top (most clicks), low_ctr (many impressions but few clicks: improve titles and descriptions), striking_distance (average position 4–15: close to the top, worth a better post).
gsc_sync3 of 3 parameters describedFetch fresh Search Console numbers from Google now (at most once an hour per website). Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
content_performance_list1 of 4 parameters describedHow each tracked article does: clicks, impressions, position and its band (no_data, no_traffic, emerging, strong) with the suggested next step. Use band no_traffic to find articles worth rewriting.
content_asset_get1 of 2 parameters describedOne tracked article: its numbers, the search queries it shows up for, and its versions.
quota_get1 of 1 parameter describedBlog posts left for this website: today, this month and in total (limits and plan too if the user may see the plan).
seo_audit_get1 of 2 parameters describedThe latest technical SEO check (PageSpeed scores and top issues) and whether it is out of date or running.
seo_audit_run3 of 4 parameters describedStart a new technical SEO check (takes a few minutes; one at a time per website). Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ops_autopilot_get1 of 1 parameter describedMaggie's daily operations on the website (Ops Autopilot): whether it is available, and each feature with on/off, when it runs and how its last run went. Features: top_up (fills each social channel's empty slots for the week every morning), precheck (checks each social post before it goes out: no links or phone numbers on Google, a picture on Instagram, no placeholders or promised rankings; holds it as a draft if not), retry (tries a failed post once more), weekly_report (Monday report in the inbox), gsc_ideas (Search Console queries near page one become blog ideas), ai_visibility (weekly AI answer check), idea_cleanup (archives stale low-priority ideas weekly, restorable), competitor_watch (competitors' new articles become ideas), insight_memory (what performed best is remembered), post_health (checks new posts once they're live), gbp_reviews (new Google reviews with reply drafts), sales_signals (every morning the website's shop and bookings news — launches, sales, deals, rising, nearly gone, quiet days — becomes up to 3 blog and social ideas; an offer's waiting ideas are dropped when it ends), translations (a website in more languages, Maggie Core 0.27+, every morning: its own AI key translates what is missing or stale; else, with the owner's ChatGPT linked (Maggie Bridge), up to 10 pages on their plan, no credit; else cmo.so's model up to 3 pages, 1 post credit a page, 2 for a long one; long pages in chunks; machine translations wait unreviewed, not indexed).
ops_autopilot_set5 of 5 parameters describedSwitch Ops Autopilot features on or off for this website, and whether the Monday report is also emailed to the website's owner. Only features from ops_autopilot_get; a feature that isn't available yet can be switched but won't run. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
reports_list2 of 4 parameters describedThe website's report inbox, newest first: Maggie's own reports (weekly, daily operations, post health, Google reviews) and reports agents saved. Title and summary each; read one with report_get.
report_get1 of 2 parameters describedOne report in full (its text in Markdown and any data); marks it read.
report_save6 of 6 parameters describedSave a report to the website's inbox (for an agent's scheduled run: what it found and did). The owner gets a push and sees it in the app's Inbox. Up to 20 agent reports a day per website, 50,000 characters each. Saving changes nothing else. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
idea_cleanup_list1 of 2 parameters describedIdeas Ops Autopilot archived in its weekly clean-up (stale, low-priority ideas Maggie found herself; never ones a person added), newest first, each with why. Bring one back with idea_restore_cleanup.
idea_restore_cleanup3 of 4 parameters describedBring an idea the weekly clean-up archived back to the waiting list (id from idea_cleanup_list). Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
post_health_get1 of 2 parameters describedChecks of the blog posts that went live in the last week (Ops Autopilot, daily): whether each page opens, and has a title, a meta description, a canonical link to itself, an og:image and working links on the site. Each with its issues in plain words.
gbp_reviews_list1 of 3 parameters describedReviews of the website's Google Business profile (read every 6 hours by Ops Autopilot), newest first, each with Maggie's reply draft or the reply already sent. status: none (no reply yet), drafted (a draft waits to be sent), sent.
gbp_review_draft3 of 4 parameters describedAsk Maggie for a new reply draft to one Google review (one AI generation). Nothing is posted. (uses an AI generation.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
gbp_review_reply4 of 5 parameters describedPost the reply to one Google review on the website's Google Business profile: the draft, or your own text (up to 1,000 characters). Public: everyone who sees the review sees the reply. A review can be answered once here. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_post_get1 of 2 parameters describedOne social post in full: its whole text (social_list shortens it to about 300 characters), its pictures, its link, its channel and status, when it goes out, and why it was held before going out, if it was. Use it to check a post's ending (a web address or phone number on Google, a cut-off sentence) before approving or fixing it.
sales_signals3 of 3 parameters describedWhat is happening in the website's shop and bookings (Maggie Core 0.24+), to plan blog and social posts from: each signal with its key, type, the product, treatment, deal or day, price as the site shows it, stock, start / end date, why it fired, a facts line to write from, and whether Maggie already planned it. Types: launch (the owner set a launch date), new, on_sale (below its compare-at price), promo (a booking deal), coupon (a code the owner marked promote), back_in_stock, quiet (a coming day with few bookings), low_stock (nearly gone), rising (selling or booked faster than usual), best_seller, slow (none sold in 60 days), promote (the owner wants it promoted). Highest priority first; items marked never promote are left out. planned.steps lists a launch or offer's dated social posts. The website tells Maggie at once when a launch, sale, deal, coupon, new item or restock appears (with Ops Autopilot on, she plans it straight away); otherwise read every few hours (refresh true reads the website now). Next: sales_signals_plan.
sales_signals_plan7 of 7 parameters describedTurn sales signals into ideas that wait for approval: a blog idea per signal (written from its facts, linking to the product or booking page, prices exactly as the site gives them) and, when social channels are connected, social ideas that link to the item's page (with the campaign's utm tags). A launch or offer gets a dated series (series true, default): launch = teaser 3 days before, launch day, reminder 4 days after; sale, deal or coupon = when it starts, halfway (6+ days) and last chance the day before it ends (no end: a reminder a week later); each post goes out on or after its day. On Google Business a sale, deal or coupon with an end date becomes an Offer (code and page included), anything else gets a Shop or Book button. Before each post goes out the item is checked live: sold out, ended or marked never promote sends it back to a draft with the reason; ended offers' waiting ideas are dropped by themselves. A quiet day becomes a social idea only. keys: the signals to plan (from sales_signals); without keys the top `limit` (default 3, max 10) not planned yet, slow sellers left out. Nothing is published. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
sales_signal_mark8 of 10 parameters describedThe owner's choice for one product, treatment (service) or shop coupon, saved on the website: mode promote (boosts its signals; promoted even when nothing else fires, between from and to if given), never (never promoted: left out of signals), auto (default). launch_at: a launch date (YYYY-MM-DD) that makes a launch signal from 14 days before to 3 days after. from / to: campaign dates for promote (to also ends a sale's ideas). note: what to say about it (e.g. 'perfect Christmas gift'). Only the fields sent change; mode auto with nothing else clears the mark. Find ids with wp_shop_products or wp_booking_list (resource services). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
sales_item2 of 3 parameters describedCheck one item live on the website before writing or posting about it, with ok_to_promote. product / service: active, sold online, price as shown (and compare-at price), stock, on sale, the owner's mark and launch date. promo (a booking deal) / coupon: active, code, start and end, ended, used up (a coupon must still be marked promote). day: a booking day, id = its date as 20261111 (ok until it passes). Maggie runs this check herself before every post made from a sales signal. Without kind and id: the owner's marks (sales_signal_mark) instead.
sales_attribution1 of 3 parameters describedWhere the website's paid shop orders and online bookings came from over the last `days` (default 30): count and revenue (minor units) by the customer's first campaign touch, grouped by source (instagram, google, chatgpt…, with its medium), medium (social, organic, cpc, ai, referral) or campaign (utm_campaign; Maggie's social links carry utm_source = the channel, utm_medium = social and utm_campaign = her campaign's name-id, e.g. linkedin-posts-12). direct = no campaign, search or other site seen. Recorded from Maggie Core 0.24 on; desk bookings are left out.
ai_visibility_prompts_list1 of 1 parameter describedWhat AI-visibility monitoring watches for this website: on or off, the keywords it tracks, how many checks have run, and how many instant checks are left today (10 a day).
ai_visibility_keywords_set3 of 4 parameters describedReplace the keywords AI-visibility monitoring tracks (up to 50; each daily run takes 5 of them plus AI-suggested questions). Monitoring must be on. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ai_visibility_monitor_set3 of 4 parameters describedTurn daily AI-visibility monitoring on (paid plans) or off for this website. (needs a paid plan.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ai_visibility_prompt_check3 of 4 parameters describedAsk Google's AI one question now and see whether its answer mentions or cites this website. 10 a day per website; the result takes a minute or two (ai_visibility_prompt_result). Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ai_visibility_prompt_result1 of 2 parameters describedThe result of an instant check: still running, or its score, position, the site's pages AI cited, and the start of AI's answer.
report_overview_get1 of 2 parameters describedA full report when the user asks for a report or a 30 / 90-day view: blog posts published and by topic against the period before, Search Console totals, AI visibility and LinkedIn posts sent. For a quick "how did we do this week" use results_summary.
platform_detect1 of 1 parameter describedWhich website builder the site runs on (WordPress, Shopify, Wix, Webflow, Squarespace) and which one AI CMO publishes to now. Only when the user doesn't know or asks; if they named their platform, don't call it.
brand_get1 of 1 parameter describedThe business profile Maggie writes from: what they do, products, customers, regions, CTAs, testimonials.
brand_gaps_get1 of 1 parameter describedWhat the business profile is still missing, most important first, so Maggie can ask about one gap at a time.
brand_update5 of 9 parameters describedChange the business profile's text fields and simple lists (regions, industries, selling points). Pass only the fields to change; a list replaces that whole list, so include what to keep. Products, customer groups, CTAs and testimonials have their own tools. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
cta_upsert3 of 7 parameters describedAdd a call-to-action, or change the one for the same keyword. Needs the keyword it is for and an http(s) link the user gave (never invent links); give 3 sample texts. Max 10 CTAs. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
cta_remove3 of 4 parameters describedRemove the call-to-action for a keyword. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
internal_links_set3 of 4 parameters describedSet how many of the website's own latest articles each new post links to (internal cross-links, picked for the topic; separate from CTAs). 0 turns it off, max 10, default 3. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
testimonial_upsert5 of 7 parameters describedAdd a customer testimonial, or change the one from the same person. Only real quotes the user gives (or examples they asked for). use_in_posts turns testimonials on in posts. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
testimonials_change4 of 5 parameters describedRemove one person's testimonial, and/or turn using testimonials in posts on or off. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
product_upsert3 of 6 parameters describedAdd a product or service to the business profile, or change the one with the same name. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
product_remove3 of 4 parameters describedRemove a product or service from the business profile. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
audience_upsert3 of 5 parameters describedAdd a customer group to the business profile, or change the one with the same name. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
audience_remove3 of 4 parameters describedRemove a customer group from the business profile. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
competitor_upsert3 of 6 parameters describedAdd a competitor to the business profile, or change the one with the same name. Only ones the user names. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
competitor_remove3 of 4 parameters describedRemove a competitor from the business profile. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
competitor_suggestions_list1 of 1 parameter describedCompetitors Maggie found on the web (each website checked) that the user hasn't added to the profile or dismissed yet: name, website, one line, and how many ideas came from their site. Their sitemaps are already used for blog ideas while they wait.
competitor_suggestion_add3 of 4 parameters describedAdd one of Maggie's competitor suggestions (id from competitor_suggestions_list) to the business profile. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
competitor_suggestion_dismiss3 of 4 parameters describedNot a competitor after all: the suggestion is never made again and its site is no longer read for ideas. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
competitor_suggestions_find3 of 3 parameters describedLook for new competitors on the web now (once a day per website, subscribed websites only; Maggie also looks on her own once the website and its known competitors have no new pages left). New ones come back as suggestions; nothing is added to the profile. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
sitemap_list1 of 1 parameter describedThe sitemaps saved in the business profile: the website's own, competitors' and other sites' (industry sites, partners), each with what it is used for (post_ideas = blog post ideas, channel_ideas = social post ideas, internal_links and post_matching = own sitemaps only) and its last check (pages found or the error). Max 20.
sitemap_upsert6 of 8 parameters describedAdd a sitemap to the business profile, or change one (found by id from sitemap_list, else by url). owner: own (the website's own; its host must be the website or a subdomain, otherwise it is saved as other), competitor, or other. uses: own may have post_ideas, channel_ideas, internal_links, post_matching; competitor/other only post_ideas, channel_ideas; leave out for all allowed. A new sitemap needs url and owner. Only sitemap addresses the user gives or confirms (never guess one). Saving checks the sitemap; an unreachable one is still saved with the error. Max 20. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
sitemap_remove3 of 5 parameters describedRemove a sitemap from the business profile (by id from sitemap_list, or by url). Maggie stops reading it; ideas already found stay. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
brand_research_update3 of 6 parameters describedChange the profile's market notes: market_research (text), additional_information (anything else Maggie should know) or the SWOT list (each {name: Strengths|Weaknesses|Opportunities|Threats, description}). A list replaces the whole list. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
brand_voices_list1 of 1 parameter describedThe user's own brand voices (tone and audience combinations) Maggie can write in for this website.
brand_voice_set_default3 of 5 parameters describedMake one of the user's brand voices the one new blog posts are written in (as the voice selector on ai.cmo.so). name is for the card. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
brand_voice_create5 of 8 parameters describedCreate a brand voice (Maggie writes its style with AI). Pick at least one product, region, customer group and topic, using names from the business profile (brand_get). (uses an AI generation.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
brand_voice_update_style4 of 10 parameters describedChange how one of the user's brand voices writes: tone, writing_style, user_intent, positioning or example sentences. Pass only what changes; name is for the card. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
brand_voice_delete4 of 5 parameters describedDelete one of the user's brand voices. Cannot be undone; put its name on the card. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
posts_list1 of 3 parameters describedBlog posts: planned (topics Maggie will write next, in order), draft (written, waiting to go out) or published.
post_get1 of 2 parameters describedOne blog post: title, excerpt, link, whether it can still be edited, and the start of its text.
draft_update4 of 8 parameters describedChange a draft (not yet published): its title, excerpt or whole Markdown text. Pass only what changes; markdown replaces the whole text. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
draft_rewrite5 of 7 parameters describedLet Maggie rewrite a draft with AI and save the result: mode fix (tidy formatting and mistakes) or edit (follow the user's instruction, e.g. make it shorter). Uses one of today's messages. (uses an AI generation.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
draft_rewrite_brief2 of 4 parameters describedFor an assistant that writes with its own model: a draft's whole Markdown and the rules for rewriting it (mode fix: formatting only; edit: the user's change). Write the new version yourself, then save it with draft_rewrite_save. Free.
draft_rewrite_save5 of 7 parameters describedSave a draft you rewrote from draft_rewrite_brief: the whole new Markdown. It is checked like Maggie's own rewrites (not much shorter; a fix keeps every link and image). Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
draft_delete4 of 5 parameters describedDelete a draft. Its idea is dropped too and the credit it used is not refunded. Ask which one; never delete several at once. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
plan_move5 of 6 parameters describedMove a planned post up, down or to the top: Maggie writes the plan in order. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
plan_update4 of 8 parameters describedChange what a planned post will be about (title, description, up to 5 keywords). Its place stays. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
plan_remove4 of 5 parameters describedTake a planned post out of the plan; its idea can be restored later. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ideas_list1 of 3 parameters describedIdeas waiting to be written (newest first, 15 a page), or discarded ones that can be restored.
topics_list1 of 1 parameter describedThis website's topics (the themes Maggie writes about), for sorting an idea into one.
idea_add5 of 5 parameters describedAdd one idea for a blog post, from a link or a sentence (Maggie drafts it with AI). (uses an AI generation.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ideas_add_list3 of 4 parameters describedAdd up to 100 ideas exactly as given (a researched list): title, description, primary keyword, up to 5 more keywords, a benchmark URL (read as research, never linked), priority 1-10 and optionally one of the website's topics. No AI rewrites them and no generation is used; they wait in the idea pool, not the plan. Duplicates are skipped and listed; a person's own waiting ideas have a limit (ideas_list cap, 200 today). Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ideas_generate4 of 5 parameters describedLet Maggie come up with new ideas (1–10) with AI, optionally about a theme. (uses an AI generation.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ideas_import_sitemap4 of 5 parameters describedImport ideas from the website's own sitemap (pages not written about yet), or from another sitemap, site or page the user names. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
idea_update4 of 9 parameters describedChange a waiting idea: title, description, topic (from topics_list) or up to 5 keywords. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
idea_priority4 of 6 parameters describedRaise (+1) or lower (-1) a waiting idea's priority; Maggie plans the highest first. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
idea_plan5 of 6 parameters describedAdd a waiting idea to the plan (the plan holds up to 100): at the end, or where `position` says (front, random, after N planned posts). The answer's position counts from 1. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
idea_discard4 of 5 parameters describedRemove one idea so it won't be written (it can be restored). Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
idea_restore4 of 5 parameters describedBring back a discarded idea (ideas_list status discarded). Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
autopilot_set_paused3 of 4 parameters describedPause or resume publishing blog posts to the website. Maggie keeps writing while paused. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
publish_settings_get1 of 1 parameter describedHow blog posts reach the website: connected platform, delivery mode (push from AI CMO, or the site's plugin / API fetching), posts per day and the most the plan allows, paused or not, when the last post went out and when the next is due, and posts left.
posts_per_day_set4 of 4 parameters describedBlog posts a day for the website (1, 2, 12, 24, 48 or 96, up to the plan's limit). Sites AI CMO pushes to: how many it publishes a day. Plugin / API sites: the most the site collects a day (it still decides how often it checks). Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
post_publish_now4 of 5 parameters describedPublish one ready draft to the website now instead of waiting for its turn. Uses one post from today's quota; the content guard may still hold it as a draft on the site. (uses a post credit; needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
rewrite_queue_list1 of 3 parameters describedPublished articles suggested for a rewrite today (why, and their search position), or with view=published the ones already rewritten. Also says whether auto-rewrite is off, manual or auto.
rewrite_request4 of 6 parameters describedRewrite one post or page on the user's website and update it there (same URL). Works for any post on their WordPress, including its blog subdomain (blog.example.com for example.com), whether CMO.so wrote it or not: it is found by its URL. Uses one post credit. Optional instructions (what to change, e.g. 'add 5 FAQs at the end') and target keywords. (uses an AI generation; uses a post credit; needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
rewrite_policy_get1 of 1 parameter describedAuto-rewrite settings: off, manual or auto; the share of each day's posts that go to rewrites; the minimum article age; today's new / rewrite split.
rewrite_policy_set3 of 6 parameters describedChange auto-rewrite: mode (off, manual, auto), ratio (0–1 of each day's posts that rewrite old articles) and the minimum age in days before an article can be rewritten. Only the fields sent change. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
content_guard_get1 of 1 parameter describedThe content guard: whether each post is checked against the site's rules (industry and extra guideline) before it goes out, how strict it is, and how many posts it held as drafts in the last 30 days.
content_guard_set3 of 9 parameters describedChange the content guard: turn it on or off, the industry rules (industries from content_guard_get), an extra guideline in the user's words, how sure it must be to hold a post (0.5–0.99), and whether it checks new posts and rewrites. Only the fields sent change. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
content_guard_test3 of 6 parameters describedTry the content guard on one post (content_id) or on a title and text, without publishing: would it go out or be held, and why. (uses an AI generation.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_list1 of 1 parameter describedThe user's social channels (LinkedIn, a Facebook Page): which are connected or paused, approval mode, the queue (drafts to review and queued posts, each with its channel and when it should go out), campaigns, and recent posts.
social_update_copy4 of 5 parameters describedChange the text of a social post that hasn't gone out yet (a draft or queued post). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_approve5 of 5 parameters describedApprove post drafts: each goes to the front of the user's queue and out at the next posting times, or where `position` says (end, random, after N posts). Pass every id to approve in one call. (needs a verified website; needs LinkedIn connected.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_publish_now3 of 4 parameters describedPost one social post on its channel now instead of at its posting time: a draft waiting for approval, a queued post, or one that didn't go out. It goes even while posting is paused. It goes out in the background: the answer says it is publishing; read social_post_get after a minute for its link (or why it couldn't go). Not while its picture is being made. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_posted_update5 of 6 parameters describedChange a social post that has already gone out. On LinkedIn the new text replaces the old in place: the post keeps its likes and comments (its pictures can't change this way). With repost, and on Facebook, Instagram and Google, the old post comes down with its likes and comments and the new version goes out now. Without social_copy and with repost, it goes out again as it is (e.g. after new pictures). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_posted_delete3 of 4 parameters describedTake a social post that has gone out down from its channel (LinkedIn, Facebook, Instagram, Google). Its likes and comments go with it; this can't be undone. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_skip3 of 4 parameters describedSkip a LinkedIn post (it won't be posted; it can be restored). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_restore3 of 4 parameters describedBring back a skipped LinkedIn post. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_image_new10 of 10 parameters describedMake a new picture for a social post that hasn't gone out, or change its current one (mode: edit, as `instruction` says). Uses 1 AI generation. It is made in the background, on the user's own ChatGPT when their Maggie Bridge has images on, else by CMO.so; it takes up to a couple of minutes and appears on the post by itself (check with social_image_status). One picture is made at a time per website: while another is being made this one waits in line (status queued). It fails with image_busy only when this post already has one being made or in line; pass replace: true only when the user agrees to stop the one being made and make this one now. A post written from an article gets its own picture (from its text and the article's title) and then goes out as that picture. Every new picture carries a short title and line set on it; count: 4 makes a set of 4 pictures that tell one story (still 1 AI generation, drawn as one storyboard and cut); LinkedIn and Facebook post a set together as a collage. text_effect picks the style of those words (an id from social_text_effects); leave it out to let Maggie pick. style picks the picture style (an id from social_look: photo_headline, editorial, duotone, illustrated, bold_type, infographic); leave it out and Maggie takes turns with the brand's 3. bold_type and infographic make no AI picture (big words or a list in the brand's look) and cost nothing. count 5-10 makes a text carousel: a cover with the hook, one point a slide and a last slide with the next step, words on the brand's colours (style bold_type or infographic), no AI picture and free; LinkedIn posts it as a swipeable PDF carousel, Instagram and Facebook as a carousel (the first 10), TikTok as a photo post (social_tiktok_photo). (uses a post credit; needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_images_fill5 of 5 parameters describedA new picture for every social post here that hasn't gone out and has none (or only these ids), made one after another in the background: 1 AI generation each. A LinkedIn and a Facebook post of the same idea share one picture. Says how many are in line, how many already were, and why it stopped early (the line is full, or the day's AI generations ran out). Preview the count first. (uses a post credit; needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_text_effects1 of 1 parameter describedThe styles for the words on a set of pictures (social_image_new with count 4): id, name, family and a sample picture URL. Use when the user wants to choose how the words look ('bold sticker', 'neon', 'gold').
social_look1 of 1 parameter describedThe brand's picture look on this website (made the first time it's asked for): the 3 picture styles Maggie takes turns with, the 5 text styles she picks from per picture, two fonts, the colours (ink, paper, primary, accent, muted), a short description of how its photos look, and things never to show; plus every style, font and text style that can be chosen. Read it before changing the look or when the user asks how their pictures look.
social_look_update11 of 11 parameters describedChange the brand's picture look: the 3 styles Maggie takes turns with (style_ids, 1-3), the text styles (text_effect_ids, 1-5, ids from social_text_effects), fonts, colours (hex), the description of how photos look, things never to show, or reset: true (back to Maggie's suggestion). New pictures use it; pictures already made keep theirs (social_picture_edit changes one). Preview the change first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_picture_edit9 of 9 parameters describedChange a picture Maggie made for a post that hasn't gone out, without making a new one (free, a few seconds): the words on each picture (title up to 60 characters, line up to 90), its picture style, its text style, or for a set the order (indexes, 0 = first) or pictures to drop. Only posts whose picture says editable in social_list; a photo style needs the picture's photos (has_photos). Changing the words of one picture: send every picture's words in order. Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_photo_words5 of 5 parameters describedPut a title and a line on the user's own photo(s) on a post, in the brand's look: Maggie writes the words from the post (no AI picture, free). Only for a post whose picture is the user's own photo (own_photo in social_list). style: real_photo (default, the photo framed with the words below), product_hero (the words on a card), or another photo style. Then social_picture_edit changes the words. Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_pictures_attach7 of 7 parameters describedPut the user's own pictures on a post, in order: pictures from this chat (files: ones the user added or that were made here) or public https links to image files (urls), JPEG, PNG or WebP, for example carousel slides. 1-20 pictures; append adds them after the post's current ones. Free (no AI). They replace Maggie's picture; a post from an idea shares them with its other channels. Instagram and Facebook post the first 10, Google Business the first. On LinkedIn a set goes out as a swipeable PDF carousel unless social_carousel_set says images. If you can pass neither, give the user social_upload_link. Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_carousel_pdf_attach7 of 7 parameters describedA PDF carousel for a LinkedIn, Instagram, Facebook or TikTok post: the PDF from this chat (file: one the user added or that was made here) or a public https link to it (url); up to 300 pages and 20 MB, no password. Its first 20 pages become the post's pictures: Instagram and Facebook post them as a carousel (the first 10), TikTok as a photo post. A LinkedIn post (this one, or the same idea's LinkedIn post) goes out as the PDF itself, a swipeable document carousel. Free. Change the pictures later and the LinkedIn carousel is made from them instead. If you can pass neither, give the user social_upload_link. Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_upload_link2 of 2 parameters describedA link that opens one post's picture in the CMO.so app, where the user uploads their own photos (up to 20, a carousel on LinkedIn) or, on a computer, a PDF carousel themselves. Use it when you can't pass the files (this chat can't send files to tools, or they are on the user's device). Give the link; nothing changes until they upload.
social_carousel_set5 of 6 parameters describedHow a LinkedIn post with a set of pictures goes out: format pdf (a swipeable PDF carousel made from the pictures, the default) or images (several pictures); and the carousel's title. Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_post_insights3 of 3 parameters describedHow a posted Instagram post is doing: views, reach, likes, comments, saves and shares, read from Instagram (kept 15 minutes; refresh: true reads again). Saves and shares per reach are the best signs of a good post. available: false says why (not posted yet, deleted on Instagram, the account needs reconnecting).
social_write_status1 of 1 parameter describedPosts Maggie is writing in the background for this user on this website (from social_from_article, social_plan_days, social_idea_write or the app), and the ones finished in the last 10 minutes: running, done (the new post ids) or failed (why), and any channel that couldn't be written. Look once when the user asks, not in a loop.
social_image_status1 of 1 parameter describedThe picture being made on this website and those waiting in line (which post, new or edit), or how the last one ended (done, failed with why, stopped) and who drew it (chatgpt or gemini).
social_image_stop3 of 4 parameters describedStop the picture being made on this website (the post keeps the picture it had; the next in line starts). all: true also empties the line. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_move3 of 5 parameters describedMove a queued LinkedIn post up, down or to the front among the user's own posts. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_set_paused3 of 5 parameters describedPause or resume the user's social posting: one channel (linkedin or facebook), or every channel when no channel is given. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_sources_list1 of 2 parameters describedPublished articles a social post can be made from (optionally matching a search), newest first, up to 30: each with when it was published and used_on, the channels it was shared to in the last 30 days with the latest date (empty = not shared lately; an article is free to share again 30 days after its last post).
social_from_article6 of 7 parameters describedMaggie writes a post about one published article (id from social_sources_list) for each channel. It waits for the user's OK as a draft, unless their approval mode is auto (then it is queued: at the front, or where `position` says). Written in the background (a minute or two): this returns at once with a job. Tell the user Maggie is writing and they will be told when it's ready; before saying what was written, check social_write_status (then social_list for the posts). (uses an AI generation; needs a verified website; needs LinkedIn connected.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_plan_days6 of 7 parameters describedMaggie writes posts for the next 1–7 days from the best recent articles, on each channel. They wait for the user's OK as drafts, unless the user's approval mode is auto (then they are queued in order: at the front, or where `position` says). Written in the background (a minute or two): this returns at once with a job. Tell the user Maggie is writing and they will be told when it's ready; before saying what was written, check social_write_status (then social_list for the posts). (uses an AI generation; needs a verified website; needs LinkedIn connected.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_ideas_list1 of 2 parameters describedThe user's LinkedIn ideas waiting to be written (their own and their campaigns'), newest campaign first.
social_idea_add4 of 6 parameters describedAdd an idea for a social post (not written yet; writing it later uses a credit per channel). (needs a verified website; needs LinkedIn connected.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_idea_update3 of 6 parameters describedChange a social idea's title or summary. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_idea_delete4 of 5 parameters describedDelete a social idea that hasn't been written. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_idea_write6 of 7 parameters describedMaggie writes one idea's post for each channel (1 credit per post). The user's own idea's posts wait for their OK (queued straight away only in approval mode auto, at the front or where `position` says); a campaign's wait for the campaign to start. Written in the background (a minute or two): this returns at once with a job. Tell the user Maggie is writing and they will be told when it's ready; before saying what was written, check social_write_status (then social_list for the posts). (uses an AI generation; uses a post credit; needs a verified website; needs LinkedIn connected.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_idea_brief1 of 2 parameters describedFor an assistant that writes with its own model: what Maggie would write one idea's posts from, one per connected channel (the instructions, the brand's voice and template, each channel's length limit and the JSON shape). Write the posts yourself, then save them with social_idea_save. Free.
social_idea_save6 of 7 parameters describedSave the posts you wrote from social_idea_brief (1 credit per post, like Maggie writing them). They get the same checks, links and limits. The user's own ideas go to the queue; a campaign's wait for the campaign to start. (uses a post credit; needs a verified website; needs LinkedIn connected.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
campaign_list1 of 1 parameter describedThe user's social campaigns: ideas written so far, whether ready or started, start day and posts a day.
campaign_start5 of 7 parameters describedStart a ready campaign (every idea written): its posts go out on its channels in order from start_date (default today), at most daily_limit a day. (needs a verified website; needs LinkedIn connected.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
campaign_get1 of 2 parameters describedOne of the user's LinkedIn campaigns with its ideas and their state.
campaign_create3 of 7 parameters describedCreate a LinkedIn campaign: a name, what it is about (brief), its objective and an optional link to send readers to (only one the user gave). Plan its ideas next with campaign_plan. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_approve_all4 of 5 parameters describedApprove every post waiting for the user's OK (not a series that hasn't been approved), on one channel or all: they go out one by one at each channel's next posting times (from the front of the queue, or where `position` says). (needs a verified website; needs LinkedIn connected.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
series_create6 of 6 parameters describedMaggie plans and writes a series: 1-7 posts on one theme (brief) that read as a series, for each channel. They are ordinary posts: each waits in Review for the user's OK (social_approve), labelled with the series. Uses one AI generation a post. (uses an AI generation; needs a verified website; needs LinkedIn connected.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
series_approve4 of 5 parameters describedApprove a written series: its posts go out in order at the user's posting times on each channel (their own posts go first). (needs a verified website; needs LinkedIn connected.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
campaign_plan4 of 5 parameters describedMaggie plans a campaign's LinkedIn post ideas with AI (uses 1 credit). (uses an AI generation; uses a post credit; needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
campaign_pause4 of 6 parameters describedPause (paused true) or resume (false) one of the user's started campaigns. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_approval_mode_set3 of 4 parameters describedWhether the user's LinkedIn drafts wait for their approval (manual) or go out on their own at the posting times (auto). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_setup_get1 of 1 parameter describedThe user's LinkedIn setup: which steps are done, logo and image style, learned voice, chosen post formats and writing options, posting hours.
social_voice_learn3 of 4 parameters describedLearn how the user writes from one of their LinkedIn posts (they paste it); saved as their default voice. (uses an AI generation; needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_formats_suggest3 of 3 parameters describedMaggie suggests LinkedIn post formats that suit the user's voice (nothing is saved). (uses an AI generation.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_format_preview1 of 2 parameters describedExample posts in one LinkedIn format, short / medium / long.
social_formats_set3 of 7 parameters describedChoose the LinkedIn post formats to use (keys) and the writing options. Writing options left out stay as they are. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_hours_set4 of 6 parameters describedSet the user's LinkedIn posting hours: times like 09:00 in their timezone, on the given weekdays (default Monday–Friday). Each time is one posting slot. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_style_set3 of 5 parameters describedChange the image style (an id from social_setup_get styles) and/or colour palette (hex colours) for LinkedIn images. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_style_retrain3 of 3 parameters describedMaggie looks at the saved logo again and picks a new image style and palette (saved). (uses an AI generation; needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
linkedin_connect_link3 of 3 parameters describedA link for the user to connect (or reconnect) LinkedIn. Give them the link to open; never ask for their LinkedIn password. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
facebook_connect_link3 of 3 parameters describedA link for the user to connect a Facebook Page (or reconnect). Give them the link to open; never ask for their Facebook password. If they manage several Pages they pick this website's one in the app afterwards. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
google_business_connect_link3 of 3 parameters describedA link for the user to connect their Google Business Profile (or reconnect): they sign in with the Google account that manages the profile; every profile it can post to is saved and the one whose website is this site is picked (else they pick it in the app). Only verified profiles can post. Give them the link to open; never ask for a password. Google posts are short local updates with one photo and a button; Google checks each one before it shows. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_google_button4 of 5 parameters describedSet the button on a Google Business post that hasn't gone out: LEARN_MORE (default, opens the post's link), BOOK (a booking link), ORDER, SHOP, SIGN_UP, or CALL (calls the profile's phone number; needs no link). Pick the one that matches what the post asks people to do. Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
youtube_connect_link3 of 3 parameters describedA link for the user to connect their YouTube channel (or reconnect): they sign in with the Google account that owns the channel and allow Maggie to upload videos and see the channel. Give them the link to open; never ask for a password. YouTube posts are short videos (5-30 seconds now) that the user approves one by one. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_video_attach6 of 6 parameters describedMake a LinkedIn, Facebook or Instagram post that hasn't gone out a video post: it goes out as this video (5-30 seconds) with its text, and its picture is removed (a video post has no picture). The video from this chat (file: one the user added) or a DIRECT https link to a video file (url; never a platform page). If you can pass neither, the user adds the video in the CMO.so app (Social). Not for Google Business (posts can't carry video). Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_video_detach3 of 4 parameters describedTake the video off a LinkedIn, Facebook or Instagram post that hasn't gone out: it's a text post again (a picture can be added after). Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
tiktok_connect_link3 of 3 parameters describedA link for the user to connect their TikTok account (or reconnect): they sign in to TikTok and allow Maggie to see their profile and post videos. Give them the link to open; never ask for a password. TikTok is in beta (testers only; until TikTok reviews our app, videos post as 'Only me' and the account must be private). TikTok posts are short videos (5-30 seconds) that the user approves one by one. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
tiktok_creator1 of 1 parameter describedWhat the user's TikTok account allows right now (TikTok asks to check before every post): its name and @username, who a video can be shown to (privacy_options), whether comments / Duet / Stitch are turned off on the account, the longest video it can post, and whether it can post now (problem). Read it before asking the user the TikTok settings of a post.
social_tiktok_set4 of 12 parameters describedSet a TikTok post's settings, ONLY as the user chose them (TikTok's rules: never pick for them, nothing is preset): privacy (one of the account's privacy_options from tiktok_creator: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY), allow_comment / allow_duet / allow_stitch (off unless the user turns them on; not possible when the account turned them off), disclose (the video promotes a brand, product or service) with your_brand (their own: labelled 'Promotional content') and / or branded (a third party: labelled 'Paid partnership'; can't be SELF_ONLY), is_aigc (AI-generated content label). The caption is the post's text (social_update_copy). Before the user approves, tell them: 'By posting, you agree to TikTok's Music Usage Confirmation' (with branded content: 'TikTok's Branded Content Policy and Music Usage Confirmation'). Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_video_add12 of 13 parameters describedMake video posts (channels: linkedin, facebook, instagram, youtube, tiktok; default youtube; one post each, never google_business: Google posts can't carry video) from a video: a video already in CMO.so (video_id, e.g. a ready ad video's), the video from this chat (file: one the user added) or a DIRECT https link to a video file (url: an .mp4 on their website, a public Dropbox link), never a YouTube / TikTok / Instagram page (we never download those). If you can pass neither, tell the user to add the video in the CMO.so app (Social). The video must be 5-30 seconds: give start/end (seconds) to use a part of a longer one. vertical: make a wide video vertical (a Short) cropped at left, middle or right. Maggie writes YouTube's title, description and tags, TikTok's caption, or the LinkedIn / Facebook / Instagram text, from the video and the note (one AI generation per channel) unless write is false. Each post waits in Review: video posts are always approved by the user. YouTube asks whether it's made for kids; TikTok asks who can view it and the other TikTok settings (social_tiktok_set, as the user chooses). is_aigc: TikTok's AI-generated label, only when the user says the video was made with AI. Preview first. (uses an AI generation; needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_tiktok_photo6 of 6 parameters describedA TikTok photo post (a swipeable set of pictures; TikTok adds music) from a post's pictures: a set, a text carousel (social_image_new count 5-10) or the pages of a PDF. A new TikTok post that waits in Review like every TikTok post. Maggie writes the caption from the post (one AI generation) unless caption is given. Then TikTok's settings: read tiktok_creator, ask who can view it and the rest, social_tiktok_set exactly as the user says. TikTok is in beta. Preview first. (uses an AI generation; needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ad_video_plan8 of 9 parameters describedPlan a short ad video (beta) and say what making it costs. Maggie writes a storyboard: 2-5 scenes, each with the first picture's brief (no words in pictures), what moves and one camera move, the narrator's line and the words on screen; an end card with the next step and the logo; a voice and music. One AI generation; nothing is billed by the second yet. brief: what the ad should do, in the user's words, or item_id: a post whose text is the brief (once made, the video goes on that post if it's still to go out on LinkedIn, Facebook or Instagram). aspect 9:16 (Reels, TikTok, Shorts; default) or 16:9 (LinkedIn, YouTube); seconds 15, 20 (default) or 30; reference_url: a public YouTube ad whose rhythm to follow (Gemini watches it; never downloaded). Show the storyboard and the cost (estimate.items, estimate.usd) before ad_video_make. Preview first. (uses an AI generation; needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ad_video_list1 of 1 parameter describedThis website's ad videos (beta): each with its status (planned, running and its step, ready, failed), the storyboard's title, its cost so far and, when ready, the video (video_id) to post.
ad_video_get2 of 2 parameters describedOne ad video (beta): its storyboard (scenes with their pictures once made), what making the missing pieces costs (estimate), its status and step; when ready, video_id and the video's status (it is prepared for the channels in the background: post it once video.status is ready). While it's running, check again every minute or so.
ad_video_change10 of 17 parameters describedChange an ad video's storyboard (beta) as the user asks, before making it (or after: only what changed is made again). A scene (scenes[]): its picture brief (still), movement (motion), the narrator's line, the words on screen (caption), its seconds (3-8), and timing inside it: caption_in / caption_out (when the words show and go, seconds into the scene) and voice_at (when the narrator starts); -1 puts a time back to its default; picture "ai" swaps the user's own photo back to an AI picture. add_scenes (still required; after: a scene id, else at the end); order: the scene ids to keep, in order (removes and reorders; 2-5 scenes); redo_scenes: make scenes' pictures and clips again. The whole video: style (the look; every AI picture and clip again), aspect 9:16 or 16:9 (every picture and clip again), seconds 15/20/30 (scenes rescaled), card_seconds (1.5-4); the end card (cta_headline, cta_sub); the voice (a name from ad_video_list voices, or none); the music (words, or none). redo says what's made again: a picture brief, the look or the shape mean new paid pictures and clips, a movement a new paid clip; lines, words, timing, order, end card, voice or music are cheap. Returns the new cost, the timeline and the script check (lines that don't fit their time, captions too fast to read, length); fix errors before ad_video_make. Not while it's being made. Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ad_video_make7 of 7 parameters describedMake the ad video (beta). stage "pictures" makes only the first frames (cheap: estimate.pictures_usd) so the user sees them (picture_url) and changes any before the paid clips; then make it again (stage all) for the rest. Stage all: its pictures (on the user's own ChatGPT when their Maggie Bridge has images on, else Gemini), the moving clips (Gemini, billed per second), the voice, the music, the words and the end card, cut into one video, in the background (several minutes; follow it with ad_video_get). It COSTS MONEY: estimate_usd must be the estimate.usd (or estimate.pictures_usd for stage pictures) from ad_video_plan / ad_video_get / ad_video_change that the user agreed to; if the cost changed it is refused with the new one. A script that doesn't fit its timing (script_check errors) is refused: fix it with ad_video_change, or go_ahead true only when the user says to make it anyway. Each website has a daily limit. Making it again after a change or a failure only makes what's missing. When ready, post it with social_video_add and its video_id. Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ad_video_picture6 of 6 parameters describedUse the user's own photo as an ad video scene's first frame (beta): a picture already on CMO.so (picture_url: a post's picture from social_list / social_post_get). It is cropped to the video's shape; no AI picture, no cost for it; the scene's moving clip is made again. For a photo on their device, they use the Ad video screen in the CMO.so app. Back to an AI picture: ad_video_change scenes [{id, picture: "ai"}]. Not while it's being made. Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
ad_video_stop4 of 4 parameters describedStop an ad video being made (after the piece it's on; what was made is kept and making it again carries on), or remove one that isn't being made from the list (posts made from it keep their video). Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
social_youtube_set4 of 9 parameters describedChange a YouTube post that hasn't gone out: title (at most 100 characters, aim 40-60), tags, visibility (public, unlisted, private), made_for_kids (YouTube asks for every video: ask the user, never guess) or synthetic (realistic AI-made or altered content). The description is the post's text (social_update_copy). Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
youtube_settings1 of 1 parameter describedThe user's YouTube defaults for new posts on this website: visibility, made_for_kids (null = asked each time), category and altered content.
youtube_settings_set4 of 6 parameters describedChange the YouTube defaults for new posts: privacy (public, unlisted, private), made_for_kids (yes / no for every video, or ask per video) and synthetic. Only what the user says. Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
google_business_performance2 of 2 parameters describedHow the website's Google Business Profile is doing: views on Google Search and Maps, website clicks, calls and direction requests for the last 28 days next to the 28 before (Google's numbers lag 2-3 days). Use it when the user asks how their Google listing or local presence is doing, or to show what Google posts are worth. Compare with the previous 28 days; don't invent reasons for changes.
social_google_post_type12 of 13 parameters describedMake a Google Business post that hasn't gone out an EVENT (an open day, a workshop: title up to 58 characters, start and end dates YYYY-MM-DD, optional times HH:MM) or an OFFER (title, dates, optional coupon code, terms and redeem link; Google adds a View offer button), or back to STANDARD (an update). Offers are refused for regulated categories (finance, health, alcohol, gambling) and hotels: use an update or an event. Only real dates and offers the user gave. Preview first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
instagram_connect_link3 of 3 parameters describedA link for the user to connect Instagram (or reconnect). Instagram connects through the Facebook sign-in: only an Instagram professional account (Business or Creator) linked to one of their Facebook Pages can be posted to, so tell them that first. Give them the link to open; never ask for a password. Every Instagram post goes out with its picture (no links in it). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
team_list1 of 1 parameter describedWho is on this website's team: the owner and each member with their six permissions.
team_candidates_search1 of 2 parameters describedPeople who asked to join this website and match a name or email, to add with team_member_add.
team_member_add5 of 8 parameters describedLet a candidate (from team_candidates_search) into the website's team with a preset (viewer, editor, manager) and any per-area changes. Never more than the user has. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
team_member_update6 of 8 parameters describedChange a team member's permissions (from team_list): a preset and/or per-area levels. Pass their current permissions as before so the card shows what changes. Not for the user themself. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
memory_get1 of 1 parameter describedThe user's Maggie Memory on this website: their saved taste per channel (general, blog, linkedin, facebook, instagram, google_business) as prefer / always / never items, each with an id. Already in your instructions when it is on; read it to answer what you remember or to find an id to forget.
memory_remember5 of 7 parameters describedSave one lasting preference the user stated ("remember…", "always…", "never…", "from now on…") to their Maggie Memory, so future posts, drafts and images follow it. One short actionable sentence; channel general unless it is about blog posts, LinkedIn or Facebook only. Not for one-off requests. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
memory_forget4 of 5 parameters describedRemove one item from the user's Maggie Memory (ids from memory_get). Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
feedback_send8 of 8 parameters describedSend feedback to the cmo.so team: a bug, something not good enough, an idea, or something the user loves. Use it when the user asks to tell the team, reports a problem with CMO.so or with you, or wants a feature; you may offer it when the user points out that you got something wrong. Write the summary in one sentence of the user's own point; put what happened in details. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
feedback_list1 of 1 parameter describedThe feedback the user sent to the cmo.so team, newest first: what it was about, its status (new, reviewing, planned, fixed, wont_fix, duplicate) and the team's reply.
skills_search3 of 4 parameters describedSearch cmo.so's open library of marketing skills (step-by-step methods an AI agent follows, free and MIT licensed): returns matching skills with their summary, vote score and page. Use it when the user asks how to do a marketing job, wants a playbook or template, or asks which skills exist. Empty query: the most useful ones and the categories.
skill_get2 of 2 parameters describedOne marketing skill from the cmo.so library in full: when to use it, what it needs, its workflow, output and quality bar, plus how to install it in Claude Code. Use it to follow a skill's method for the user, or to explain it.
skill_like5 of 5 parameters describedUpvote a skill in the cmo.so library for the user (or take the upvote back with undo). Votes help the library decide what to keep improving. Only when the user asks. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
skill_save5 of 5 parameters describedSave a skill to the user's saved skills on cmo.so (or remove it with undo), to find it again under Saved at cmo.so/skills or with skills_saved_list. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
skills_saved_list1 of 1 parameter describedThe skills the user saved on cmo.so, newest first.
skill_submit5 of 5 parameters describedSuggest a public open-source GitHub repo for cmo.so's skill library. Maggie researches it within minutes and decides: add a new skill, improve an existing one, keep it as a candidate that needs a vote score of 10 in 30 days, or decline (licence first: permissive licences can be adapted, copyleft only inspires, no licence is declined). 3 suggestions a day. Follow up with skill_submissions_list. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
skill_submissions_list1 of 1 parameter describedThe repos the user suggested for the skill library and what happened to each: queued, researching, candidate (with its deadline), publishing, published (with the skill), declined, expired or failed, with Maggie's reasons.
prompts_library5 of 7 parameters describedcmo.so's library of goal-led marketing prompts (a senior CMO's routine): ready-to-run requests for any time, daily, weekly, monthly and quarterly, general ones for every business plus ones for each industry. Each has its goal, what you get, minutes, channels it needs, what waits for approval and the full text, which names the tools to use. Use it when the user asks how to use cmo.so, what to do today / this week / this month, or for a marketing routine or playbook; run a prompt's steps for them or build their playbook with playbook_save. With no industry: the general prompts and the industry ids.
playbooks_list1 of 1 parameter describedThe user's marketing playbooks on cmo.so/prompts (their own routine of prompts by rhythm): title, number of prompts, industry, link.
playbook_get2 of 2 parameters describedOne playbook in full (id from playbooks_list or a cmo.so/prompts/playbook/<id> link): the business it is for and each prompt by rhythm with its text (blanks filled with the playbook's details) and why it is there. Use it to run the user's routine: 'do my daily', 'what's on my weekly list'.
playbook_save9 of 9 parameters describedSave a marketing playbook to the user's cmo.so account (cmo.so/prompts/playbook/<id>, which they can open, edit, print and share): prompts from prompts_library by prompt_id, and/or their own prompts (title, frequency and text). Pick 2-4 per rhythm for their business with a one-line why each, and fill details (business, city, offer, audience, competitor, season) from what you know. Show the plan first and save only after they agree. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_page_markup_get3 of 3 parameters describedA page's full block markup (Gutenberg), for coding agents that edit blocks directly; with section, only that section's markup. Pair with wp_page_markup_set or wp_section_update markup.
wp_page_markup_set7 of 7 parameters describedReplace a page's whole content with block markup a coding agent wrote (Gutenberg blocks, Maggie Core classes and Tailwind classes allowed; PHP never). Read it first with wp_page_markup_get and pass its modified as expect_modified. preview shows the sections before and after without saving. wp_page_undo goes back. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_posts_list5 of 5 parameters describedBlog posts on the site (newest first): id, title, path, status, date, categories and tags. Search words, status, category.
wp_post_get2 of 2 parameters describedOne blog post in full: title, slug, status, dates, categories, tags, featured image, excerpt, SEO fields and its content (block markup or HTML).
wp_post_save10 of 16 parameters describedCreate a blog post (no post id) or change one (post id): title, content (block markup or HTML), excerpt, slug (a published post's old address gets a 301), status (draft, publish, private, future with date), date, categories and tags (names; new ones are created), featured_media, SEO title/description. New posts are drafts unless status says otherwise. CMO.so's blog autopilot keeps writing its own posts; this is for the owner's own changes. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_post_delete5 of 5 parameters describedMove a blog post to the WordPress trash (restorable for 30 days) and redirect its address (301) to another page, by default the blog list or the homepage. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_terms_list2 of 3 parameters describedThe blog's categories or tags: id, name, slug, description, post count.
wp_term_save6 of 9 parameters describedCreate a category or tag (no id) or change one (id): name, slug, description, parent (categories). The theme shows the description on its archive page. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_term_delete5 of 5 parameters describedDelete a category or tag by id. Posts keep their other terms; posts left without a category go to the default category, which can't be deleted. Terms have no trash: the result gives name, slug and description to recreate it with wp_term_save. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_settings_get1 of 1 parameter describedThe site's general settings: title, tagline, search-engine visibility, language, timezone, date and time formats, start of week, posts per page, homepage and posts page, logo and icon.
wp_settings_set13 of 13 parameters describedChange the site's general settings: title, tagline (description), search_engines (true = let Google index the site, false = discourage it), timezone (e.g. Europe/London), date_format, time_format, start_of_week (0 Sunday … 6), posts_per_page, site_logo and site_icon (media ids). Returns before and after. Homepage and posts page: wp_site_home_set. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_plugins_list1 of 1 parameter describedThe site's plugins: name, version, active or not, and whether an update is waiting.
wp_plugin_set6 of 6 parameters describedInstall a plugin from WordPress.org by its slug (e.g. wpforms-lite), and/or activate, deactivate or delete an installed one (plugin id from wp_plugins_list, e.g. akismet/akismet; only an inactive plugin can be deleted, and its settings may go with it). Installing runs the plugin's code on the site: only well-known plugins the owner asked for. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_api_read3 of 3 parameters describedRead any WordPress REST route the site builder may use (GET only), for coding agents exploring a site: e.g. /wp/v2/types, /wp/v2/taxonomies, /wp/v2/templates, /wp/v2/block-patterns/patterns, /wp/v2/global-styles/themes/maggie-core, /maggie-core/v1/site. Results are trimmed to 60 items.
wp_developer_mode1 of 1 parameter describedDeveloper mode on this website: who has it, until when, and which changes it covers. While it is on for you, the website-building tools (pages, sections, header, footer, menu, styles, child theme, guides, SEO, settings, posts) run at once without a preview; deleting, plugins, theme updates, emails, bookings and payments still ask. Someone who manages API access switches it on (wp_developer_mode_set or the app: Website → WordPress site builder → Developer mode).
wp_developer_mode_set8 of 8 parameters describedSwitch developer mode on (for yourself or a team member with Maggie write access, for 1 hour to 30 days) or off. Needs API-access management rights on the website. Always previewed: developer mode never covers itself. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_dev_live2 of 2 parameters describedThe live view of a page: open the link and the page reloads by itself a moment after each change (Maggie Core 0.22+), keeping the scroll position. Give the developer this link when they start building.
wp_live_edit_link2 of 2 parameters describedThe live editor for a page of the website (Maggie Core 0.48+ for pages moved onto Maggie Core; 0.49+ also block pages, the moved blog and the header and footer): wp-admin → Maggie → Edit page shows the page itself; an administrator clicks a heading, text, link or picture, types or picks a new one, can set its size, weight and colour, and saves. The change is live at once and can be undone there. Prices, treatment lists and the footer credit stay locked. Give the owner this link when they want to change a few words themselves.
wp_live_edit_elements5 of 5 parameters describedWhat can be edited on one page with the live editor (Maggie Core 0.50+): every heading, text, link, picture, background picture, icon, video and placeholder on it, each with its key, its text and values, where it lives (page content, header, a shared part, a blog template …) and whether it is locked (prices, catalogue lists, the footer credit). Filter with q (words on it) or kind. Use the key with wp_live_edit_set. When the owner is in the live editor, their message says which page and element they have selected.
wp_live_edit_set12 of 12 parameters describedChange one element of a page through the live editor (Maggie Core 0.50+), by its key from wp_live_edit_elements: text (plain), html (text with <strong>/<em>/<a>), attrs (href, src, alt, title, bg for a background picture, poster, placeholder, iconclass for an icon font such as fa-envelope, icon for a new inline SVG icon) and/or style (font-size, font-weight, line-height, letter-spacing, text-transform, color; on moved pages also text-align and opacity; '' removes one). Only that element's bytes change; it is live at once and can be undone (wp_live_edit_undo). everywhere: a header or footer change also goes to every other page's copy. preview: only show the element before and after. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_live_edit_undo6 of 6 parameters describedUndo a live editor change (Maggie Core 0.50+): the part it was made in goes back to before it. entry is the change's id (wp_live_edit_set's entry.id, or the log in wp_live_edit_elements). If the part changed again since, force also undoes the later changes. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_security_scan3 of 3 parameters describedSecurity check of the connected WordPress site: plugins, themes and WordPress against known vulnerabilities (WPVulnerability), available updates and plugins closed on WordPress.org; with Maggie Core 0.14+ also PHP/database end of life, risky settings (errors shown, open registration, file editing, XML-RPC), Administrators and old application passwords, and WP-Cron jobs (late, or left by removed plugins); from outside: security headers, public .env/.git/config backups/error logs, login-name leaks. Findings are ranked p0 (fix today) … p4 (for information), each with why and the fix (a tool when one can do it). Read-only.
wp_plugin_update4 of 4 parameters describedUpdate one installed plugin to its latest version (plugin id from wp_plugins_list or wp_security_scan, e.g. wpforms-lite/wpforms), then check the homepage still opens. Needs Maggie Core 0.14+. WordPress keeps no copy of the old version: for a big plugin (shop, page builder) suggest a backup first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_cron_unschedule4 of 4 parameters describedRemove a WP-Cron job that nothing runs any more (left by a removed plugin; wp_security_scan lists them). WordPress's own jobs and jobs a plugin still handles are refused. Needs Maggie Core 0.14+. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_seo_tech_audit3 of 3 parameters describedTechnical SEO check of the connected site, like a crawler: robots.txt (sitemap line, Google or AI crawlers blocked), the sitemap and every page it lists (status, redirects, noindex in the sitemap, canonicals pointing elsewhere, H1 count, missing or duplicate titles and descriptions, long titles, pictures without alt text, broken structured data, thin pages), broken and redirected internal links, generic link words, llms.txt; speed: true adds Core Web Vitals for the homepage (PageSpeed Insights: real visitors when Google has them, else the median of three lab runs). Findings ranked p0…p4 with the fix and a tool when one can do it. Read-only. Internal-link layout: wp_internal_links_plan.
wp_internal_links_plan2 of 2 parameters describedPlan the site's internal links from its own pages, articles, menu, header and footer: menu items that lead nowhere, main pages missing from the menu, legal/contact/about pages missing from the footer, hub pages that don't list their sub-pages and sub-pages that don't link back, articles that don't link to the page they are about (matched by topic) and pages that don't show their articles, and pages or articles nothing links to. Returns actions ready for wp_internal_links_apply (page_related, post_link) or wp_menu_set / wp_footer_set. Read-only.
wp_internal_links_apply5 of 5 parameters describedApply internal-link actions from wp_internal_links_plan: page_related puts a "Related" band (heading + list of links) in a page, replacing its own earlier band with the same heading, placed before a closing call-to-action; post_link adds one "Related: <page>" line at the end of an article (replacing its earlier one). preview: true shows the changes and saves nothing. Pages: wp_page_undo; articles: their revisions. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_llms_txt_get1 of 1 parameter describedThe site's llms.txt (a Markdown map of the site for AI assistants, served at /llms.txt): the saved text, whether /llms.txt answers, and whether a file on the server overrides it. Needs Maggie Core 0.14+.
wp_llms_txt_set7 of 7 parameters describedWrite the site's llms.txt (served at /llms.txt): generate: true builds it from the site (name and summary, pages with their SEO descriptions grouped under their parents, the latest articles, sitemap); or give text (Markdown); "" turns it off. preview: true returns the text without saving. Needs Maggie Core 0.14+. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_site_connect_link1 of 1 parameter describedThe link to the cmo.so app's form where the owner saves the WordPress site's Administrator application password for the site builder (wp_* tools). Use it when a wp_ tool says the site isn't connected or the login isn't an Administrator. Never ask for the password in chat.
wp_site_status1 of 1 parameter describedThe website's WordPress: whether cmo.so can build on it (Administrator login, Maggie Core theme and version, child theme), who outputs SEO, the forms, synced patterns, booking link and phone, page templates, the child theme's guides for agents (DESIGN.md, AGENTS.md, MEMORY.md: follow them), and what_to_use: which wp_* tools answer translations, the booking menu and its Fresha sync, bookings, shop, payments, posts, pages, SEO and the owner's screens on this site, with each module's state. Call first in any website conversation.
wp_site_map2 of 2 parameters describedEvery page of the site as a tree: path, title, template, status, SEO fields filled; with sections: true also each page's section types and FAQ count (slower).
wp_pages_list6 of 6 parameters describedFind pages: by words in the title, status, parent, template, or those missing an SEO title/description.
wp_page_get3 of 3 parameters describedOne page: title, path, status, template, SEO fields and its sections in order (id, type, heading, summary, buttons, pictures, FAQ questions). Section ids: m… full-width bands, s… the reading column, a… the sidebar. Give section to get that one in full (all FAQ answers, all text).
wp_section_library1 of 1 parameter describedThe section types a Maggie Core page is built from (hero, split, text, callout, packages, features, reviews, gallery, form, faq, cards, contact band, latest articles, booking card): what each is for, where it goes and the slots it takes; plus the page blueprints (service, location, promotion, plain).
wp_seo_get3 of 3 parameters describedA page's (or post's) SEO: the stored fields (title, description, keywords, robots, canonical, share picture, extra schema) and what the live page outputs now (title, description, robots, canonical, H1, structured-data types, FAQ count).
wp_seo_audit3 of 3 parameters describedCheck the whole site's SEO the way a crawler sees it: missing, long or duplicate titles and descriptions, H1 problems, noindex, canonicals pointing elsewhere, FAQ under 10, broken internal links, pages nothing links to, the sitemap. Opens every published page (takes a minute on big sites).
wp_redirects_list1 of 1 parameter describedThe site's redirects (old path → new path, 301/302/307, or 410 gone).
wp_menu_get2 of 2 parameters describedThe header menu as a tree of items (label, link, sub-items).
wp_part_get2 of 2 parameters describedWhat the header or footer holds: its buttons (Book Now), links, texts, social icons, logo, menu, and whether the site has customised it.
wp_style_get1 of 1 parameter describedThe site's look: colours (by name: canvas, panel, soft, ink, muted, olive, accent…), fonts (display, body), layout widths (content, wide) and page padding, the extra CSS, and the text contrast of each colour pair.
wp_page_create15 of 15 parameters describedCreate a page from sections (or a blueprint's order with your content). Saved as a draft unless status is publish. Sets slug, parent, SEO and can add it to the menu. Write every word from the business's real facts; ask for prices, addresses and claims you don't have. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_page_update12 of 12 parameters describedChange a page's title, slug (a 301 from the old address is added), parent, template, featured picture, order or status (draft/publish/private). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_page_publish6 of 6 parameters describedPublish a page (a draft or private page) so visitors and search engines see it. Checks it first: one H1, an SEO title and description (warns when missing). homepage: true also makes it the site's homepage. Afterwards the live page is opened to confirm it works. To take it down again, wp_page_update status draft. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_site_home_set6 of 6 parameters describedChoose the site's homepage (a published page) and, optionally, the page that lists the blog posts. Returns the previous setting so it can be put back. latest_posts: true shows the newest posts as the homepage instead. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_page_delete5 of 5 parameters describedMove a page to the WordPress trash (restorable for 30 days) and redirect its address (301) to another page, by default its parent or the homepage. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_page_duplicate8 of 8 parameters describedCopy a page (e.g. the same service for another city) as a draft with a new title and slug, changing words you list (city names…). Rewrite the copy's text afterwards: near-identical pages compete with each other in Google. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_page_undo4 of 4 parameters describedPut a page's content back to the version before its last change (WordPress keeps every version). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_section_add12 of 12 parameters describedAdd a section to a page (types and slots: wp_section_library), at a position: after/before another section or an index in a region. Story types (split, text, callout, packages, features, reviews, gallery, form) go in the reading column; faq, cards, map-contact, post-grid are full-width bands. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_section_update13 of 13 parameters describedChange one section. width: line its content up with the header and footer ("wide") or another width, one section or all. edits: change text, links or pictures inside it and keep its design (works on any section, the homepage too). slots: write the section again from new content (generated types; give the complete content). faq: add, remove (1-based numbers) or replace questions. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_section_move11 of 11 parameters describedMove a section to another position (after/before another section, or an index in a region). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_section_remove7 of 7 parameters describedRemove a section from a page (wp_page_undo brings it back). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_pattern_update5 of 5 parameters describedChange a synced pattern used by many pages at once (the contact band, share buttons, quote form): text, links or pictures. Every page that shows it changes. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_preview3 of 3 parameters describedShow what a page change would do without saving it: the sections before and after. Works with wp_page_create, wp_section_add, wp_section_update, wp_section_move and wp_section_remove (pass that tool's name and arguments).
wp_media_upload9 of 9 parameters describedPut a picture in the WordPress site's media library: a picture from this chat (file) or a public https link to an image (url). JPEG, PNG, WebP, GIF or AVIF, up to 15 MB; checked as a real image. Give alt text that says what the picture shows. Returns its id and source_url; then use the url in a section (wp_section_update edits.images, or slots image) or as a page's featured_media. Doesn't change any page by itself. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_media_list3 of 3 parameters describedPictures already in the WordPress media library (newest first), with id, link, alt text and size; search by words in the title or file name.
wp_child_theme_status2 of 2 parameters describedThe site's Maggie child themes (Maggie Core is the parent): which is active, their files and backups, and whether files can be written on this host. With slug: that child's text files in full (theme.json, style.css, parts, patterns) to read before changing them.
wp_child_theme_create7 of 7 parameters describedCreate a child theme of Maggie Core for this site (slug maggie-<name>), by default from the site's current look: its Global Styles (colours, fonts with their files, styles), edited header and footer. Data files only, never code. activate: true switches the site to it and checks the homepage looks the same. Switching keeps the look only because it is copied into the child; Global Styles and edited parts are kept per theme in WordPress. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_child_theme_update19 of 19 parameters describedChange a Maggie child theme's files (default: the active child): brand colours (by name, hex) and fonts (by name, CSS font-family of fonts already in it) in theme.json, extra theme.json styles, plain CSS (replace or append), the site's own JavaScript (assets/js/site.js, replace or append; runs for every visitor), the child's own Tailwind CSS (tailwind/child.css: extra @theme tokens, @utility rules; Maggie Press and the native build import it after Maggie Core's bridge; needs Maggie Core 0.20+), the header or footer (block markup), templates, and the site's own patterns (shown in the editor's inserter). No PHP or server code. Each change keeps a backup (wp_child_theme_restore). Changes made with wp_style_set / wp_header_set are stored in the database and win over the child's files. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_site_guides_get2 of 2 parameters describedThe child theme's guides for agents in full: DESIGN.md (the site's look and the owner's design rules), AGENTS.md (how agents work on this site, what not to touch) and MEMORY.md (the owner's preferences and don'ts). Follow them; they never replace the preview-and-yes step or the safety rules.
wp_site_guides_set9 of 9 parameters describedWrite the child theme's guides (Markdown): design_md, agents_md, memory_md replace a file; refresh_design rewrites DESIGN.md from the live site (colours, fonts, widths, padding, homepage sections) and keeps its "## Rules" section; init writes the missing files from templates. Files are public on the site, so passwords, keys and tokens are refused. Backups as for every child file (wp_child_theme_restore). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_site_memory_add6 of 6 parameters describedRemember something the owner said about this website in the child theme's MEMORY.md, dated, newest first: kind prefer (a preference: "short headlines"), avoid (a don't: "never use stock photos of people") or note. Use it whenever the owner states a lasting preference or a don't. Public file: no passwords, keys or personal details. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_child_theme_activate4 of 4 parameters describedSwitch the site to a Maggie child theme, or back to Maggie Core (slug maggie-core). Checks the homepage before and after (words, fonts, brand colours) and reports differences. WordPress keeps Global Styles and edited header/footer per theme: a child made with wp_child_theme_create from the site carries them; switching back to Maggie Core brings its own back. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_child_theme_restore5 of 5 parameters describedPut a child theme's files back as they were before one change (backup ids from wp_child_theme_status). The current files are backed up first, so a restore can be undone too. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_theme_updates1 of 1 parameter describedIs there a newer Maggie Core for this site? The installed and latest versions, release notes link, whether this host lets it update itself, auto-updates on or off, and the earlier versions kept for rollback.
wp_theme_update4 of 4 parameters describedUpdate Maggie Core on the site to the latest version (checked against its published checksum; the current version is kept for rollback), then compare the homepage before and after (words, fonts, brand colours). If the site breaks (an error page or most of the homepage gone) it rolls back by itself. rollback_to puts an earlier kept version back instead. The site's look lives in the database and its child theme, so an update doesn't change it. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_seo_set13 of 13 parameters describedSet SEO fields on one page (page + fields) or up to 50 at once (items). Shows before → after; warns on long titles/descriptions and noindex. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_seo_site_set5 of 7 parameters describedSite-wide SEO: the homepage title and description, the title separator, and the default share picture. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_redirect_set5 of 5 parameters describedAdd or change redirects (old path → new path; 301 permanent by default, 302/307 temporary, 410 gone) or remove them. Chains are shortened automatically. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_seo_import4 of 4 parameters describedCopy the SEO plugin's stored values (Rank Math: titles, descriptions, keywords, robots, canonicals, schema, redirects, separator, business) into Maggie's fields, so the plugin can be switched off without losing anything. Keeps values already set unless overwrite. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_business_set4 of 4 parameters describedThe business details used for LocalBusiness structured data: type, name, telephone, email, street, city, region, postal_code, country, latitude, longitude, price_range, opening_hours, same_as, logo, image. opening_hours like ["Mo-Fr 10:00-19:00","Sa 10:00-17:00"]; same_as = social profile URLs. Only real facts. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_menu_set10 of 10 parameters describedChange the header menu: add items (under a parent label), remove, rename, relink, move; or replace the whole tree with items. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_header_set9 of 9 parameters describedChange the header: its main button (Book Now) text and link, transparent-over-hero on/off, or any text, link or picture in it; reset goes back to the theme's own header. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_footer_set9 of 9 parameters describedChange the footer: any text (address, hours, copyright), link or picture, social profile links by service, the row of page links (footer_links); reset goes back to the theme's own footer. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_style_set9 of 9 parameters describedChange the whole site's look: brand colours (by name, hex), fonts (by name, CSS font-family), layout widths (content: the width sections and text use; wide: the header, footer and wide blocks), the left and right page padding, and extra CSS. Saved in the site's Global Styles (works on any block theme; returns before and after). Refuses colours that would make text hard to read (contrast under 4.5:1). One section's width: wp_section_update width. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_element_undo5 of 5 parameters describedUndo the last change to the header, footer, menu or the site's styles (colours, fonts, widths, extra CSS): puts back the version WordPress saved before it. A header or footer changed only once goes back to the theme's own. Pages have wp_page_undo; child-theme files wp_child_theme_restore. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_css_build4 of 4 parameters describedRebuild the site's compiled Tailwind CSS (Maggie Press) on the server, exactly like Maggie Press's build in wp-admin, and store it. The tools do this by themselves about 30 seconds after they change pages, sections, articles, the header, footer, menu or child theme; run it to rebuild now or to see the last result. Sites whose Tailwind setup loads plugins, CDN files or extra sources are refused (build those in wp-admin). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_status1 of 1 parameter describedOnline booking on the connected WordPress site (Maggie Booking in the Maggie Core theme): whether it is on, today's appointments, upcoming count, this week's takings, the setup checklist (hours, treatments, team, payments, Book page, gift cards) and whether online payment (Stripe) is ready. Read-only. Stripe is the website's one account, set up by the owner in wp-admin → Maggie Press → Payments (Bookings → Payments before Maggie Core 0.40; never ask for keys; wp_payments_status / wp_payments).
wp_booking_turn_on4 of 4 parameters describedSwitch online booking on (creates its tables, a Book page, one team member and Mon–Sat 10–18 hours to start from) or off (enabled false: the Bookings dashboard stays, nothing is deleted). To only pause visitors' online booking, use wp_booking_settings_set online_open false. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_appointments7 of 7 parameters describedAppointments: one booking by id (with customer, items, payments, history), or a list filtered by status (held, pending, confirmed, arrived, completed, cancelled, no_show, expired), date range (from/to, Y-m-d, venue time) and search (name, email, reference). Read-only.
wp_booking_availability4 of 4 parameters describedFree start times on a date for one or more treatments (the business's view: no lead-time limit). Use before wp_booking_create or a move. Read-only.
wp_booking_create12 of 12 parameters describedBook an appointment for a customer (as the business): treatments, date and time (venue time), optional team member, the customer (existing customer_id, or name + email/phone), notes and how they pay (venue, deposit, full). force books even if the time looks taken (double booking). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_change14 of 14 parameters describedChange one booking: action status (arrived, completed, no_show, confirmed), notes, cancel (by the business: everything paid is refunded; the customer is emailed), reschedule (new date + time, optional staff_id, force) or refund (payment_id and amount in minor units, e.g. 2500 = 25.00). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_list5 of 5 parameters describedRead the booking set-up and records. resource: services (treatments with options (name, duration_minutes, price_minor), rules and who does them); categories (menu categories); staff (team: services, weekly hours, own prices); time-off (time off and closures (staff_id 0 = whole business)); resources (rooms / equipment a treatment needs); locations (locations (timezone, currency, address)); customers (customers (search=…), id → history); vouchers (gift cards for sale); voucher-codes (issued gift card codes (search by last 4, buyer)); addon-groups (add-on groups (extras with price and minutes) linked to services); promos (discount codes and last-minute deals); bundles (packages: treatments back to back at one price); price-rules (peak / off-peak price changes by weekday and time); pricing (everything about add-ons, deals, packages and rules at once); forms (intake / consultation forms linked to services); reviews (reviews (approve, hide, reply)); waitlist (waitlist entries); payments (payments and refunds); settings (booking rules, location, languages (change with wp_booking_settings_set)); imports (import history (undo with wp_booking_import undo_id)); products (products sold at the till (with Maggie Shop on these are the shop's variants: manage the catalogue, orders and stock with wp_shop_*)); sales (till sales (items, payments, refunds); search, id → one sale); plans (prepaid packages and membership plans for sale); memberships (customers' memberships (pause, cancel… with wp_booking_membership)); loyalty (loyalty programme settings and points); campaigns (email campaigns (subject, body, button, segment) — send with wp_booking_campaign_send); automations (automated emails: we miss you, time to rebook, birthday); messages (conversations with customers; id = customer id → the thread); portfolio (portfolio photos of finished work (image_id, staff_id, service_id, caption)); form-responses (customers' answers to intake / consultation forms). id for one item, search for customers / codes. Money is in minor units (8000 = 80.00). Read-only.
wp_booking_save7 of 7 parameters describedCreate, change or delete one booking set-up item. resource: services, categories, staff, time-off, resources, locations, customers, vouchers, addon-groups, promos, bundles, price-rules, forms, reviews, waitlist, products, plans, campaigns, portfolio. Without id: create; with id: change (send only the fields to change; a service's variants array replaces its options — keep their ids); delete true: remove (services, team and options used by past bookings are archived, not deleted). Read the item with wp_booking_list first to see its fields. Money in minor units. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_settings_set6 of 6 parameters describedChange booking settings: settings {online_open, slot_minutes, lead_minutes, horizon_days, hold_minutes, cancel_window_hours, default_payment (venue|deposit|full|card), deposit_percent, deposit_min_minor, no_show_fee_percent, auto_confirm, assignment_mode (balance|priority|turns), gap_rule (off|reduce|eliminate), allow_staff_choice, languages (extra content languages, e.g. ["zh-hans","es"]), notify_email, customer_note, terms, reminder_hours, gift_cards_enabled}, location {name, address, phone, email, timezone, currency} and/or business hours [{weekday 0=Mon…6, start HH:MM, end HH:MM, week_slot null|0|1}] (replaces all business hours). Read the current values with wp_booking_list resource settings. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_import_preview6 of 6 parameters describedPreview bringing data from another booking system, nothing saved: source fresha (the venue's public Fresha page URL: treatments, options, prices), json (a catalogue JSON from another provider's export: Treatwell, Booksy, Square, Vagaro…) or csv (kind clients | appointments | gift_cards, the CSV text). Shows what would be added, updated, withdrawn or skipped. Then wp_booking_import.
wp_booking_import9 of 9 parameters describedImport from another booking system after wp_booking_import_preview (same arguments), or undo an earlier import (undo_id from wp_booking_list resource imports). Re-running a Fresha import later syncs changes; the owner's own edits are kept. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_gift_card16 of 16 parameters describedGift cards: lookup (code → status, balance), issue (by hand: voucher_id of a gift card for sale or value_minor, recipient and buyer names/emails, message, send_email; the code is shown once), redeem (code id + amount_minor), void (code id). List cards for sale and issued codes with wp_booking_list resource vouchers / voucher-codes. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_reports5 of 5 parameters describedBusiness reports for a date range (from/to Y-m-d, venue time; group day | week | month): revenue (bookings and till sales), bookings by status, no-show rate, by treatment, by team member, by channel, new vs returning customers, gift cards sold vs redeemed. team_pay true: each team member's pay (commission on treatments, products and tips plus hourly pay). Read-only.
wp_booking_message6 of 6 parameters describedSend a customer a message from the business (customer id from wp_booking_list resource customers): they get it by email (and text when SMS is on) with a link to reply; replies show in wp_booking_list resource messages id=<customer id>. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_campaign_send6 of 6 parameters describedSend (or schedule with at, ISO time) an email campaign saved with wp_booking_save resource campaigns. Only customers who agreed to marketing emails get it, each with an unsubscribe link. Check the audience first: wp_booking_list resource campaigns id=<id>. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_membership8 of 8 parameters describedChange a customer's membership (id from wp_booking_list resource memberships): pause, resume, cancel (at the end of the period), cancel_now, add_sessions (sessions), add_credit (amount_minor), mark_paid (a renewal paid at the desk) or charge (retry the renewal on the saved card). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_translate7 of 7 parameters describedRead or write the translations of booking content (type service | variant | category | staff | voucher, id, lang such as zh-hans or es; fields name, description). Without fields: read. The site's extra languages are set with wp_booking_settings_set settings.languages. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_routes2 of 2 parameters describedEvery Maggie Booking admin route on the site (the whole wp-admin → Bookings dashboard: calendar, till, team, roles, clock, pay runs, goals, stock, finance, loyalty, automations, upsells, safety, client files…): path under /admin, methods, arguments, and owner_only for the payment / SMS / card set-up that only the owner does in wp-admin. filter: text to match in the path. Use with wp_booking_get and wp_booking_post for anything the other wp_booking_* tools don't cover. Read-only.
wp_booking_get3 of 3 parameters describedRead any Maggie Booking admin route (GET path under /admin, e.g. /overview, /sales/today, /sales/close?date=, /team/members, /clock, /pay-runs, /goals, /stock, /loyalty, /automations/rebook, /upsells, /patch-tests, /customers/12/wallet, /finance/accounts, /tools/settings) with an optional query. Find paths with wp_booking_routes. Money in minor units. Read-only.
wp_booking_post6 of 6 parameters describedChange anything in the Maggie Booking dashboard that the other wp_booking_* tools don't cover: method POST | PATCH | DELETE, path under /admin (from wp_booking_routes), body. Examples: team roles and permissions (/team/roles), clock in/out (/clock), pay runs (/pay-runs), goals (/goals), stock moves (/stock), loyalty programme (/loyalty), automated emails (/automations/{kind}), upsells (/upsells), patch tests (/patch-tests), client files (/customers/{id}/files), finance accounts (/finance/accounts), AI polish (/ai/polish), tool settings (/tools/settings), till settings (/sales/settings). Read the item first with wp_booking_get. Refused: owner_only routes (payment, card reader, saved card, SMS and PIN set-up) and charging a saved card. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_till20 of 20 parameters describedThe till (point of sale): action start (new sale: customer_id, items, note) | from_booking (booking_id → its sale with treatments and what was already paid) | items (sale id, items [{kind service|product|gift_card|custom, service_id, variant_id, product_id, name, quantity, unit_minor, staff_id}], discount, tips — replaces the lines) | pay (sale id, method cash|card_reader|gift_card|credit|pay_link|other, amount_minor (default: what is due), tendered_minor for cash, reference) | close (sale id) | receipt (sale id, email) | refund (sale id, all true or payments [{id, amount_minor}], reason, restock) | void (sale id, reason). Read sales with wp_booking_list resource sales and today's takings with wp_booking_daily_close. A saved card is never charged by an agent. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_daily_close2 of 2 parameters describedThe day's till close (end-of-day report): takings by payment method, cash expected in the drawer, refunds, tips, open sales still to settle. date (Y-m-d, venue time; default today). Read-only.
wp_booking_blocks1 of 1 parameter describedThe booking blocks visitors see (services menu, Book button, team, gift cards and balance check, manage booking, reviews, my bookings, products, plans and memberships, portfolio, AI receptionist chat) with their attributes, the Book page, booking links (#book, #book:<service_id>:<variant_id>) and the current visitor design. Use before wp_booking_page, wp_booking_design or adding a block to a page with wp_section_add / wp_page_markup_set. Read-only.
wp_booking_page10 of 10 parameters describedMake or rebuild a booking page from sections, in the theme's full width (template page-wide): sections in order, each { heading, text } (a heading and/or a paragraph) or { block, attrs } with a booking block from wp_booking_blocks (e.g. booking-services {layout: cards, category}, booking-team, gift-cards, gift-card-check, plans {kind}, portfolio, booking-reviews, my-bookings, products, booking-manage). page_id: rebuild that page (it keeps its address; the earlier version stays in revisions); else a new page (title, slug). book_page true: make it the page the booking links open. status draft (default) or publish. preview true: show the markup only. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_email_status1 of 1 parameter describedThe website's email (Maggie Core 0.21+): whether every email of the site goes through the owner's own Resend account, the sender address, its domain in Resend (verified or the DNS records still to add), and the email templates in Resend (one per kind of email: in Resend, edited there (kept), outdated, or missing). The Resend key is entered by the owner in wp-admin only: give them setup_url, never ask for the key.
wp_email5 of 5 parameters describedLook after the website's email through Resend (Maggie Core 0.21+, once the owner added the key in wp-admin): action templates (make or update the templates in their Resend account; ones edited in Resend are kept), reset_templates (put Maggie's design back on all of them), add_domain (add the sender's domain to Resend and get its DNS records), dns_cloudflare (a Cloudflare sign-in link that adds those records for them; give it to the owner), test (send a test email to `to`). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_payments_status1 of 1 parameter describedHow the website takes card payments (Maggie Core Payments: one Stripe account for bookings and the shop): Connect with Stripe through cmo.so (test and live: connected account, whether the website has it), or the owner's own Stripe keys (set, webhook set up), whether payments are ready, which modules use it, the account at Stripe (can take payments, pays out, balance, latest payouts) and recent payments. Setting keys is the owner's, in wp-admin → Maggie Press → Payments (setup_url); connecting Stripe needs no key at all: wp_payments action connect.
wp_payments5 of 5 parameters describedCard payments for the website (Maggie Core Payments: one Stripe account for bookings and the shop). action connect: the Stripe sign-in link (mode live or test) that connects the owner's own Stripe account through cmo.so; give it to the owner, who signs in and picks their account; payments then go straight into it and nothing is copied. sync: send the connection to the website again. disconnect: revoke it (mode). webhook: set the Stripe webhook up again when the owner uses their own keys. Never ask for Stripe keys. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_design5 of 5 parameters describedThe look of the booking blocks, booking sheet, gift cards, plans and account pages for visitors (Maggie Core 0.20.1+): design { accent, accent_deep, ink, muted, line, surface, panel (hex colours), radius 0-40 (px, cards and sheet), button_radius 0-99 (px), density comfortable | compact }. Send only what changes; reset true goes back to the theme's colours. Without design or reset: read the current design. The footer credit is not part of it. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_bridge1 of 1 parameter describedMoving a business from another booking platform (Fresha, or Treatwell, Booksy, Square, Vagaro through a catalogue JSON) to Maggie Booking while both run: the platform and sync mode (off | review | auto), the last sync and changes waiting for review (added, changed, withdrawn services), every service with where it books now (maggie or external: the platform's own booking link), its mode (auto | maggie | external) and why it isn't ready on Maggie yet (not online, no option, no team member, no hours), each team member's platform calendar feed (busy times read every 15 minutes) and whether they have a Maggie calendar link, what to change on the platform by hand (it has no API), and the cut-over checklist (services, team hours, payments, clients, appointments, gift cards, Google booking link, "we've moved" email, platform off). Nothing changes until a bridge is set up. Read-only.
wp_booking_bridge_set11 of 11 parameters describedSet up or change the booking bridge: provider (fresha | json), source (the Fresha venue address, or the catalogue JSON address), sync (off | review: changes wait for approval | auto: applied daily), modes {service id: auto (Maggie when ready, else the platform link) | maggie (books on Maggie; the platform no longer changes or withdraws it) | external (the platform's link)}, feed {staff_id, url} (one team member's platform calendar export, https or webcal; url '' removes it and its busy times) or feeds [{staff_id, url}] (the whole list), checklist {step: true | false} (tick manual steps: payments, google_link, moved_email…), calendar_link_for (a team member id: a new private Maggie calendar link for the platform to subscribe to; the old link stops). Clients, appointments and gift cards come in with wp_booking_import. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_bridge_sync4 of 4 parameters describedRead the platform's catalogue now: action run (review mode keeps the changes waiting; auto applies them), approve (apply the waiting changes: new services added, changed fields updated where the owner hasn't edited them, gone services withdrawn — never deleted; services switched to Maggie are left alone), dismiss (drop the waiting changes), feeds (read every team member's platform calendar now). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_booking_bridge_end3 of 3 parameters describedEnd the move: every service books on Maggie, the platform sync stops and its calendars' busy times are removed. Do it once the platform is no longer taking bookings (the checklist's last step). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_shop_status1 of 1 parameter describedThe online shop on the connected WordPress site (Maggie Shop in the Maggie Core theme): whether it is on, today's and this week's sales, orders to fulfil and on hold, low stock, pending reviews, abandoned carts, the set-up checklist, recent orders, how customers can pay and the shop's addresses (/shop/, cart, checkout). Read-only. Card payments use the website's Stripe account (wp-admin → Maggie Press → Payments, shared with bookings; wp_payments_status / wp_payments; never ask for keys).
wp_shop_feed1 of 1 parameter describedThe shop's Google Merchant Center product feed (Maggie Core 0.26+): its address (https://site/shop/feed/google.xml, public, for Merchant Center to fetch daily), whether it is on, how many items (one per variant) and products it lists, the countries it gives delivery prices for, products left out because they are marked never promote (sales_signal_mark), and what Google would refuse (errors: no price, no picture — left out) or warn about (no brand, a barcode that isn't a valid GTIN, no delivery price, the shop's currency differs from a target country's). The feed has each variant's own link (?variant=id opens it chosen), the sale price when it is below its compare-at price, availability from stock, the barcode as GTIN, the brand (or the shop's name), product type from its category, weight, and tax added where Google expects tax-inclusive prices. Next: the owner adds the address in Merchant Center (Products → Add products → From a file → Add a file from a link, fetch daily); fix what it reports with wp_shop_product_save. Read-only.
wp_shop_feed_set6 of 6 parameters describedChange the Google product feed: enabled (false: the address answers 404), brand_fallback (true, default: the shop's name as brand for products without one — right for its own products; false for resellers), countries (two-letter codes the feed gives delivery prices for, from the shop's delivery zones; [] = the shop's country and every country a zone names, up to 25). Only the fields sent change. Answers with the feed's status (wp_shop_feed). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_shop_turn_on4 of 4 parameters describedSwitch the online shop on (creates its tables and the /shop/ pages; products Bookings already had move into the shop once and the till keeps selling them) or off (enabled false: visitors see no shop, nothing is deleted). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_shop_products10 of 10 parameters describedProducts: one by id (every field, options, variants with price, compare-at price, SKU, barcode, stock, reserved, low-stock level; categories; SEO; URL) or a list filtered by search (name, SKU, barcode, tag), status (all|active|draft|archived), category (id or slug), low (low stock only), till (sold at the till), sort (newest|name|price_asc|price_desc|best), page. Money in minor units (2500 = 25.00). Read-only.
wp_shop_product_save7 of 7 parameters describedCreate, change, duplicate or delete one product. Without id: create; with id: change (send only the fields to change); duplicate true: a draft copy; delete true: remove (a product that was sold or counted is archived, not deleted). data fields: name, slug, status (active|draft|archived), short_description, description (HTML), images [{url, alt, id?}] (first = main; upload pictures first with wp_media_upload), options [{name, values[]}] (up to 3, e.g. Size, Colour — they make the variants), variants [{id?, options[], price_minor, compare_minor, cost_minor, sku, barcode, track_stock, stock (new variants only: opening stock), low_stock, backorders, image_url, weight_grams, status}] (the array replaces the variants: keep existing ids; change stock of existing variants with wp_shop_stock), or for a product without options the variant fields at the top level (price_minor, compare_minor, sku, barcode, track_stock, opening_stock, low_stock, backorders), brand, tags [], tax_class (standard|reduced|zero), shipping_required, weight_grams, online (sold on the website), till (sold at the Bookings till), featured, category_ids [], seo_title, seo_description, sort_order. Read the product with wp_shop_products first. Money in minor units. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_shop_products_bulk6 of 6 parameters describedChange many products at once: ids [], action status (value active|draft|archived) | online | featured | till (value true|false) | add_category | remove_category (value category id) | price_percent (value e.g. -10 for 10% off every variant, 5 for +5%) | delete (archived when sold). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_shop_stock7 of 7 parameters describedChange one variant's stock (a product without options has one variant: its id is in wp_shop_products → variants[0].id): kind receive (a delivery, +quantity) | adjust (± with a reason in note: used, damaged, counted…) | set (a stock count: the stock is now quantity). Every change goes in the stock ledger. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_shop_orders9 of 9 parameters describedOrders: one by id (items, totals, customer, addresses, delivery, payment, tracking, timeline) or a list filtered by status (open = to fulfil + on hold, pending, on_hold, processing (to fulfil), shipped, completed, cancelled, refunded), payment (unpaid|paid|partially_refunded|refunded), search (order number, email, name, phone), email, from / to (Y-m-d), page. Read-only.
wp_shop_order6 of 6 parameters describedAct on one order (id from wp_shop_orders): action ship {carrier, number, url, notify (default true: the customer is emailed)} | status {status: processing|on_hold|shipped|completed} | paid (a bank transfer or pay-on-delivery order was paid) | cancel {reason, restock} (unpaid orders only; stock and coupon uses go back) | refund {amount_minor (default: everything left), items [{id: order item id, quantity}] to put back on the shelf, restock, reason} (card payments go back through Stripe; other methods are only recorded) | note {note, customer (true: also email it)} | edit {name, email, phone, shipping_address{}, billing_address{}} | sync (ask Stripe again about an unpaid card order). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_shop_list9 of 9 parameters describedRead the shop's other records. resource: categories (product categories (name, slug, parent_id, description, image_url)); coupons (coupons (code, type percent|fixed_cart|fixed_product|free_shipping, amount: percent or minor units, min/max spend, usage limits, products, categories, emails, dates)); reviews (product reviews (status approved|pending|hidden, reply); not created here); customers (customers from orders (orders, spent, last order); search); carts (abandoned carts with an email (remind with wp_shop_cart_remind)); reports (sales over days (net, orders, average, refunds, by day, best sellers, by payment method)); settings (shop settings, delivery zones, tax, payment methods, emails (change with wp_shop_settings_set)); payments (where card payments go (Stripe through Bookings or the shop's own key) and the methods on offer); inventory (every variant's stock, reserved, available and value; search, low); stock (the stock ledger (product_id or variant_id)); export (all products as a WooCommerce CSV). search / page where it applies; days for reports (7, 30, 90, 365); status for reviews. Money in minor units. Read-only.
wp_shop_save7 of 7 parameters describedCreate, change or delete one category or coupon, or moderate a review. resource: categories (product categories (name, slug, parent_id, description, image_url)); coupons (coupons (code, type percent|fixed_cart|fixed_product|free_shipping, amount: percent or minor units, min/max spend, usage limits, products, categories, emails, dates)); reviews (product reviews (status approved|pending|hidden, reply); not created here). Without id: create (not reviews); with id: change (only the fields to change); delete true: remove (a used coupon is archived). Money in minor units. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_shop_settings_set4 of 4 parameters describedChange shop settings (send only what changes): enabled, store_name, store_email, store_phone, address {line1, line2, city, state, postcode, country}, currency, base (address slug, default shop), shop_title, shop_intro, per_page, columns, sell_to [country codes], guest_checkout, require_phone, hold_minutes (stock kept for an unpaid card checkout), order_start, terms_url, returns_text, header_cart, floating_cart, reviews, reviews_verified, reviews_moderate, low_stock_email, accent (#rrggbb), tax {enabled, inclusive, shipping, label, rates [{country, state, rate, class standard|reduced|zero, name}] (replaces all)}, shipping {zones [{id, name, countries [], methods [{id, type flat|free|collect, label, amount_minor, min_minor (free over), per_item_minor, days}]}] (replaces all), rest [methods for everywhere else]}, payments {stripe|bacs|cod: {enabled, label, instructions}}, emails {order_customer, order_admin, shipped, refunded, admin_to}. Stripe keys are never set here (the owner adds them in wp-admin). Read the current values with wp_shop_list resource settings. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_shop_import6 of 6 parameters describedBring products in: csv (a WooCommerce product CSV export as text: simple and variable products with their variations, prices, sale prices, stock, categories, tags, pictures by URL; update true also updates products with the same SKU or name) or sample true (a few sample products so a new shop has something to show). Returns created, updated, skipped and errors per line. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_shop_cart_remind4 of 4 parameters describedEmail a reminder to someone who left items in their cart (id from wp_shop_list resource carts), with a link that brings the cart back. At most once a day per cart. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_shop_page9 of 9 parameters describedMake or rebuild a page that sells: sections in order, each { heading, text } or { block, attrs } with a shop block: shop-products {category (slug), limit, columns 2–5, sort featured|newest|best|price_asc|rating, featured, show_more}, shop-categories {top_only}, shop-cart-link {label}. The full shop is already at /shop/ (wp_shop_status shop_url); use this for a landing page, a collection or a home-page section. page_id: rebuild that page (the earlier version stays in revisions); else a new page (title, slug). status draft (default) or publish. preview true: markup only. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_languages1 of 1 parameter describedThe website's languages (Maggie Core 0.27+): the site's own language (bare addresses) and every other one with its address prefix (/zh/…), WordPress locale and hreflang tag; how many pages and posts each has translated, published, reviewed, stale (the source changed since) and indexable; the flags index_unreviewed (machine translations indexed before review; default false) and stale_noindex; the glossary. Each translation lives at the source's address with the prefix, has its own canonical and reciprocal hreflang with x-default, and only published, reviewed, fresh translations are indexed and in the sitemap. Next: wp_translations. Read-only.
wp_languages_set9 of 9 parameters describedChange the website's languages: languages [{code (zh-hans, zh-hant, es, fr…), prefix (the address segment, e.g. zh), locale (WordPress locale for interface text, e.g. zh_CN), hreflang (e.g. zh-Hans, or zh-Hans-US for one market), name (as visitors see it), enabled}] (the whole list; the site's own language is not in it), index_unreviewed, stale_noindex, default_hreflang, default_name, glossary [{source, <code>: translation, note}] (the whole list). A prefix can't be a page's address or a reserved path. Read wp_languages first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_translations8 of 8 parameters describedTranslations on the website. Pages and posts: with source_id and lang, the brief for one (title, block content, excerpt, SEO title and description; the current translation with stale and reviewed; the glossary; the rules: wording only, keep every price, number, phone, email and address, keep the block markup); without, the list with their translations filtered by lang and state (missing | stale | unreviewed | done), type (page, post…), page. Everything else: kind term (categories, tags), shop (products, variants, shop categories) or booking (services, variants, booking categories) lists those with their translations; with type (e.g. category, shop_product, booking_service) and id, the brief for one object (its source fields and translation). Read-only.
wp_translation_save18 of 18 parameters describedSave one translation of a page or post (create or update): source_id, lang, title, content (the source's block markup with the visible text translated), excerpt, seo_title, seo_description, status (draft | publish), reviewed (true only when a person checked it, or for translations already live on the old site; machine translations stay noindex until reviewed), provenance {source: human | machine | import, model}, slug (its own last address segment; the old one keeps redirecting; '' = the source's). For a term, shop or booking object send type, id, lang and fields (e.g. {name, description}) instead of source_id / title / content (status draft | published). The website refuses a translation that lost a number, price, web address or email from the source (send allow_changes only for a deliberate local difference). Read the brief first (wp_translations with source_id and lang). (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_translation_delete4 of 4 parameters describedMove one translation (id from wp_translations) to the trash; its source page or post stays. Visitors opening its address are sent to the source. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_translation_ai1 of 1 parameter describedThe website's own AI translation (Maggie Core 0.27+): the provider (Gemini, OpenAI or Claude) and model, which providers have a key saved (keys are entered only by the owner in wp-admin → Maggie Press → Languages → Settings (Settings → Languages before Maggie Core 0.40), never here), the daily limit and today's use, automatic translation of new and changed pages, whether machine translations are published (shown, not indexed until reviewed), the queue and the latest results. Read-only.
wp_translation_ai_set9 of 9 parameters describedChange the website's own AI translation: provider (gemini | openai | anthropic), model, daily_cap (AI calls a day), auto (translate new and changed pages and posts by themselves), auto_langs (codes; [] = all), publish (machine translations shown to visitors, noindex until reviewed). Keys can't be set here: the owner enters them in wp-admin → Maggie Press → Languages → Settings. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_translation_auto9 of 9 parameters describedHave the website translate with its own AI key (wp_translation_ai shows whether one is saved): queues what is missing or stale in lang — kind post (pages and posts), term, shop, booking or all; state missing | stale | both; limit (default 50) or ids (pages / posts). The website works through the queue a few at a time within its daily limit and saves them unreviewed (served, not indexed until reviewed). now (1-3) translates that many at once. Uses the owner's AI account. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_clone_status1 of 1 parameter describedA website moved onto Maggie Core from another platform as a clone (its original HTML served byte for byte): how many cloned pages, routes and shared parts it has, its blog engine (posts, feeds, agent files, languages), the original's 404 pages and missing-address rules, backend addresses kept (contact form, events), the output optimizer (site logo, font preloads, extra image sizes), prices following the booking menu (recent changes) and the media library. Read-only.
wp_clone_parts2 of 2 parameters describedThe parts a cloned website's pages share — header (with the menus), footer, head and the rest — most used first, with how many pages use each and a text preview; with key, one part's HTML. Every page keeps its own copy of the header (its menu item marked current), so a menu change is saved with wp_clone_part_save, which makes the same change on every copy. Read-only.
wp_clone_part_save6 of 6 parameters describedSave a cloned website's shared part (key from wp_clone_parts; html = the whole part, read it first and change only what was asked, e.g. one menu label or link). everywhere (default true) makes the same change on every page's copy of the header / footer and on the 404 pages. The previous version is kept (last 10, restorable in wp-admin → Appearance → Site parts). Changes what every page shows. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_clone_optimize_set6 of 6 parameters describedThe cloned website's output optimizer: logo (the original's logo address; when the owner picks a site logo in WordPress it replaces this everywhere), srcset (images from the media library also offer the sizes WordPress made, so phones load smaller files), preload (font files the first screen needs, e.g. /fonts/…/x.woff2). Only these additions differ from the original's HTML. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_clone_prices1 of 1 parameter describedPrices on a cloned website follow its booking menu (Maggie Booking, synced from Fresha): how many options the pages show, the Fresha sync mode (off | review | auto) and the latest changes written into pages (price rows, structured-data offers and durations rebuilt; a value two options shared left alone and logged). Read-only.
wp_clone_services1 of 1 parameter describedNew treatments on a cloned website (Maggie Core 0.33+): a treatment the booking menu adds gets its own page from the original's "new treatment" template (EN + ZH, noindex, re-rendered when its name or prices change, a 301 to /services when withdrawn), and from 0.34.1 joins the lists (header menu, treatment finder, /services/, hub and category pages, their ItemList) after its group's last item; withdrawn treatments leave every list (at most 5 per run). Shows: template reference, enabled, the pages it made, lists (kinds, groups, treatments it placed and where), pending (what the next run would do) and the log. Read-only.
wp_clone_services_set7 of 7 parameters describedSet up or run new-treatment pages and lists on a cloned website. enabled: create pages for new treatments. run: "dry" (report what would change) or "now" (create, refresh, retire pages and update the lists; it also runs after every booking-menu sync and hourly). template / lists: configs built with the Maggie Core repo tools (tools/clone_service_template.py; a site's lists config with item templates, groups and labels); the website refuses either unless it reproduces what the original already shows, byte for byte. Run dry first and show the plan. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_operation_today1 of 1 parameter describedThe website's Today screen (wp-admin → Maggie Press): what Maggie did this week (posts AI CMO delivered, translations, price changes from the booking menu, new treatment pages and list changes, IndexNow pings), what is waiting for the owner (new enquiries, bookings to confirm, orders to send, translations nobody reviewed, comments, updates; on Maggie Core 0.36+ also missing addresses visitors keep reaching) and alerts (late scheduled jobs, a failed IndexNow ping, held treatment-list changes, a failed booking-platform sync, enquiries that could not be emailed, not https, noindex, PHP errors shown; 0.36+: robots.txt blocking crawlers, a broken sitemap, Maggie's redirects switched off by an SEO plugin; 0.37+: a failed Ops Autopilot run). On 0.37+ also reports: the latest reports in the website's CMO.so inbox (title, summary, read or not) and how many are unread. Each item has a count and the wp-admin link. Read-only.
wp_operation_growth2 of 2 parameters describedThe website's Growth screen (Maggie Core 0.36+, wp-admin → Maggie Press → Growth): Google search (clicks, impressions, CTR and position for the last 28 days with the change against the 28 before, top searches and pages; from Search Console via CMO.so), AI answers (AI visibility, questions checked, answers naming the site, the websites answers cite most), speed (the latest PageSpeed scores for the homepage; 0.41+ also speed_weekly: the homepage and top pages every week with the change, see wp_operation_speed), SEO checks (indexing allowed, robots.txt blocking Google / Bing / AI crawlers, sitemap answers and is named in robots.txt, llms.txt, pages set to noindex, redirects switched off by an SEO plugin), missing addresses (404s visitors keep reaching, with a suggested new page), the redirect count and the IndexNow log. Remote parts are cached 6 hours; refresh: true checks again. Read-only. A full page-by-page crawl: wp_seo_tech_audit.
wp_operation_schedule3 of 3 parameters describedThe website's Schedule (Maggie Core 0.41+, wp-admin → Maggie Press → Schedule): one calendar of the next days (default 14, max 31) — posts and pages set to publish later, the website's own jobs (posts collected from cmo.so, booking-platform sync, prices following the booking menu, translations with its own AI key, IndexNow, the weekly speed check …) with how often they repeat, and from cmo.so the queued social posts at the time their queue gives them, the next planned blog posts and Maggie's routines (Ops Autopilot) with their times. Each item has a url where it is changed. Read-only.
wp_operation_speed2 of 2 parameters describedSpeed every week (Maggie Core 0.41+): PageSpeed on phones for the homepage and up to four top pages (Search Console's), checked once a week; this week's score, the change against last week and LCP per page, when the last and next checks are, and why a check stopped (cmo.so allows 12 page checks a day per website). check: true starts a check now (pages are checked one a minute; read again in a few minutes). Today warns by itself when a page gets 10 points slower or the homepage is below 50.
wp_404_log3 of 3 parameters describedMissing addresses the website answered 404 for (Maggie Core 0.36+): path, visits, first and last seen, the page that linked to it, and for open ones a suggested new page (a published page with the same last part). status: open (default) | redirected | dismissed. Probes for files a WordPress site never has (.php, .env, /wp-admin …) are not logged. Read-only.
wp_404_redirect7 of 7 parameters describedHandle one missing address from wp_404_log: action redirect sends it to a page (code 301 permanent by default, 302/307 temporary, or 410 to answer that it is gone for good) in the site's one redirect list, the same list wp_redirect_set edits (chains are shortened); dismiss stops showing it; reopen shows it again. Pick the page that replaced it, not the homepage, unless nothing did. Ask the owner first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
site_chat_get1 of 1 parameter describedMaggie Chat inside this website's WordPress (Maggie Core 0.38+, wp-admin → Maggie Press → Chat and the editor sidebar): whether the owner has allowed it (status never_asked | pending — someone in WordPress asked | approved | off), who asked and when, and whether you may change it (only the website's owner). Read-only.
site_chat_set4 of 4 parameters describedAllow Maggie Chat in this website's WordPress, or turn it off (only the website's owner). Allowed: the website's Administrators and Editors can ask Maggie about this website from wp-admin; Maggie works as the owner on this website only; every change still needs an approval card, which only the website's Administrators can approve; their messages count towards the owner's daily Maggie messages and each action is recorded with the WordPress person who asked. Off: every chat key the website holds stops at once. Ask the owner first. Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
wp_operation_business1 of 1 parameter describedBusiness cards for the modules the website uses: Bookings (today, next 7 days, to confirm, no-shows 30 days, cancelled 7 days), Shop (orders paid and takings 7 days, to send, low stock), Enquiries (new, received 7 days), Payments (online payments ready, booking payments 7 days, failed payments). Read-only.
wp_modules1 of 1 parameter describedThe Maggie Core modules on the website and their state: Operation and Enquiries (always on), Bookings and Shop (off | on | paused), Multilingual (on | paused | off; its own Languages menu since 0.40), Payments (the website's Stripe account, on while Bookings or the Shop is on; wp-admin → Maggie Press → Payments since 0.40). Each has a url and whether it can be switched (wp_modules_set). Read-only.
wp_modules_set7 of 7 parameters describedSwitch a module of the website (Maggie Core): bookings or shop: true turns it on (creates its tables the first time), false pauses it (data kept; visitors can no longer book or buy). multilingual (0.40+): false pauses it (the site shows its own language only; languages and translations are kept), true turns it on (its Languages menu). payments (0.40+): true shows the Payments menu before Bookings or the Shop is on; false is refused while they take payments. Ask the owner first. (needs a verified website.) Changes data: call without confirm for a preview, then with confirm: true and the confirmation after the user agrees.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.