@cmo-so/mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 0 of 5 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y @cmo-so/mcp@0.13.25
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
5 tools that take no input and look read-only were called once with nothing. 0 returned a result.
workspaces_list | No usable answer tool reported an error: That didn't work: The sign-in has expired. Reconnect CMO.so and try again. **Workspaces list** {"error":"The sign-in has expired. Recon |
profile_get | No usable answer tool reported an error: That didn't work: The sign-in has expired. Reconnect CMO.so and try again. **Profile get** {"error":"The sign-in has expired. Reconnect |
maggie_usage_get | No usable answer tool reported an error: That didn't work: The sign-in has expired. Reconnect CMO.so and try again. **Maggie usage get** {"error":"The sign-in has expired. Reco |
workspace_summary | No usable answer tool reported an error: That didn't work: The sign-in has expired. Reconnect CMO.so and try again. **Workspace summary** {"error":"The sign-in has expired. Rec |
inbox_list | No usable answer tool reported an error: That didn't work: The sign-in has expired. Reconnect CMO.so and try again. **Inbox list** {"error":"The sign-in has expired. Reconnect |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
workspaces_list workspace
List the websites (workspaces) this user can manage.
profile_get workspace
The signed-in person: name and email.
maggie_usage_get workspace
How many messages to Maggie and AI generations (ideas, LinkedIn drafts, voices) are left today, and when they reset.
website_add url, workspace, confirm, confirmation
Add 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_summary workspace
The current website: the user's role and permissions, plan, quota left, and the blog autopilot (on/off, paused, platform, posts per day).
195 more tools
inbox_list workspace
What needs the user now: LinkedIn posts to review, failures, setup steps, low quota, pauses.
setup_status_get workspace
How 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_get workspace
How 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_open platform, workspace
Give 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_start email, workspace, confirm, confirmation
Prove 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_confirm code, workspace, confirm, confirmation
Check 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_get workspace
Prove 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_check workspace, confirm, confirmation
Look 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_get workspace
The 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_desktop platform, workspace, confirm, confirmation
Email 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_list limit, workspace
What Maggie has changed for this user on this website (newest first), with the result of each.
plan_quota_get workspace
The plan for this website and what is left: posts this month and today. Needs permission to see the plan.
dashboard_link page, workspace
A 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_list workspace
The 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_list workspace
Apps 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_revoke grant_id, app, workspace, confirm, confirmation
Disconnect 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_list workspace
Standing 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_set key_id, key_name, website, tools, days, workspace, confirm, confirmation
Let 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_revoke id, key_name, workspace, confirm, confirmation
End 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_list workspace
The user's latest invoices across the subscriptions they pay for: date, amount, status and a link to view or download each.
profile_update display_name, workspace, confirm, confirmation
Change 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_get workspace
Which app notifications the user gets: LinkedIn posts to review (social_review), LinkedIn posts that failed (social_failed), new blog posts published (published).
notifications_set social_review, social_failed, published, workspace, confirm, confirmation
Turn 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_summary days, workspace
Results for the current website: posts published, ideas waiting, AI visibility average.
ai_visibility_get workspace
AI 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_get workspace
Whether Google Search Console is connected for this website and when its numbers were last fetched.
gsc_connect_link workspace, confirm, confirmation
A 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_get period, workspace
Google 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_get period, filter, limit, workspace
Search 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_sync workspace, confirm, confirmation
Fetch 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_list sort, band, limit, workspace
How 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_get id, workspace
One tracked article: its numbers, the search queries it shows up for, and its versions.
quota_get workspace
Blog posts left for this website: today, this month and in total (limits and plan too if the user may see the plan).
seo_audit_get device, workspace
The latest technical SEO check (PageSpeed scores and top issues) and whether it is out of date or running.
seo_audit_run device, workspace, confirm, confirmation
Start 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_get workspace
Maggie'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_set features, weekly_email, workspace, confirm, confirmation
Switch 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_list kind, unread, limit, workspace
The 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_get id, workspace
One report in full (its text in Markdown and any data); marks it read.
report_save title, summary, body_md, workspace, confirm, confirmation
Save 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_list limit, workspace
Ideas 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_cleanup id, workspace, confirm, confirmation
Bring 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_get limit, workspace
Checks 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_list status, limit, workspace
Reviews 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_draft id, workspace, confirm, confirmation
Ask 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_reply id, text, workspace, confirm, confirmation
Post 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_get id, workspace
One 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_signals refresh, types, workspace
What 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_plan keys, limit, social, series, workspace, confirm, confirmation
Turn 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_mark kind, id, mode, launch_at, from, to, note, workspace, confirm, confirmation
The 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_item kind, id, workspace
Check 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_attribution days, by, workspace
Where 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_list workspace
What 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_set keywords, workspace, confirm, confirmation
Replace 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_set enabled, workspace, confirm, confirmation
Turn 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_check prompt, workspace, confirm, confirmation
Ask 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_result task_id, workspace
The 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_get range, workspace
A 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_detect workspace
Which 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_get workspace
The business profile Maggie writes from: what they do, products, customers, regions, CTAs, testimonials.
brand_gaps_get workspace
What the business profile is still missing, most important first, so Maggie can ask about one gap at a time.
brand_update title, description, target_problem, target_region, industries, unique_selling_points, workspace, confirm, confirmation
Change 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_upsert target_keyword, cta_url, priority, example_texts, workspace, confirm, confirmation
Add 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_remove target_keyword, workspace, confirm, confirmation
Remove 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_set count, workspace, confirm, confirmation
Set 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_upsert name, title, content, use_in_posts, workspace, confirm, confirmation
Add 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_change name, use_in_posts, workspace, confirm, confirmation
Remove 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_upsert name, description, priority, workspace, confirm, confirmation
Add 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_remove name, workspace, confirm, confirmation
Remove 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_upsert segment, description, workspace, confirm, confirmation
Add 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_remove segment, workspace, confirm, confirmation
Remove 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_upsert name, description, website, workspace, confirm, confirmation
Add 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_remove name, workspace, confirm, confirmation
Remove 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_list workspace
Competitors 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_add id, workspace, confirm, confirmation
Add 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_dismiss id, workspace, confirm, confirmation
Not 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_find workspace, confirm, confirmation
Look 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_list workspace
The 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_upsert id, url, owner, label, uses, workspace, confirm, confirmation
Add 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_remove id, url, workspace, confirm, confirmation
Remove 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_update market_research, additional_information, swot, workspace, confirm, confirmation
Change 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_list workspace
The user's own brand voices (tone and audience combinations) Maggie can write in for this website.
brand_voice_set_default id, name, workspace, confirm, confirmation
Make 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_create name, products_services, target_region, target_audience, topics, workspace, confirm, confirmation
Create 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_style id, name, tone, writing_style, user_intent, positioning, examples, workspace, confirm, confirmation
Change 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_delete id, name, workspace, confirm, confirmation
Delete 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_list status, limit, workspace
Blog posts: planned (topics Maggie will write next, in order), draft (written, waiting to go out) or published.
post_get id, workspace
One blog post: title, excerpt, link, whether it can still be edited, and the start of its text.
draft_update id, title, excerpt, markdown, title_for_card, workspace, confirm, confirmation
Change 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_rewrite id, mode, instruction, title, workspace, confirm, confirmation
Let 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_brief id, mode, instruction, workspace
For 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_save id, mode, markdown, title, workspace, confirm, confirmation
Save 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_delete id, title, workspace, confirm, confirmation
Delete 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_move id, to, title, workspace, confirm, confirmation
Move 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_update id, title, description, keywords, title_for_card, workspace, confirm, confirmation
Change 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_remove id, title, workspace, confirm, confirmation
Take 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_list status, page, workspace
Ideas waiting to be written (newest first, 15 a page), or discarded ones that can be restored.
topics_list workspace
This website's topics (the themes Maggie writes about), for sorting an idea into one.
idea_add url, text, workspace, confirm, confirmation
Add 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_list ideas, workspace, confirm, confirmation
Add 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_generate count, brief, workspace, confirm, confirmation
Let 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_sitemap limit, sitemap_url, workspace, confirm, confirmation
Import 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_update id, title, description, topic, keywords, title_for_card, workspace, confirm, confirmation
Change 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_priority id, delta, title, workspace, confirm, confirmation
Raise (+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_plan id, title, position, workspace, confirm, confirmation
Add 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_discard id, title, workspace, confirm, confirmation
Remove 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_restore id, title, workspace, confirm, confirmation
Bring 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_paused paused, workspace, confirm, confirmation
Pause 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_get workspace
How 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_set posts_per_day, workspace, confirm, confirmation
Blog 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_now id, title, workspace, confirm, confirmation
Publish 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_list view, limit, workspace
Published 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_request url, instructions, target_keywords, workspace, confirm, confirmation
Rewrite 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_get workspace
Auto-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_set rewrite_mode, rewrite_ratio, rewrite_min_age_days, workspace, confirm, confirmation
Change 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_get workspace
The 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_set enabled, industry_sample, additional_guideline, min_confidence, new_posts, rewrites, workspace, confirm, confirmation
Change 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_test content_id, title, body, workspace, confirm, confirmation
Try 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_list workspace
The 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_copy id, text, workspace, confirm, confirmation
Change 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_approve ids, position, workspace, confirm, confirmation
Approve 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_now id, workspace, confirm, confirmation
Post 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_update id, social_copy, repost, workspace, confirm, confirmation
Change 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_delete id, workspace, confirm, confirmation
Take 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_skip id, workspace, confirm, confirmation
Skip 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_restore id, workspace, confirm, confirmation
Bring 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_new id, replace, instruction, mode, count, text_effect, style, workspace, confirm, confirmation
Make 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_fill ids, instruction, workspace, confirm, confirmation
A 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_effects workspace
The 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_look workspace
The 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_update style_ids, text_effect_ids, font_display, font_body, colours, description, never, reset, workspace, confirm, confirmation
Change 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_edit id, words, style, text_effect, order, remove, workspace, confirm, confirmation
Change 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_words id, style, workspace, confirm, confirmation
Put 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_attach id, files, urls, append, workspace, confirm, confirmation
Put 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_attach id, file, url, title, workspace, confirm, confirmation
A 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_link id, workspace
A 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_set id, format, title, workspace, confirm, confirmation
How 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_insights id, refresh, workspace
How 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_status workspace
Posts 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_status workspace
The 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_stop all, workspace, confirm, confirmation
Stop 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_move id, to, workspace, confirm, confirmation
Move 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_paused paused, channel, workspace, confirm, confirmation
Pause 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_list search, workspace
Published 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_article source_id, title, channels, position, workspace, confirm, confirmation
Maggie 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_days days, timezone, channels, position, workspace, confirm, confirmation
Maggie 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_list page, workspace
The user's LinkedIn ideas waiting to be written (their own and their campaigns'), newest campaign first.
social_idea_add title, summary, channels, workspace, confirm, confirmation
Add 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_update id, title, summary, workspace, confirm, confirmation
Change 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_delete id, title, workspace, confirm, confirmation
Delete 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_write id, title, channels, position, workspace, confirm, confirmation
Maggie 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_brief id, workspace
For 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_save id, posts, text, title, workspace, confirm, confirmation
Save 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_list workspace
The user's social campaigns: ideas written so far, whether ready or started, start day and posts a day.
campaign_start id, start_date, daily_limit, name, workspace, confirm, confirmation
Start 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_get id, workspace
One of the user's LinkedIn campaigns with its ideas and their state.
campaign_create name, brief, objective, cta_url, workspace, confirm, confirmation
Create 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_all channel, position, workspace, confirm, confirmation
Approve 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_create brief, count, channels, workspace, confirm, confirmation
Maggie 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_approve id, name, workspace, confirm, confirmation
Approve 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_plan id, name, workspace, confirm, confirmation
Maggie 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_pause id, paused, name, workspace, confirm, confirmation
Pause (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_set mode, workspace, confirm, confirmation
Whether 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_get workspace
The user's LinkedIn setup: which steps are done, logo and image style, learned voice, chosen post formats and writing options, posting hours.
social_voice_learn post_text, workspace, confirm, confirmation
Learn 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_suggest workspace, confirm, confirmation
Maggie 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_preview key, workspace
Example posts in one LinkedIn format, short / medium / long.
social_formats_set keys, include_emojis, include_hashtags, post_length_mode, workspace, confirm, confirmation
Choose 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_set timezone, times, days, workspace, confirm, confirmation
Set 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_set style_id, palette, workspace, confirm, confirmation
Change 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_retrain workspace, confirm, confirmation
Maggie 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_link workspace, confirm, confirmation
A 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_link workspace, confirm, confirmation
A 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_link workspace, confirm, confirmation
A 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_button id, button, workspace, confirm, confirmation
Set 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_link workspace, confirm, confirmation
A 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_attach id, file, url, workspace, confirm, confirmation
Make 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_detach id, workspace, confirm, confirmation
Take 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_link workspace, confirm, confirmation
A 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_creator workspace
What 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_set id, privacy, allow_comment, allow_duet, allow_stitch, disclose, your_brand, branded, is_aigc, workspace, confirm, confirmation
Set 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_add file, url, video_id, channels, is_aigc, note, write, start, end, vertical, workspace, confirm, confirmation
Make 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_photo id, note, caption, workspace, confirm, confirmation
A 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_plan brief, item_id, aspect, seconds, scenes, reference_url, workspace, confirm, confirmation
Plan 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_list workspace
This 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_get id, workspace
One 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_change id, scenes, add_scenes, order, redo_scenes, style, aspect, seconds, card_seconds, cta_headline, cta_sub, voice, music, title, workspace, confirm, confirmation
Change 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_make id, estimate_usd, stage, go_ahead, workspace, confirm, confirmation
Make 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_picture id, scene, picture_url, workspace, confirm, confirmation
Use 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_stop id, workspace, confirm, confirmation
Stop 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_set id, title, tags, privacy, made_for_kids, synthetic, workspace, confirm, confirmation
Change 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_settings workspace
The user's YouTube defaults for new posts on this website: visibility, made_for_kids (null = asked each time), category and altered content.
youtube_settings_set privacy, made_for_kids, synthetic, workspace, confirm, confirmation
Change 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_performance refresh, workspace
How 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_type id, type, title, start, end, start_time, end_time, coupon, terms, redeem_url, workspace, confirm, confirmation
Make 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.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | SEE LICENSE IN LICENSE |
|---|---|
| Needs | node >=20 |
| Source | github.com/AI-Marketing-OS-LTD/cmo-so |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-DYoW+gA9402sAQXfXlM3EbNNX+iCSCbjEW3nunbxD2vJb9AZQckjTQ7+/2ZXCSdA+VLtrFGYCoIDHE4c91+qDA== |
Versions reported
| Version | Run | Result | Tools |
|---|---|---|---|
| 0.13.25 | 2026-11-16 | Starts with no setup | 200 |
| 0.13.24 | 2026-11-12 | Starts with no setup | 200 |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40cmo-so/mcp)
New version out? Ask for a fresh report.