{"report":{"v":1,"package":"@cmo-so/mcp","version":"0.13.25","ranAt":"2026-11-16T11:30:45.352Z","install":{"ok":true,"integrity":"sha512-DYoW+gA9402sAQXfXlM3EbNNX+iCSCbjEW3nunbxD2vJb9AZQckjTQ7+/2ZXCSdA+VLtrFGYCoIDHE4c91+qDA==","deps":0,"scripts":[],"bins":["cmo-mcp"],"license":"SEE LICENSE IN LICENSE","engines":"node >=20","repository":"git+https://github.com/AI-Marketing-OS-LTD/cmo-so.git","bin":"cmo-mcp"},"start":{"ok":true,"ms":170,"serverName":"cmo-so","serverVersion":"0.13.25","protocol":"2025-06-18","stderr":"cmo mcp 0.13.25 ready (stdio)\n"},"tools":[{"name":"workspaces_list","description":"List the websites (workspaces) this user can manage.","params":["workspace"]},{"name":"profile_get","description":"The signed-in person: name and email.","params":["workspace"]},{"name":"maggie_usage_get","description":"How many messages to Maggie and AI generations (ideas, LinkedIn drafts, voices) are left today, and when they reset.","params":["workspace"]},{"name":"website_add","description":"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.","params":["url","workspace","confirm","confirmation"]},{"name":"workspace_summary","description":"The current website: the user's role and permissions, plan, quota left, and the blog autopilot (on/off, paused, platform, posts per day).","params":["workspace"]},{"name":"inbox_list","description":"What needs the user now: LinkedIn posts to review, failures, setup steps, low quota, pauses.","params":["workspace"]},{"name":"setup_status_get","description":"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.","params":["workspace"]},{"name":"connect_guides_get","description":"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.","params":["workspace"]},{"name":"connect_form_open","description":"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.","params":["platform","workspace"]},{"name":"verify_email_start","description":"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.","params":["email","workspace","confirm","confirmation"]},{"name":"verify_email_confirm","description":"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.","params":["code","workspace","confirm","confirmation"]},{"name":"dns_record_get","description":"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.","params":["workspace"]},{"name":"dns_verify_check","description":"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.","params":["workspace","confirm","confirmation"]},{"name":"wordpress_plugin_get","description":"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).","params":["workspace"]},{"name":"handoff_to_desktop","description":"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.","params":["platform","workspace","confirm","confirmation"]},{"name":"maggie_actions_list","description":"What Maggie has changed for this user on this website (newest first), with the result of each.","params":["limit","workspace"]},{"name":"plan_quota_get","description":"The plan for this website and what is left: posts this month and today. Needs permission to see the plan.","params":["workspace"]},{"name":"dashboard_link","description":"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.","params":["page","workspace"]},{"name":"api_keys_list","description":"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).","params":["workspace"]},{"name":"connected_apps_list","description":"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.","params":["workspace"]},{"name":"connected_app_revoke","description":"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.","params":["grant_id","app","workspace","confirm","confirmation"]},{"name":"standing_permissions_list","description":"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.","params":["workspace"]},{"name":"standing_permission_set","description":"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.","params":["key_id","key_name","website","tools","days","workspace","confirm","confirmation"]},{"name":"standing_permission_revoke","description":"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.","params":["id","key_name","workspace","confirm","confirmation"]},{"name":"invoices_list","description":"The user's latest invoices across the subscriptions they pay for: date, amount, status and a link to view or download each.","params":["workspace"]},{"name":"profile_update","description":"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.","params":["display_name","workspace","confirm","confirmation"]},{"name":"notifications_get","description":"Which app notifications the user gets: LinkedIn posts to review (social_review), LinkedIn posts that failed (social_failed), new blog posts published (published).","params":["workspace"]},{"name":"notifications_set","description":"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.","params":["social_review","social_failed","published","workspace","confirm","confirmation"]},{"name":"results_summary","description":"Results for the current website: posts published, ideas waiting, AI visibility average.","params":["days","workspace"]},{"name":"ai_visibility_get","description":"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.","params":["workspace"]},{"name":"gsc_status_get","description":"Whether Google Search Console is connected for this website and when its numbers were last fetched.","params":["workspace"]},{"name":"gsc_connect_link","description":"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.","params":["workspace","confirm","confirmation"]},{"name":"gsc_performance_get","description":"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.","params":["period","workspace"]},{"name":"gsc_queries_get","description":"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).","params":["period","filter","limit","workspace"]},{"name":"gsc_sync","description":"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.","params":["workspace","confirm","confirmation"]},{"name":"content_performance_list","description":"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.","params":["sort","band","limit","workspace"]},{"name":"content_asset_get","description":"One tracked article: its numbers, the search queries it shows up for, and its versions.","params":["id","workspace"]},{"name":"quota_get","description":"Blog posts left for this website: today, this month and in total (limits and plan too if the user may see the plan).","params":["workspace"]},{"name":"seo_audit_get","description":"The latest technical SEO check (PageSpeed scores and top issues) and whether it is out of date or running.","params":["device","workspace"]},{"name":"seo_audit_run","description":"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.","params":["device","workspace","confirm","confirmation"]},{"name":"ops_autopilot_get","description":"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).","params":["workspace"]},{"name":"ops_autopilot_set","description":"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.","params":["features","weekly_email","workspace","confirm","confirmation"]},{"name":"reports_list","description":"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.","params":["kind","unread","limit","workspace"]},{"name":"report_get","description":"One report in full (its text in Markdown and any data); marks it read.","params":["id","workspace"]},{"name":"report_save","description":"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.","params":["title","summary","body_md","workspace","confirm","confirmation"]},{"name":"idea_cleanup_list","description":"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.","params":["limit","workspace"]},{"name":"idea_restore_cleanup","description":"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.","params":["id","workspace","confirm","confirmation"]},{"name":"post_health_get","description":"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.","params":["limit","workspace"]},{"name":"gbp_reviews_list","description":"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.","params":["status","limit","workspace"]},{"name":"gbp_review_draft","description":"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.","params":["id","workspace","confirm","confirmation"]},{"name":"gbp_review_reply","description":"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.","params":["id","text","workspace","confirm","confirmation"]},{"name":"social_post_get","description":"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.","params":["id","workspace"]},{"name":"sales_signals","description":"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.","params":["refresh","types","workspace"]},{"name":"sales_signals_plan","description":"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.","params":["keys","limit","social","series","workspace","confirm","confirmation"]},{"name":"sales_signal_mark","description":"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.","params":["kind","id","mode","launch_at","from","to","note","workspace","confirm","confirmation"]},{"name":"sales_item","description":"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.","params":["kind","id","workspace"]},{"name":"sales_attribution","description":"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.","params":["days","by","workspace"]},{"name":"ai_visibility_prompts_list","description":"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).","params":["workspace"]},{"name":"ai_visibility_keywords_set","description":"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.","params":["keywords","workspace","confirm","confirmation"]},{"name":"ai_visibility_monitor_set","description":"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.","params":["enabled","workspace","confirm","confirmation"]},{"name":"ai_visibility_prompt_check","description":"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.","params":["prompt","workspace","confirm","confirmation"]},{"name":"ai_visibility_prompt_result","description":"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.","params":["task_id","workspace"]},{"name":"report_overview_get","description":"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.","params":["range","workspace"]},{"name":"platform_detect","description":"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.","params":["workspace"]},{"name":"brand_get","description":"The business profile Maggie writes from: what they do, products, customers, regions, CTAs, testimonials.","params":["workspace"]},{"name":"brand_gaps_get","description":"What the business profile is still missing, most important first, so Maggie can ask about one gap at a time.","params":["workspace"]},{"name":"brand_update","description":"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.","params":["title","description","target_problem","target_region","industries","unique_selling_points","workspace","confirm","confirmation"]},{"name":"cta_upsert","description":"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.","params":["target_keyword","cta_url","priority","example_texts","workspace","confirm","confirmation"]},{"name":"cta_remove","description":"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.","params":["target_keyword","workspace","confirm","confirmation"]},{"name":"internal_links_set","description":"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.","params":["count","workspace","confirm","confirmation"]},{"name":"testimonial_upsert","description":"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.","params":["name","title","content","use_in_posts","workspace","confirm","confirmation"]},{"name":"testimonials_change","description":"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.","params":["name","use_in_posts","workspace","confirm","confirmation"]},{"name":"product_upsert","description":"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.","params":["name","description","priority","workspace","confirm","confirmation"]},{"name":"product_remove","description":"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.","params":["name","workspace","confirm","confirmation"]},{"name":"audience_upsert","description":"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.","params":["segment","description","workspace","confirm","confirmation"]},{"name":"audience_remove","description":"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.","params":["segment","workspace","confirm","confirmation"]},{"name":"competitor_upsert","description":"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.","params":["name","description","website","workspace","confirm","confirmation"]},{"name":"competitor_remove","description":"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.","params":["name","workspace","confirm","confirmation"]},{"name":"competitor_suggestions_list","description":"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.","params":["workspace"]},{"name":"competitor_suggestion_add","description":"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.","params":["id","workspace","confirm","confirmation"]},{"name":"competitor_suggestion_dismiss","description":"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.","params":["id","workspace","confirm","confirmation"]},{"name":"competitor_suggestions_find","description":"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.","params":["workspace","confirm","confirmation"]},{"name":"sitemap_list","description":"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.","params":["workspace"]},{"name":"sitemap_upsert","description":"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.","params":["id","url","owner","label","uses","workspace","confirm","confirmation"]},{"name":"sitemap_remove","description":"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.","params":["id","url","workspace","confirm","confirmation"]},{"name":"brand_research_update","description":"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.","params":["market_research","additional_information","swot","workspace","confirm","confirmation"]},{"name":"brand_voices_list","description":"The user's own brand voices (tone and audience combinations) Maggie can write in for this website.","params":["workspace"]},{"name":"brand_voice_set_default","description":"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.","params":["id","name","workspace","confirm","confirmation"]},{"name":"brand_voice_create","description":"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.","params":["name","products_services","target_region","target_audience","topics","workspace","confirm","confirmation"]},{"name":"brand_voice_update_style","description":"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.","params":["id","name","tone","writing_style","user_intent","positioning","examples","workspace","confirm","confirmation"]},{"name":"brand_voice_delete","description":"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.","params":["id","name","workspace","confirm","confirmation"]},{"name":"posts_list","description":"Blog posts: planned (topics Maggie will write next, in order), draft (written, waiting to go out) or published.","params":["status","limit","workspace"]},{"name":"post_get","description":"One blog post: title, excerpt, link, whether it can still be edited, and the start of its text.","params":["id","workspace"]},{"name":"draft_update","description":"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.","params":["id","title","excerpt","markdown","title_for_card","workspace","confirm","confirmation"]},{"name":"draft_rewrite","description":"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.","params":["id","mode","instruction","title","workspace","confirm","confirmation"]},{"name":"draft_rewrite_brief","description":"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.","params":["id","mode","instruction","workspace"]},{"name":"draft_rewrite_save","description":"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.","params":["id","mode","markdown","title","workspace","confirm","confirmation"]},{"name":"draft_delete","description":"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.","params":["id","title","workspace","confirm","confirmation"]},{"name":"plan_move","description":"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.","params":["id","to","title","workspace","confirm","confirmation"]},{"name":"plan_update","description":"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.","params":["id","title","description","keywords","title_for_card","workspace","confirm","confirmation"]},{"name":"plan_remove","description":"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.","params":["id","title","workspace","confirm","confirmation"]},{"name":"ideas_list","description":"Ideas waiting to be written (newest first, 15 a page), or discarded ones that can be restored.","params":["status","page","workspace"]},{"name":"topics_list","description":"This website's topics (the themes Maggie writes about), for sorting an idea into one.","params":["workspace"]},{"name":"idea_add","description":"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.","params":["url","text","workspace","confirm","confirmation"]},{"name":"ideas_add_list","description":"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.","params":["ideas","workspace","confirm","confirmation"]},{"name":"ideas_generate","description":"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.","params":["count","brief","workspace","confirm","confirmation"]},{"name":"ideas_import_sitemap","description":"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.","params":["limit","sitemap_url","workspace","confirm","confirmation"]},{"name":"idea_update","description":"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.","params":["id","title","description","topic","keywords","title_for_card","workspace","confirm","confirmation"]},{"name":"idea_priority","description":"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.","params":["id","delta","title","workspace","confirm","confirmation"]},{"name":"idea_plan","description":"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.","params":["id","title","position","workspace","confirm","confirmation"]},{"name":"idea_discard","description":"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.","params":["id","title","workspace","confirm","confirmation"]},{"name":"idea_restore","description":"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.","params":["id","title","workspace","confirm","confirmation"]},{"name":"autopilot_set_paused","description":"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.","params":["paused","workspace","confirm","confirmation"]},{"name":"publish_settings_get","description":"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.","params":["workspace"]},{"name":"posts_per_day_set","description":"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.","params":["posts_per_day","workspace","confirm","confirmation"]},{"name":"post_publish_now","description":"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.","params":["id","title","workspace","confirm","confirmation"]},{"name":"rewrite_queue_list","description":"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.","params":["view","limit","workspace"]},{"name":"rewrite_request","description":"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.","params":["url","instructions","target_keywords","workspace","confirm","confirmation"]},{"name":"rewrite_policy_get","description":"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.","params":["workspace"]},{"name":"rewrite_policy_set","description":"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.","params":["rewrite_mode","rewrite_ratio","rewrite_min_age_days","workspace","confirm","confirmation"]},{"name":"content_guard_get","description":"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.","params":["workspace"]},{"name":"content_guard_set","description":"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.","params":["enabled","industry_sample","additional_guideline","min_confidence","new_posts","rewrites","workspace","confirm","confirmation"]},{"name":"content_guard_test","description":"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.","params":["content_id","title","body","workspace","confirm","confirmation"]},{"name":"social_list","description":"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.","params":["workspace"]},{"name":"social_update_copy","description":"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.","params":["id","text","workspace","confirm","confirmation"]},{"name":"social_approve","description":"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.","params":["ids","position","workspace","confirm","confirmation"]},{"name":"social_publish_now","description":"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.","params":["id","workspace","confirm","confirmation"]},{"name":"social_posted_update","description":"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.","params":["id","social_copy","repost","workspace","confirm","confirmation"]},{"name":"social_posted_delete","description":"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.","params":["id","workspace","confirm","confirmation"]},{"name":"social_skip","description":"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.","params":["id","workspace","confirm","confirmation"]},{"name":"social_restore","description":"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.","params":["id","workspace","confirm","confirmation"]},{"name":"social_image_new","description":"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.","params":["id","replace","instruction","mode","count","text_effect","style","workspace","confirm","confirmation"]},{"name":"social_images_fill","description":"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.","params":["ids","instruction","workspace","confirm","confirmation"]},{"name":"social_text_effects","description":"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').","params":["workspace"]},{"name":"social_look","description":"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.","params":["workspace"]},{"name":"social_look_update","description":"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.","params":["style_ids","text_effect_ids","font_display","font_body","colours","description","never","reset","workspace","confirm","confirmation"]},{"name":"social_picture_edit","description":"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.","params":["id","words","style","text_effect","order","remove","workspace","confirm","confirmation"]},{"name":"social_photo_words","description":"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.","params":["id","style","workspace","confirm","confirmation"]},{"name":"social_pictures_attach","description":"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.","params":["id","files","urls","append","workspace","confirm","confirmation"]},{"name":"social_carousel_pdf_attach","description":"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.","params":["id","file","url","title","workspace","confirm","confirmation"]},{"name":"social_upload_link","description":"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.","params":["id","workspace"]},{"name":"social_carousel_set","description":"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.","params":["id","format","title","workspace","confirm","confirmation"]},{"name":"social_post_insights","description":"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).","params":["id","refresh","workspace"]},{"name":"social_write_status","description":"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.","params":["workspace"]},{"name":"social_image_status","description":"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).","params":["workspace"]},{"name":"social_image_stop","description":"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.","params":["all","workspace","confirm","confirmation"]},{"name":"social_move","description":"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.","params":["id","to","workspace","confirm","confirmation"]},{"name":"social_set_paused","description":"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.","params":["paused","channel","workspace","confirm","confirmation"]},{"name":"social_sources_list","description":"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).","params":["search","workspace"]},{"name":"social_from_article","description":"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.","params":["source_id","title","channels","position","workspace","confirm","confirmation"]},{"name":"social_plan_days","description":"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.","params":["days","timezone","channels","position","workspace","confirm","confirmation"]},{"name":"social_ideas_list","description":"The user's LinkedIn ideas waiting to be written (their own and their campaigns'), newest campaign first.","params":["page","workspace"]},{"name":"social_idea_add","description":"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.","params":["title","summary","channels","workspace","confirm","confirmation"]},{"name":"social_idea_update","description":"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.","params":["id","title","summary","workspace","confirm","confirmation"]},{"name":"social_idea_delete","description":"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.","params":["id","title","workspace","confirm","confirmation"]},{"name":"social_idea_write","description":"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.","params":["id","title","channels","position","workspace","confirm","confirmation"]},{"name":"social_idea_brief","description":"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.","params":["id","workspace"]},{"name":"social_idea_save","description":"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.","params":["id","posts","text","title","workspace","confirm","confirmation"]},{"name":"campaign_list","description":"The user's social campaigns: ideas written so far, whether ready or started, start day and posts a day.","params":["workspace"]},{"name":"campaign_start","description":"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.","params":["id","start_date","daily_limit","name","workspace","confirm","confirmation"]},{"name":"campaign_get","description":"One of the user's LinkedIn campaigns with its ideas and their state.","params":["id","workspace"]},{"name":"campaign_create","description":"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.","params":["name","brief","objective","cta_url","workspace","confirm","confirmation"]},{"name":"social_approve_all","description":"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.","params":["channel","position","workspace","confirm","confirmation"]},{"name":"series_create","description":"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.","params":["brief","count","channels","workspace","confirm","confirmation"]},{"name":"series_approve","description":"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.","params":["id","name","workspace","confirm","confirmation"]},{"name":"campaign_plan","description":"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.","params":["id","name","workspace","confirm","confirmation"]},{"name":"campaign_pause","description":"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.","params":["id","paused","name","workspace","confirm","confirmation"]},{"name":"social_approval_mode_set","description":"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.","params":["mode","workspace","confirm","confirmation"]},{"name":"social_setup_get","description":"The user's LinkedIn setup: which steps are done, logo and image style, learned voice, chosen post formats and writing options, posting hours.","params":["workspace"]},{"name":"social_voice_learn","description":"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.","params":["post_text","workspace","confirm","confirmation"]},{"name":"social_formats_suggest","description":"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.","params":["workspace","confirm","confirmation"]},{"name":"social_format_preview","description":"Example posts in one LinkedIn format, short / medium / long.","params":["key","workspace"]},{"name":"social_formats_set","description":"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.","params":["keys","include_emojis","include_hashtags","post_length_mode","workspace","confirm","confirmation"]},{"name":"social_hours_set","description":"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.","params":["timezone","times","days","workspace","confirm","confirmation"]},{"name":"social_style_set","description":"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.","params":["style_id","palette","workspace","confirm","confirmation"]},{"name":"social_style_retrain","description":"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.","params":["workspace","confirm","confirmation"]},{"name":"linkedin_connect_link","description":"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.","params":["workspace","confirm","confirmation"]},{"name":"facebook_connect_link","description":"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.","params":["workspace","confirm","confirmation"]},{"name":"google_business_connect_link","description":"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.","params":["workspace","confirm","confirmation"]},{"name":"social_google_button","description":"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.","params":["id","button","workspace","confirm","confirmation"]},{"name":"youtube_connect_link","description":"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.","params":["workspace","confirm","confirmation"]},{"name":"social_video_attach","description":"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.","params":["id","file","url","workspace","confirm","confirmation"]},{"name":"social_video_detach","description":"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.","params":["id","workspace","confirm","confirmation"]},{"name":"tiktok_connect_link","description":"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.","params":["workspace","confirm","confirmation"]},{"name":"tiktok_creator","description":"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.","params":["workspace"]},{"name":"social_tiktok_set","description":"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.","params":["id","privacy","allow_comment","allow_duet","allow_stitch","disclose","your_brand","branded","is_aigc","workspace","confirm","confirmation"]},{"name":"social_video_add","description":"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.","params":["file","url","video_id","channels","is_aigc","note","write","start","end","vertical","workspace","confirm","confirmation"]},{"name":"social_tiktok_photo","description":"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.","params":["id","note","caption","workspace","confirm","confirmation"]},{"name":"ad_video_plan","description":"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.","params":["brief","item_id","aspect","seconds","scenes","reference_url","workspace","confirm","confirmation"]},{"name":"ad_video_list","description":"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.","params":["workspace"]},{"name":"ad_video_get","description":"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.","params":["id","workspace"]},{"name":"ad_video_change","description":"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.","params":["id","scenes","add_scenes","order","redo_scenes","style","aspect","seconds","card_seconds","cta_headline","cta_sub","voice","music","title","workspace","confirm","confirmation"]},{"name":"ad_video_make","description":"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.","params":["id","estimate_usd","stage","go_ahead","workspace","confirm","confirmation"]},{"name":"ad_video_picture","description":"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.","params":["id","scene","picture_url","workspace","confirm","confirmation"]},{"name":"ad_video_stop","description":"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.","params":["id","workspace","confirm","confirmation"]},{"name":"social_youtube_set","description":"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.","params":["id","title","tags","privacy","made_for_kids","synthetic","workspace","confirm","confirmation"]},{"name":"youtube_settings","description":"The user's YouTube defaults for new posts on this website: visibility, made_for_kids (null = asked each time), category and altered content.","params":["workspace"]},{"name":"youtube_settings_set","description":"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.","params":["privacy","made_for_kids","synthetic","workspace","confirm","confirmation"]},{"name":"google_business_performance","description":"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.","params":["refresh","workspace"]},{"name":"social_google_post_type","description":"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.","params":["id","type","title","start","end","start_time","end_time","coupon","terms","redeem_url","workspace","confirm","confirmation"]}],"toolsHash":"29da2a85213f204e3569d8371d9cc62c362040e76bd62954a2c2dd87fdc3f892","wrote":[],"callsAt":"2026-11-16T11:30:49.727Z","calls":[{"tool":"workspaces_list","ok":false,"ms":5,"bytes":0,"error":"tool reported an error: That didn't work: The sign-in has expired. Reconnect CMO.so and try again.\n\n**Workspaces list**\n{\"error\":\"The sign-in has expired. Reconnect CMO.so and try again.\"}"},{"tool":"profile_get","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: That didn't work: The sign-in has expired. Reconnect CMO.so and try again.\n\n**Profile get**\n{\"error\":\"The sign-in has expired. Reconnect CMO.so and try again.\"}"},{"tool":"maggie_usage_get","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: That didn't work: The sign-in has expired. Reconnect CMO.so and try again.\n\n**Maggie usage get**\n{\"error\":\"The sign-in has expired. Reconnect CMO.so and try again.\"}"},{"tool":"workspace_summary","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: That didn't work: The sign-in has expired. Reconnect CMO.so and try again.\n\n**Workspace summary**\n{\"error\":\"The sign-in has expired. Reconnect CMO.so and try again.\"}"},{"tool":"inbox_list","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: That didn't work: The sign-in has expired. Reconnect CMO.so and try again.\n\n**Inbox list**\n{\"error\":\"The sign-in has expired. Reconnect CMO.so and try again.\"}"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":200,"wrote":0,"callsTried":5,"callsAnswered":0,"callContacts":[]},"history":[{"package":"@cmo-so/mcp","version":"0.13.25","ranAt":"2026-11-16T11:30:45.352Z","outcome":"started","tools":200,"contacts":0,"flags":0,"serious":0,"toolsHash":"29da2a85213f204e3569d8371d9cc62c362040e76bd62954a2c2dd87fdc3f892"},{"package":"@cmo-so/mcp","version":"0.13.24","ranAt":"2026-11-12T17:51:50.220Z","outcome":"started","tools":200,"contacts":0,"flags":0,"serious":0,"toolsHash":"29da2a85213f204e3569d8371d9cc62c362040e76bd62954a2c2dd87fdc3f892"}],"page":"https://bragproof.smaverk.com/r/%40cmo-so/mcp"}