add_post_meta
ChatGPTAdd another value for one post or page metadata key without replacing existing values. Requires owner approval.
assign_term
ChatGPTReplace a post's terms in the specified taxonomy with the one existing term ID. This is not an append operation. Requires owner approval.
audit_seo
ChatGPTCheck posts or pages for SEO problems: missing or long SEO titles, missing or short meta descriptions, no focus keyword, noindex, no internal links, images without alt text, several H1 headings, thin content and missing featured images. Pass post_id for one item, or page through a post type. Read-only.
batch_create_posts
ChatGPTCreate multiple posts at once
batch_delete_posts
ChatGPTDelete multiple posts at once
batch_update_posts
ChatGPTUpdate multiple posts at once
bulk_edit_post_blocks
ChatGPTMake section edits on many posts or pages, across one or many sites, for example replacing an outdated notice everywhere. Read each item first with get_post_blocks; each item carries its own expected_hash and operations, exactly as edit_post_blocks takes them. Items whose content changed since you read them are skipped and reported. Runs in the background after one owner approval and returns a job_id; check progress with get_bulk_job. Every item is still checked against this connection's sites and permissions. Completed items can be undone together.
bulk_edit_products
ChatGPTChange many WooCommerce products, in one store or across stores, for example a 10% price rise or restocking a range (commerce:write is also required). Read them first with woo_products or woo_get_product. Each item names site_id, product_id and only the fields to change, exactly as woo_edit_product takes them. Runs in the background after one owner approval and returns a job_id; check progress with get_bulk_job. Every item is still checked against this connection's sites and permissions. Completed items can be undone together.
bulk_flush_cache
ChatGPTClear the page and object cache on many selected sites at once. Requires owner approval.
bulk_replace_in_posts
ChatGPTReplace a piece of text in many posts or pages, on one site or across sites, for example a new phone number or brand name everywhere (posts:update is also required). Search each site with find_in_content first and show the user the matches; send find, replace, fields and case_sensitive once, and one item per post with its match_hash as expected_hash. Posts edited since the search are skipped and reported. Runs in the background after one owner approval and returns a job_id; check progress with get_bulk_job. Every item is still checked against this connection's sites and permissions. Completed items can be undone together.
bulk_run_backups
ChatGPTStart a backup (database, or full files and database) on many selected sites at once. Returns a per-site result. Requires owner approval.
bulk_run_security_scans
ChatGPTStart a security scan on many selected sites at once. Read results later with get_security_report. Requires owner approval.
bulk_set_alt_texts
ChatGPTSave alt text for many images across one or many sites. Each item names site_id, attachment_id and alt. Usually built from generate_alt_text proposals the user reviewed. Runs in the background after one owner approval and returns a job_id; check progress with get_bulk_job. Every item is still checked against this connection's sites and permissions. Completed items can be undone together.
bulk_set_seo
ChatGPTChange SEO fields on many posts, across one or many sites, through each site's SEO plugin (seo:write is also required). Each item names site_id, post_id and the fields to set or clear. Runs in the background after one owner approval and returns a job_id; check progress with get_bulk_job. Every item is still checked against this connection's sites and permissions. Completed items can be undone together.
bulk_site_action
ChatGPTRun one maintenance action across MANY sites at once (fleet fan-out, capped at 20 sites). Provide either an explicit site_ids list or a filter (status/search). Returns a per-site success/error/timeout roll-up. Always pauses for human approval.
bulk_toggle_plugin
ChatGPTActivate or deactivate one plugin (by plugin file path) on many selected sites at once. Returns a per-site result. Requires owner approval.
bulk_update_all
ChatGPTApply all available plugin, theme and core updates on many selected sites at once. Target an explicit site_ids list or a status/search filter. Returns a per-site result. Requires owner approval.
bulk_update_plugin
ChatGPTUpdate one plugin (by slug) on many selected sites at once. Returns a per-site result. Requires owner approval.
change_user_role
ChatGPTChange a WordPress user's role, for example to editor or subscriber. Requires owner approval.
create_block_draft
ChatGPTRequest approval to create a NEW draft page from Gutenberg or GreenLight/Greenshift block markup. Never publishes or overwrites. First inspect get_design_context. Optional Greenshift page CSS is persisted with the draft. Scripts are unsupported. Editor and visual validation are still required after creation.
create_page
ChatGPTCreate a new page on a WordPress site
create_post
ChatGPTCreate a new post on a WordPress site
create_term
ChatGPTCreate one named category, tag, or custom taxonomy term. Requires owner approval.
create_user
ChatGPTCreate a WordPress user with a random password nobody sees; returns a one-time link the person opens to set their own password. Requires owner approval.
delete_media
ChatGPTDelete a media library item by attachment ID
delete_page
ChatGPTDelete a page from a site
delete_post
ChatGPTDelete a post from a site
delete_post_meta
ChatGPTDelete values for one post or page metadata key. Omitting value or passing an empty value deletes all values for that key. Requires owner approval.
delete_user
ChatGPTDelete a WordPress user. Their content is deleted unless reassign_to names another user. Requires owner approval.
duplicate_post
ChatGPTCopy a post or page (content, excerpt, categories, tags, featured image and template) as a new draft. Nothing is published. Requires owner approval.
edit_post_blocks
ChatGPTChange part of a post or page without rewriting the rest. Read it first with get_post_blocks and pass its content_hash as expected_hash. Operations run in order: replace, insert_before, insert_after, append (optionally inside parent_path), remove, move (to_path is read after removal), update_attrs (shallow merge; null deletes a key). markup is serialized block markup, for example <!-- wp:paragraph --><p>Text</p><!-- /wp:paragraph -->. Only registered blocks are accepted; scripts are refused. Pages owned by a page builder are refused. The previous version is saved as a revision so the change can be undone. Requires owner approval.
enable_elementor_ai
ChatGPTTurn Elementor's own AI access on (or off) for a site. Elementor 4.3 and later only registers its abilities (read page structure, edit elements, build sections, global classes and variables) while this is on, so do this once before reading or editing Elementor pages; get_design_context shows elementor.ai_access_enabled. It changes a site setting, so it always waits for the owner's approval.
find_in_content
ChatGPTFind posts, pages or other content types on a site whose title, content or excerpt contains a piece of text (a brand name, an old phone number, an outdated link). Returns each match with counts, short snippets and match_hash. This is the preview for replace_in_post and bulk_replace_in_posts: show the user what will change before asking to replace. Posts marked skipped are owned by a page builder and cannot be changed here; can_undo=false means the type keeps no revisions. A page can hold fewer matches than per_page; keep paging while has_more is true. Never changes the site.
flush_cache
ChatGPTFlush a site's object and plugin caches (and optionally rewrite rules) — use after content or setting changes that aren't showing.
generate_alt_text
ChatGPTLook at images that have no alt text (one post's images with post_id, or the media library) and propose alt text with the workspace's own vision-capable AI model. Up to 20 images per call. Returns proposals only; nothing is saved. Review them, then save with set_alt_texts. Counts toward the monthly AI budget.
generate_featured_image
ChatGPTCreate 1 to 4 featured-image options for a post or page with the workspace's own OpenAI or Google key (1200 by 630, no text in the image). Describe the subject and style in prompt; use the site brief and the post's topic. Options are stored privately for 24 hours and nothing is uploaded. To use one, call upload_media with its generated_image_id, featured_post_id and alt_text; the owner sees the image before approving. Each image costs a few cents on the workspace's AI account and counts toward its monthly AI budget.
get_analytics
ChatGPTGet Google Analytics data for a site
get_backups
ChatGPTList the backups available on a site (name, size, created time).
get_block_design
ChatGPTRead a page, post or custom post type item's full block code to redesign it: the raw serialized blocks, its Greenshift page CSS (greenshift_css), the Greenshift block scripts it uses (by block id), its page template, and design_hash to send back to update_block_design. For Greenshift/GreenLight pages, deconvert the content with greenlight_deconvert_blocks for big changes. builder is set when a page builder owns the page (not editable here). Content over 240 KB: use get_post_blocks and edit_post_blocks instead. Read-only.
get_broken_links
ChatGPTRead the most recent broken-link scan result for a site (broken URLs, HTTP status codes, and the pages they were found on). Reads the stored result — run_broken_link_scan populates it.
get_bulk_job
ChatGPTShow a fleet job's status (queued, running, done, partial, failed, undone), its counts and per-item results.
get_connection_info
ChatGPTExplain this connection: selected-site count, granted permissions, available workflows and approval rules. Use first when a user asks what CMDPress can do or why access is missing. Never returns credentials.
get_content_model
ChatGPTRead a site's content model before building or changing it: custom post types (with entry counts, archive URL and whether Secure Custom Fields or ACF manages them), taxonomies, field groups with their fields (pass a field group's group to save_field_group), the single and archive template of each type, which fields plugin is active (fields_plugin, null when none) and how this site takes templates (templates.method: blocksy, block_theme, or null with the reason). Pass post_type to focus on one. Read-only.
get_content_template
ChatGPTRead the single (one entry) or archive (the list) template of a custom post type: its blocks (content), Greenshift page CSS on Blocksy sites, design_hash to send back to save_content_template, the fields it can show, a preview_url, and on block themes a starting_point when there is no template yet. method null means the theme keeps these layouts in PHP; the reason says what to do instead. Read-only.
get_custom_fields
ChatGPTRead the Advanced Custom Fields (ACF) that apply to a post, page or custom post type item: each field's name, label, type, choices, sub-fields and current raw value (images and linked posts as IDs). Use the names with set_custom_fields. Sites without ACF answer acf_inactive; use get_post_meta there. Read-only.
get_design_context
ChatGPTInspect the selected site before designing: active theme, block-theme support, relevant installed plugins, paginated registered blocks, requested block schemas, and SCF field definitions (not values). Never infer premium licenses from installation. Requires an updated CMDPress WordPress agent.
get_fleet_status
ChatGPTReview a page of selected sites using saved uptime checks and permitted update counts. Distinguishes connection status from measured uptime and reports observation times. No scans or site changes. Summaries describe only this page; follow next_page for the rest.
get_ga4_report
ChatGPTQuery LIVE Google Analytics 4 metrics for a site from the team's own connected Google account (sessions, users, page views, engagement). Requires GA4 enabled with a property ID and Google connected. Set deep=true for the full deep-dive (top pages, channels, countries, devices).
get_gsc_performance
ChatGPTQuery LIVE Google Search Console performance for a site from the team's own connected Google account: total clicks, impressions, CTR and average position over the window. Requires Search Console enabled with a verified property URL and Google connected.
get_logs
ChatGPTRead the last lines of a site's WordPress debug log — use when debugging errors or a white screen.
get_pages
ChatGPTList pages on a site (title, ID, status, URL). Use before editing a page so you have its ID.
get_pagespeed_report
ChatGPTGet the latest PageSpeed report
get_post
ChatGPTGet a single post by ID
get_post_blocks
ChatGPTRead a post or page as an outline of its blocks. Each block has a path such as "0" or "2.1" (child of block 2), its name, attributes and a short text preview. Returns content_hash: pass it to edit_post_blocks as expected_hash so an edit never overwrites changes made since you read it. builder is set when a page builder owns the page; such pages cannot be edited by block.
get_post_meta
ChatGPTRead one post or page metadata field, including supported Rank Math or Yoast SEO keys. Does not change content or recalculate SEO scores.
get_posts
ChatGPTGet posts LIVE from a WordPress site (title, id, status, url, date). Queries the site directly so counts are accurate. Use before editing a post to get its ID.
get_security_report
ChatGPTRead the latest saved security scan state and last completed report for one selected WordPress site. Includes timestamps and bounded findings. Does not start a scan; queued or running scans are not completed results.
get_seo
ChatGPTRead a post or page's SEO fields through the site's SEO plugin (Rank Math, Yoast, All in One SEO, SEOPress, The SEO Framework or Slim SEO): title, description, focus keyword, canonical URL, noindex/nofollow, Open Graph and X fields, schema type and primary category. Shows which plugin is active and which fields it supports. Reading never changes the site.
get_site
ChatGPTGet detailed information about a specific site
get_site_brief
ChatGPTRead a site's brief before writing or making images for it: audience, tone, words to avoid, image style, language, default category and author, key pages to link to, and notes. Follow it. An empty brief means none was saved.
get_site_health
ChatGPTWordPress Site Health for a site: overall status, PHP/DB versions, directory sizes, and failing health checks.
get_site_intelligence
ChatGPTCompact cross-feature health digest for one site, assembled from CMDPress's OWN stored data (no live site call): open anomalies, latest security scan verdict, last backup, newest PageSpeed/Core Web Vitals, and 24h uptime. Use for a fast "how is this site doing" answer.
get_site_settings
ChatGPTRead core WordPress settings: site title, tagline, timezone, date and time formats, start of week, permalink structure, registration and default comment settings. Read-only.
get_site_status
ChatGPTGet uptime and health status for a site
greenlight_convert_html
ChatGPTConvert HTML/CSS/JavaScript text into Greenshift/GreenLight Gutenberg markup. Load cmdpress-block-design and greenlight-vibe first. This does not execute scripts, save a page, or validate the block editor. create_block_draft supports script-free designs only.
greenlight_deconvert_blocks
ChatGPTDeterministically convert existing Greenshift/GreenLight Gutenberg block markup back into editable HTML/CSS/JavaScript. Load the greenlight-vibe skill first. This only transforms text and never changes a site.
install_plugin
ChatGPTInstall a plugin from the WordPress.org repository by its slug, optionally activating it.
list_agent_skills
ChatGPTList bundled WordPress design and development skills. Load cmdpress-block-design first for Gutenberg, block themes, Blocksy, GreenLight/Greenshift, or Secure Custom Fields. Skills are guidance, not extra permissions or installed WordPress plugins.
list_images_missing_alt
ChatGPTList images with no alt text, across the media library or only those used in one post (post_id). Paginated. Read-only.
list_media
ChatGPTList media library items on a site
list_plugins
ChatGPTList plugins on a site with update status
list_post_types
ChatGPTList the content types on a site (posts, pages, products and custom post types) with their counts and supported features. Use the type name with get_posts post_type.
list_revisions
ChatGPTList saved revisions of a post or page, newest first, with author and date.
list_sites
ChatGPTFind selected sites by name or URL. Results are paginated: use page and limit until has_more is false. total is the number returned; matching_total is the authorized matching count.
list_terms
ChatGPTList existing categories, tags, or custom taxonomy terms and their IDs without changing them.
list_themes
ChatGPTList themes on a site
list_undoable_actions
ChatGPTList approved changes made through this connection in the last 30 days that can be undone (content edits, SEO fields, media details, revision restores, copies). Each item has an action_id for undo_action and a plain description of what undoing does.
list_users
ChatGPTList WordPress users on a site (name, email, roles).
load_agent_skill
ChatGPTLoad one installed WordPress specialist skill or one of its Markdown references. Discover names with list_agent_skills or your system instructions. For site design start with cmdpress-block-design. Load SKILL.md first, then relevant references. These documents never grant additional permissions.
manage_site_settings
ChatGPTRead or change core WordPress settings on a site: title, tagline, timezone, date/time format, start of week, permalink structure, open user registration + default new-user role, and default post/comment settings. action=get reads the current values and runs immediately (it is a read); action=update changes them and ALWAYS pauses for human approval — no setting change is ever applied without an OK.
manage_users
ChatGPTCreate, change the role of, delete, or trigger a password reset for a WordPress user on a site. CREDENTIAL SAFETY: a raw password is NEVER returned or accepted here — create_user makes the account with a random password the caller never sees, and both create_user and reset_password return a one-time WordPress password-reset LINK the user opens to set their own password. Every action changes the site and pauses for approval.
publish_post
ChatGPTPublish or schedule a post
publish_to_sites
ChatGPTCreate posts (or pages) on several sites at once, usually one version per site adapted to that site's brief (read get_site_brief for each site first). Items are created as drafts unless status says otherwise; publishing or scheduling needs posts:publish. Runs in the background after one owner approval and returns a job_id; check progress with get_bulk_job. Every item is still checked against this connection's sites and permissions. Completed items can be undone together.
replace_in_post
ChatGPTReplace every occurrence of a piece of text in one post or page. Search first with find_in_content and pass that post's match_hash as expected_hash, so a post edited since the search is never overwritten. A revision is saved first and the change can be undone. For more than one post, use bulk_replace_in_posts instead. Waits for the owner's approval unless this connection is set to Auto-approve.
restore_backup
ChatGPTRestore a site from one of its BYO-S3 backups, chosen by id/key. DESTRUCTIVE AND IRREVERSIBLE: this OVERWRITES the site's current data — the database and/or files are replaced with the backup contents and the current state cannot be recovered afterwards. Call get_backups first to find the backup id/key. Always pauses for human approval.
restore_revision
ChatGPTRestore a post or page to one of its saved revisions (from list_revisions). The current version is saved as a revision first, so this can be undone. Requires owner approval.
review_actions
ChatGPTShow the owner a read-only review card for this connection's pending action IDs. The card links to the authenticated CMDPress approval inbox; this MCP connection cannot approve or deny its own requests. Pending means not executed. Omit IDs to review up to 20 pending requests.
run_backup
ChatGPTCreate a backup of a site before risky changes. scope "db" = database only (fast), "full" = files + database.
run_broken_link_scan
ChatGPTStart a broken-link crawl on a site (a long background job). It scans internal links and stores the result on the site; read it afterwards with get_broken_links.
run_pagespeed_scan
ChatGPTRun a PageSpeed performance scan
run_security_scan
ChatGPTRun a security scan on a site and return the findings (malware indicators, risky settings, outdated software, known CVEs).
save_content_template
ChatGPTDesign how every entry of a custom post type looks (template single) or its archive page (template archive), from registered blocks. Read it first with get_content_template and send its design_hash as expected_hash when one exists. Show fields with block bindings: a paragraph, heading or button with {"metadata":{"bindings":{"content":{"source":"acf/field","args":{"key":"<field name>"}}}}} (url for buttons and images), plus core/post-title, post-featured-image, post-excerpt, post-terms and post-content. An archive uses core/query with "inherit":true and core/post-template. On Blocksy sites it is saved as a Blocksy content block and may carry greenshift_css; on block themes the header and footer are added when you leave them out, and greenshift_css is not allowed (use CSSRender on Greenshift blocks). New scripts are refused. Always waits for the owner's approval. Undo puts the previous template back (a revision is kept) or removes a new one. Check the result with take_screenshot of preview_url.
save_content_type
ChatGPTCreate or change a custom post type (kind post_type, the default) or taxonomy (kind taxonomy) on a site, saved through Secure Custom Fields or ACF so the owner can keep editing it there. Read get_content_model first; if fields_plugin is null, install and activate Secure Custom Fields (free) first. A new post type needs name (singular, lower-case, max 20 characters, e.g. listing), singular and plural labels; it gets an archive, the block editor, featured images, excerpts and revisions unless you say otherwise. A new taxonomy needs post_types. Types registered by the theme or another plugin can't be changed. Always waits for the owner's approval. Undo removes a new type (entries are kept) or puts the previous definition back (restore_backup).
save_field_group
ChatGPTCreate or change a field group (custom fields) through Secure Custom Fields or ACF. New group: title, post_types (or taxonomies) it shows on, and fields. Each field: name (lower_snake_case), label, type (text, textarea, number, range, email, url, image, file, wysiwyg, oembed, gallery, select, checkbox, radio, button_group, true_false, link, post_object, page_link, relationship, taxonomy, user, date_picker, date_time_picker, time_picker, color_picker, group, repeater), and as needed required, instructions, placeholder, default_value, choices (list or value => label), multiple, min, max, step, rows, prepend, append, return_format, layout, button_label, width (10 to 100), taxonomy and field_type (taxonomy fields), post_type (relationship fields), sub_fields (repeater and group). Change a group: send its group from get_content_model; fields are matched by name, ones you leave out stay, remove lists names to drop (saved values stay in the database). New fields can be shown in templates. Repeaters and galleries need Secure Custom Fields or ACF PRO. Always waits for the owner's approval. Undo removes a new group or puts the previous one back.
search_site_content
ChatGPTSearch existing posts across ALL the team's sites (or one site) by keyword — live from each WordPress site. Use to answer "have I already written about X", find internal-link targets, or spot content gaps before drafting something new.
search_stock_images
ChatGPTSearch free-licence photos on Openverse that allow commercial use. Each result has a direct image URL, size, licence and a credit line. To use one, call upload_media with file_url and featured_post_id, then add the credit line as the caption with update_media. Reading only; nothing is uploaded.
send_password_reset
ChatGPTCreate a one-time WordPress password-reset link for a user. No password is returned or accepted. Requires owner approval.
set_alt_texts
ChatGPTSave alt text for up to 50 images on one site in a single owner approval. Each item names an attachment_id and its alt text (one sentence describing the image). Previous alt text is kept so the change can be undone.
set_custom_fields
ChatGPTChange Advanced Custom Fields (ACF) on a post, page or custom post type item by field name. Read them first with get_custom_fields: only fields that apply to the item can be set, values must fit the field type (choices for selects, IDs for images and linked posts, a list of row objects for repeaters), and null clears a field. The previous values are kept so the change can be undone. Waits for the owner's approval unless this connection is set to Auto-approve.
set_featured_image
ChatGPTSet or remove the featured image on an existing post or page
set_post_meta
ChatGPTSet one post or page metadata field to the exact value, replacing its existing value. Supports Rank Math and Yoast SEO fields; does not recalculate scores. Requires owner approval.
set_seo
ChatGPTChange SEO fields on a post or page through the site's SEO plugin. Send only the fields to change in fields, and list fields to empty in clear. Read them first with get_seo to see the active plugin and supported fields. robots_noindex=true hides the page from search engines, so only set it when the user asks. The previous values are kept so the change can be undone. Does not guarantee rankings or recalculate plugin scores. Requires owner approval.
switch_theme
ChatGPTSwitch the active theme on a site
toggle_plugin
ChatGPTActivate or deactivate a plugin on a site. Deactivating can change site behavior — be sure the user asked for it.
undo_action
ChatGPTReverse one approved change from the last 30 days, using the action_id from list_undoable_actions or the confirmation_id of the original request. The reverse change goes through owner approval like any other change. Changes that were already undone, or that are older than 30 days, cannot be undone here.
update_agent
ChatGPTUpdate the CMDPress agent plugin on a site to the latest version (requires remote management enabled on the site).
update_all
ChatGPTUpdate WordPress core, all plugins, and all themes on a site in one operation. Consider run_backup first.
update_block_design
ChatGPTReplace the whole block design of an existing page, post or custom post type item: the full new serialized blocks (content) and, for Greenshift/GreenLight, the full new page CSS (greenshift_css) in one change. Read it first with get_block_design and pass its design_hash as expected_hash; a design changed since then is refused. Omit greenshift_css to keep the page CSS; an empty string clears it. Blocks must be registered on the site. New scripts, inline event handlers, javascript: links and embedded pages are refused; script blocks already on the page are kept when sent back unchanged. A revision holding the old content and CSS is saved first, so undo_action puts both back; or pass revision_id alone to restore one. Page-builder pages are refused. Waits for the owner's approval unless this connection is set to Auto-approve.
update_media
ChatGPTChange an uploaded image's alt text, title, caption or description. Send only the fields to change; an empty string clears one. Alt text should describe the image for someone who cannot see it, in one sentence. The previous values are kept for undo. Requires owner approval.
update_page
ChatGPTUpdate an existing page
update_plugin
ChatGPTUpdate a specific plugin on a site
update_post
ChatGPTUpdate an existing post
update_site_settings
ChatGPTChange core WordPress settings. Send only the settings to change; others stay as they are. Changing the permalink structure changes every URL on the site. Requires owner approval.
update_theme
ChatGPTUpdate a specific theme on a site
update_wordpress_core
ChatGPTUpdate WordPress core on a site
upload_media
ChatGPTUpload a raster image to the WordPress media library from a direct public HTTPS URL. Returns attachment_id and url.