GoPublish

Executes exactly one user-confirmed WordPress export prepared by prepare_wordpress_export. It can save a post, page, or REST-enabled custom post type as draft, pending review, private, published now, or scheduled, using the confirmed editor, taxonomy, media, image filename, and supported SEO choices. A matching unexpired plan_id is required for every status, including draft and pending review; never call this tool directly or change fields after confirmation. Publishing and scheduling require the additional publish permission. A future scheduled_at must include a timezone and is independently verified in the WordPress response.

export_to_wordpress

Discovers the exact REST-enabled post types, custom post types, taxonomies, editor modes, statuses, featured-image support, writable GoPublish SEO metadata fields, media permission, and image-optimization availability for the connected WordPress user. Call this when the user asks what a site supports or when more detailed live choices are needed. Legacy GoPublish plugin connections are reported as unavailable for MCP export until reconnected with a revocable WordPress Application Password.

get_wordpress_export_capabilities

Returns exact term IDs and names for one taxonomy attached to a selected post type. Use get_wordpress_export_capabilities first to obtain the post_type and taxonomy slugs. Supports categories, tags, and REST-enabled custom taxonomies without accepting an arbitrary REST URL.

list_wordpress_terms

Lists the self-hosted WordPress.org sites connected to the signed-in GoPublish account. Use this to obtain an exact site_id before preparing an export when the intended site is not already known. It never returns WordPress credentials or WordPress.com connections.

list_wordpress_sites

Creates a short-lived, user-bound GoPublish link for connecting a new WordPress site, removing a connected site, or reconnecting a site with a new revocable WordPress Application Password. Call this whenever the user asks to add/connect, remove/disconnect, or reconnect a site. For remove or reconnect, first use list_wordpress_sites when needed and pass the exact site_id. This tool does not alter any connection itself; the user reviews and completes the requested action on the returned GoPublish page. Existing MCP clients see completed changes automatically without disconnecting or reconnecting the connector.

manage_wordpress_connections

Plans one export to a self-hosted WordPress post, page, or REST-enabled custom post type. Use this first for every draft, pending-review, private, publish-now, or scheduled export. Pass every choice the user already supplied; the tool checks the selected site’s live capabilities and returns only unresolved relevant decisions. If status was not specified, ask the returned status question instead of assuming draft. It defaults to Gutenberg when available, resolves categories, tags, custom taxonomies, timezone-qualified scheduling, media, image filename conventions, and supported SEO metadata, then returns a compact summary and a short-lived user-bound plan_id only when complete. Apply the answer to upload_wordpress_image.filename when image naming is resolved. Call the planner again with accumulated answers after each user decision. Never invent answers or call export_to_wordpress without a ready plan.

prepare_wordpress_export

Direct idempotent write that uploads exactly one image to the selected WordPress Media Library after user confirmation. A client that can access the complete bytes of a chat attachment or local file may pass the complete canonical image_data_url in this single call. Otherwise, ask the user for a direct public HTTPS image link and use source_url. Never fabricate, truncate, log, print, or reconstruct an incomplete data URL. Supports JPEG, PNG, GIF, or WebP up to 10 MB. optimize_image defaults to true for eligible JPEG, PNG, and WebP images when an optimizer is available; pass false to preserve the original file. Redirects, private-network targets, invalid image bytes, and retries after an uncertain WordPress write are blocked. Returns the media_id and source_url for later featured or inline use.

upload_wordpress_image