wp-mcp-gateway 0.1.0 → 0.1.2

package/dist/index.js

@@ -14,7 +14,7 @@ async function main() {
     const config = loadConfig();
     const server = new McpServer({
         name: "wp-mcp-gateway",
-        version: "0.1.0",
+        version: "0.1.2",
     });
     const client = new PluginApiClient(config);
     const policy = new PolicyService(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wp-mcp-gateway",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "description": "MCP server for managing WordPress content from Claude Desktop — create posts, upload images, manage SEO, and publish without ever opening WordPress.",
   "main": "dist/index.js",
@@ -14,7 +14,7 @@
   ],
   "scripts": {
     "dev": "tsx src/index.ts",
-    "build": "tsc -p tsconfig.json && cp -r src/guides dist/guides",
+    "build": "tsc -p tsconfig.json && rm -rf dist/guides && cp -r src/guides dist/guides",
     "start": "node dist/index.js",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -40,10 +40,10 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.17.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
     "dotenv": "^17.3.1",
     "markdown-it": "^14.1.1",
-    "zod": "^3.23.8"
+    "zod": "^3.25.0"
   },
   "devDependencies": {
     "@types/markdown-it": "^14.1.2",

package/dist/guides/guides/generic-guide.md

@@ -1,204 +0,0 @@
-# Generic WordPress Content Format Guide
-
-## Overview
-For standard WordPress sites without custom shortcodes, use plain HTML or Gutenberg block markup. No special theme-specific shortcuts—just semantic HTML.
-
-## Content Formats Supported
-
-### Option 1: HTML (Recommended for Simplicity)
-```html
-<p>Regular paragraph text.</p>
-
-<h2>Heading</h2>
-
-<p>More paragraph text with <strong>bold</strong> and <em>italic</em>.</p>
-
-<ul>
-  <li>List item 1</li>
-  <li>List item 2</li>
-</ul>
-
-<img src="https://..." alt="Image description">
-
-<a href="https://...">Link text</a>
-
-<blockquote>Quote text</blockquote>
-```
-
-Use `content_format: "html"` with this approach.
-
-### Option 2: Markdown (Auto-Converted to HTML)
-```markdown
-# Heading 1
-
-## Heading 2
-
-Regular paragraph text with **bold** and *italic*.
-
-- List item 1
-- List item 2
-
-[Link text](https://...)
-
-> Blockquote text
-
-![Image description](https://...)
-```
-
-Use `content_format: "markdown"` with this approach.
-
-### Option 3: Gutenberg Block Markup
-```html
-<!-- wp:paragraph -->
-<p>Paragraph content</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading {"level":2} -->
-<h2>Heading</h2>
-<!-- /wp:heading -->
-
-<!-- wp:image {"id":123,"sizeSlug":"large"} -->
-<figure class="wp-block-image size-large">
-  <img src="https://..." alt=""/>
-</figure>
-<!-- /wp:image -->
-
-<!-- wp:list -->
-<ul>
-  <li>Item 1</li>
-  <li>Item 2</li>
-</ul>
-<!-- /wp:list -->
-```
-
-Use `content_format: "html"` with this approach.
-
-## Common HTML Elements
-
-### Headings
-```html
-<h1>Page Title</h1>
-<h2>Section Heading</h2>
-<h3>Subsection</h3>
-<h4>Small Heading</h4>
-```
-
-### Text Formatting
-```html
-<p>Regular paragraph.</p>
-<strong>Bold text</strong>
-<em>Italic text</em>
-<u>Underlined text</u>
-<code>Code snippet</code>
-```
-
-### Lists
-```html
-<ul>
-  <li>Unordered item 1</li>
-  <li>Unordered item 2</li>
-</ul>
-
-<ol>
-  <li>Ordered item 1</li>
-  <li>Ordered item 2</li>
-</ol>
-```
-
-### Images
-```html
-<img src="https://example.com/image.jpg" alt="Image description">
-
-<!-- Or with figure element -->
-<figure>
-  <img src="https://example.com/image.jpg" alt="">
-  <figcaption>Optional image caption</figcaption>
-</figure>
-```
-
-### Links
-```html
-<a href="https://example.com">Link text</a>
-<a href="https://example.com" target="_blank">External link</a>
-```
-
-### Blockquote
-```html
-<blockquote>
-  <p>Quote text here</p>
-  <cite>— Author Name</cite>
-</blockquote>
-```
-
-### Separator/Divider
-```html
-<hr>
-```
-
-## Image Workflow
-
-### Selecting images from the media library
-1. Call `wp_search_media` with relevant keywords
-2. **Display the thumbnail URLs visually** — show the images inline so the user can see their options
-3. Present as numbered choices with titles and dimensions
-4. The user picks by number, or drops a new image into the chat
-
-### Uploading new images
-- **User drops image in chat**: Read the file, base64-encode it, call `wp_upload_media`
-- **Image at a URL**: Call `wp_upload_media_from_url` (server-side download)
-- Use the returned source_url in `<img src="RETURNED_URL" alt="description">`
-
-### Featured image
-- Call `wp_set_featured_image` with the media ID (separate from inline content images)
-
-## Simple Content Template
-
-```html
-<h1>Post Title</h1>
-
-<p>Opening paragraph introducing the topic.</p>
-
-<h2>First Section</h2>
-
-<p>Section content goes here. Use natural paragraphs.</p>
-
-<img src="https://..." alt="Relevant image">
-
-<h2>Second Section</h2>
-
-<p>More content.</p>
-
-<ul>
-  <li>Key point 1</li>
-  <li>Key point 2</li>
-  <li>Key point 3</li>
-</ul>
-
-<h2>Conclusion</h2>
-
-<p>Closing thoughts.</p>
-```
-
-## Content Format Selection
-
-- **`content_format: "html"`** — Use for HTML, Gutenberg blocks, or mixed content
-- **`content_format: "markdown"`** — Use for markdown-formatted content (will auto-convert to HTML)
-- **`content_format: "auto"`** — WordPress auto-detects format (usually works fine)
-
-## Pro Tips
-
-- **Keep it semantic**: Use proper HTML tags (h1-h6 for headings, p for paragraphs, etc.)
-- **Alt text required**: Always include `alt` attribute on images for accessibility
-- **Link target**: Use `target="_blank"` for external links only
-- **No inline styles**: Let WordPress/theme handle styling via CSS classes
-- **Use lists**: Break up text with lists for readability
-- **Short paragraphs**: 2-4 sentences per paragraph is ideal for web reading
-
-## When to Use Custom Theme Guides
-
-If the WordPress site uses:
-- **XMPro + Flatsome theme** → Use `xmpro-post-guide.md` or `xmpro-page-guide.md`
-- **Custom shortcodes** → Ask the user for theme/plugin documentation
-- **Gutenberg patterns** → This generic guide works fine
-
-Otherwise, this generic HTML approach works for any WordPress site.

package/dist/guides/guides/xmpro-page-guide.md

@@ -1,342 +0,0 @@
-# XMPro Page Format Guide
-
-## Overview
-XMPro pages using Flatsome are **layout-driven**. Nearly the entire page is built with shortcodes organized in a strict hierarchy: sections contain rows, rows contain columns, columns contain content.
-
-**Critical:** Use `content_format: "html"` for all pages with shortcodes.
-
-## Layout Hierarchy
-
-```
-[section] ← Full-width container with background, padding, video/parallax
-  ↓
-[row] ← Horizontal grid container
-  ↓
-[col] ← Column (width controlled by span)
-  ↓
-[Content blocks: text, images, buttons, etc.]
-```
-
-Nested layouts use `[row_inner]` and `[col_inner]` inside columns.
-
-## Core Section Types
-
-### Hero Section with Video Background
-```
-[section bg_overlay="rgba(0,57,82,0.657)" dark="true" padding="140px" video_mp4="https://..." video_webm="https://..." video_visibility="visible"]
-  [row v_align="middle" h_align="center"]
-    [col span="6" span__sm="12"]
-      [ux_text font_size="2.5" line_height="1.5" text_align="center"]
-        <h1>Hero Headline</h1>
-        <p>Hero subtitle text</p>
-      [/ux_text]
-    [/col]
-  [/row]
-[/section]
-```
-
-**Parameters:**
-- `bg_overlay`: RGBA color overlay (brand dark blue: `rgba(0,57,82,0.657)`)
-- `dark`: "true" for dark text overlay
-- `padding`: "140px" (hero sections typically generous padding)
-- `video_mp4`: Full URL to MP4 video file
-- `video_webm`: Full URL to WebM video file (fallback)
-- `video_visibility`: "visible" to show video background
-
-### Parallax Background Section
-```
-[section bg="MEDIA_ID" bg_size="original" bg_overlay="rgba(0,57,82,0.669)" parallax="3" padding="101px"]
-  [row]
-    [col span="8" span__sm="12"]
-      Content here
-    [/col]
-  [/row]
-[/section]
-```
-
-**Parameters:**
-- `bg`: Media ID for background image
-- `bg_size`: "original", "cover", "contain"
-- `bg_overlay`: RGBA overlay
-- `parallax`: Depth value (1-10, higher = more dramatic)
-- `padding`: Vertical padding
-
-### Solid Color Section
-```
-[section bg="rgb(246,246,246)" padding="60px"]
-  [row]
-    [col span="12"]
-      Content
-    [/col]
-  [/row]
-[/section]
-```
-
-- `bg`: RGB/hex color value
-
-## Grid System
-
-### Row
-```
-[row v_align="middle" h_align="center"]
-  [col span="4" span__sm="12"]...[/col]
-  [col span="4" span__sm="12"]...[/col]
-  [col span="4" span__sm="12"]...[/col]
-[/row]
-```
-
-**Parameters:**
-- `v_align`: "top", "middle", "bottom" (vertical alignment)
-- `h_align`: "left", "center", "right" (row horizontal alignment)
-- `gap`: Space between columns
-
-### Column
-```
-[col span="6" span__sm="12" span__md="10" animate="fadeInUp" visibility="hide-for-small" tooltip="Hover text"]
-  Content
-[/col]
-```
-
-**Parameters:**
-- `span`: Grid units 1-12 (12 = full width, 6 = half, 4 = third)
-- `span__sm`: Mobile override (usually "12")
-- `span__md`: Tablet override
-- `animate`: "fadeInUp", "fadeInLeft", "slideInDown", etc.
-- `visibility`: "hide-for-small", "hide-for-medium", "show-for-small"
-- `tooltip`: Hover tooltip text
-
-### Nested Layouts
-```
-[col span="6" span__sm="12"]
-  [row_inner]
-    [col_inner span="12"]
-      Nested content
-    [/col_inner]
-  [/row_inner]
-[/col]
-```
-
-Use `[row_inner]` and `[col_inner]` for layouts nested inside columns.
-
-## Content Blocks
-
-### Text Block
-```
-[ux_text font_size="2" line_height="1.5" text_align="center"]
-  <h2>Heading</h2>
-  <p>Paragraph text</p>
-[/ux_text]
-```
-
-**Parameters:**
-- `font_size`: 1, 1.5, 2, 2.5, 3
-- `font_size__sm`: Mobile font size
-- `font_size__md`: Tablet font size
-- `line_height`: 1.2, 1.5, 2
-- `text_align`: "left", "center", "right"
-- `color`: RGB, hex, or color name
-
-### Image
-```
-[ux_image id="MEDIA_ID" width="25"]
-
-[ux_image id="MEDIA_ID" image_size="original" lightbox="true"]
-```
-
-**Parameters:**
-- `id`: Media library ID
-- `width`: 10-100 (percentage)
-- `image_size`: "original", "large", "medium", "thumbnail"
-- `lightbox`: "true" for clickable zoom
-
-### Video
-```
-[ux_video url="https://youtube.com/watch?v=VIDEO_ID" height="52%" depth="3"]
-
-[ux_video url="https://vimeo.com/VIDEO_ID" height="400px"]
-```
-
-**Parameters:**
-- `url`: YouTube, Vimeo, or direct video URL
-- `height`: "52%" (relative) or "400px" (absolute)
-- `depth`: Shadow depth (1-10)
-
-### Featured Box
-```
-[featured_box img="MEDIA_ID" img_width="38"]
-  <h3>Feature Title</h3>
-  <p>Feature description text</p>
-[/featured_box]
-```
-
-**Parameters:**
-- `img`: Media ID for icon/image
-- `img_width`: 20-50 (percentage)
-
-### Button
-```
-[button text="Learn More" color="secondary" style="outline" radius="8" link="https://..."]
-
-[button text="Get Started" color="primary" size="larger" radius="8" link="https://..."]
-```
-
-**Parameters:**
-- `text`: Button label
-- `color`: "primary" (dark blue), "secondary" (accent blue), "white"
-- `style`: "filled", "outline", "link"
-- `size`: "smaller", "medium", "larger"
-- `radius`: "0", "4", "8" (border radius px)
-- `link`: URL or internal page link
-
-### Gap
-```
-[gap height="30px"]
-[gap height="60px"]
-```
-
-Vertical spacing between sections.
-
-### Divider
-```
-[divider align="center" width="100%" height="2px"]
-```
-
-**Parameters:**
-- `align`: "left", "center", "right"
-- `width`: "100%", "50%", "200px"
-- `height`: Line thickness (1px, 2px, 3px)
-
-### Reusable Block
-```
-[block id="22415"]
-```
-
-References a saved reusable block by WordPress post ID. Useful for repeated sections (footers, CTAs, etc.).
-
-## XMPro Brand Colors
-
-Use these consistently:
-- **Primary Dark Blue**: `#003952` or `rgb(0,57,82)`
-- **Accent Blue**: `#009fde` or `rgb(0,159,222)`
-- **White**: `rgb(255,255,255)` or `#ffffff`
-- **Light Background**: `rgb(246,246,246)` or `#f6f6f6`
-- **Green Accent**: `rgb(148,228,132)` or `#94e484`
-
-## Common Page Patterns
-
-### Hero + Feature Grid
-```
-[section bg="HERO_IMAGE_ID" bg_overlay="rgba(0,57,82,0.657)" padding="140px"]
-  [row h_align="center"]
-    [col span="8" span__sm="12"]
-      [ux_text font_size="2.5" text_align="center"]<h1>Hero Title</h1>[/ux_text]
-    [/col]
-  [/row]
-[/section]
-
-[section bg="rgb(246,246,246)" padding="60px"]
-  [row h_align="center" gap="20px"]
-    [col span="4" span__sm="12" animate="fadeInUp"]
-      [featured_box img="ICON_ID"]
-        <h3>Feature 1</h3>
-      [/featured_box]
-    [/col]
-    [col span="4" span__sm="12" animate="fadeInUp"]
-      [featured_box img="ICON_ID"]
-        <h3>Feature 2</h3>
-      [/featured_box]
-    [/col]
-    [col span="4" span__sm="12" animate="fadeInUp"]
-      [featured_box img="ICON_ID"]
-        <h3>Feature 3</h3>
-      [/featured_box]
-    [/col]
-  [/row]
-[/section]
-```
-
-### CTA Section
-```
-[section bg="rgb(0,57,82)" padding="80px"]
-  [row h_align="center"]
-    [col span="6" span__sm="12"]
-      [ux_text font_size="2" text_align="center" color="white"]
-        <h2>Ready to Get Started?</h2>
-        <p>Explore XMPro today.</p>
-      [/ux_text]
-      [gap height="20px"]
-      [button text="Learn More" color="secondary" style="filled" link="https://..."]
-    [/col]
-  [/row]
-[/section]
-```
-
-### Stats/Numbers Row
-```
-[row h_align="center" gap="30px"]
-  [col span="3" span__sm="12" text_align="center"]
-    [ux_text font_size="3"]<strong>500+</strong>[/ux_text]
-    <p>Customers</p>
-  [/col]
-  [col span="3" span__sm="12" text_align="center"]
-    [ux_text font_size="3"]<strong>10M+</strong>[/ux_text]
-    <p>Data Points</p>
-  [/col]
-  [col span="3" span__sm="12" text_align="center"]
-    [ux_text font_size="3"]<strong>99.9%</strong>[/ux_text]
-    <p>Uptime</p>
-  [/col]
-  [col span="3" span__sm="12" text_align="center"]
-    [ux_text font_size="3"]<strong>24/7</strong>[/ux_text]
-    <p>Support</p>
-  [/col]
-[/row]
-```
-
-## Image Workflow
-
-### Selecting images from the media library
-1. Call `wp_search_media` with relevant keywords
-2. **Display the thumbnail URLs visually** — fetch each `thumbnail_url` and show the images inline so the user can see their options
-3. Present as numbered choices with titles and dimensions
-4. The user picks by number, or drops a new image into the chat
-
-### Uploading new images
-- **User drops image in chat**: Read the file, base64-encode it, call `wp_upload_media`
-- **Image at a URL**: Call `wp_upload_media_from_url` (server-side download)
-- Use the returned media ID in `[ux_image id="RETURNED_ID"]`, `[section bg="RETURNED_ID"]`, or `[featured_box img="RETURNED_ID"]`
-
-## Page Creation Workflow
-
-1. **Start from a clone** whenever possible: Call `wp_clone_content` to duplicate a similar existing page, then modify. Pages are too complex to build from scratch in most cases.
-2. **Ask the user** what the page is about, what sections they need, and any specific requirements. Use Claude's question feature.
-3. **Search for images**: Proactively call `wp_search_media` and **show thumbnails visually** for section backgrounds, feature icons, etc.
-4. **Create or update the draft**: Use `wp_create_draft` or `wp_update_content` with content_format: "html".
-5. **Set featured image**: Call `wp_set_featured_image`.
-6. **Set Yoast SEO**: Call `wp_update_yoast_metadata`.
-7. **Preview**: Call `wp_get_preview_link` and share the signed URL. This is essential for pages since the shortcode layout can only be judged visually.
-8. **Iterate**: The user reviews the preview in their browser and requests changes.
-9. **Publish**: Call `wp_publish_content` when approved (triggers confirmation flow).
-
-The user should never need to open WordPress. Everything happens in the chat.
-
-## Pro Tips
-
-- **Clone existing pages**: Use `wp_clone_content` to clone similar pages as a starting point. Pages are complex—duplicating structure is faster than building from scratch.
-- **Responsive first**: Always include `span__sm="12"` on columns for mobile single-column layout.
-- **Use reusable blocks**: For repeated elements (CTAs, footers), reference existing `[block id="X"]` blocks to maintain consistency.
-- **Section padding**: Hero sections typically `padding="140px"`, feature sections `padding="60px"`, content sections `padding="40px"`.
-- **Video backgrounds**: Always provide both `video_mp4` and `video_webm` for cross-browser compatibility.
-- **Animations**: Use subtle animations like `animate="fadeInUp"` on columns for visual interest.
-- **Nested rows**: For complex layouts, use `[row_inner]` inside columns.
-- **Show don't tell**: Always show image thumbnails visually rather than just listing metadata.
-- **Preview is king**: Always share the preview link before publishing.
-
-## Content Format Setting
-
-Always use:
-```
-content_format: "html"
-```
-
-This ensures shortcodes are processed correctly and not converted to markdown.

package/dist/guides/guides/xmpro-post-guide.md

@@ -1,176 +0,0 @@
-# XMPro Blog Post Format Guide
-
-## Overview
-XMPro blog posts use the Flatsome theme with a **prose-first** approach. Most content is plain text paragraphs. Flatsome shortcodes are used sparingly for specific layout elements (hero images, spacing, author attribution, and column sections).
-
-**Critical:** Use `content_format: "html"` when content contains shortcodes.
-
-## Content Structure Pattern
-
-```
-[Hero Image - optional]
-  ↓
-[Gap - optional spacing]
-  ↓
-[Body Paragraphs - plain text, no wrapping shortcode]
-  ↓
-[Section breaks with gaps]
-  ↓
-[Multi-column layouts - optional]
-  ↓
-[Author attribution - if needed]
-```
-
-## Core Rules
-
-1. **Body paragraphs are plain text** — Do NOT wrap in shortcodes
-2. **Images at top of post** — Use `[ux_image]` shortcode only for hero/feature images
-3. **Spacing between sections** — Use `[gap]` shortcode
-4. **Section headings** — Plain text (h2, h3, etc.), no shortcode wrapping
-5. **Multi-column content** — Use `[row]` and `[col]` for side-by-side layouts only
-6. **Author box at end** — Use `[testimonial]` shortcode
-
-## Commonly Used Shortcodes
-
-### Hero Image
-```
-[ux_image id="12345" image_size="original"]
-```
-- `id`: WordPress media library ID (upload first, get ID, then use here)
-- `image_size`: "original", "large", "medium", "thumbnail"
-
-### Gap (Spacing)
-```
-[gap]
-[gap height="15px"]
-[gap height="30px"]
-```
-- Default gap height is standard vertical spacing
-- Specify `height` for custom spacing
-
-### Centered Text Section
-```
-[ux_text text_align="center"]
-  Your centered content here
-[/ux_text]
-```
-- `text_align`: "left", "center", "right"
-- Useful for quotes, callouts, or emphasized sections
-
-### Multi-Column Layout
-```
-[row h_align="center"]
-  [col span="4" span__sm="12"]
-    Left column content
-  [/col]
-  [col span="4" span__sm="12"]
-    Right column content
-  [/col]
-[/row]
-```
-- `span`: Grid units (12 = full width, 6 = half, 4 = third)
-- `span__sm`: Mobile width override (usually "12" for full-width on mobile)
-- `h_align`: "left", "center", "right" for row alignment
-
-### Author Attribution
-```
-[testimonial image="4567" stars="0"]
-By Your Name
-Your Title / Company
-[/testimonial]
-```
-- `image`: Media ID for author photo (optional)
-- `stars`: "0" for no star rating (standard for author box)
-- Text inside becomes the author byline
-
-## Minimal Template
-
-```
-[ux_image id="HERO_IMAGE_ID" image_size="original"]
-
-[gap height="30px"]
-
-This is the opening paragraph. Write naturally without shortcodes. XMPro blog posts emphasize clear, readable prose.
-
-This is the second paragraph. Keep paragraphs separated by blank lines naturally.
-
-[gap height="20px"]
-
-## Section Heading
-
-Continue with body paragraphs under each section. Plain text, no wrapping shortcodes.
-
-[gap height="30px"]
-
-[row h_align="center"]
-  [col span="6" span__sm="12"]
-    First column content here
-  [/col]
-  [col span="6" span__sm="12"]
-    Second column content here
-  [/col]
-[/row]
-
-[gap height="40px"]
-
-[testimonial image="AUTHOR_PHOTO_ID" stars="0"]
-By Jane Doe
-Product Manager, XMPro
-[/testimonial]
-```
-
-## Image Workflow
-
-### Selecting images from the media library
-When the user needs an image (featured image, hero image, inline image):
-1. Call `wp_search_media` with relevant keywords
-2. **Display the thumbnail URLs visually** — fetch each `thumbnail_url` and show the images inline in the conversation so the user can see their options
-3. Present them as numbered choices: "Here are matching images:" with the visual thumbnails, titles, and dimensions
-4. Let the user pick by number, or offer: "You can also drop an image into the chat and I'll upload it"
-5. Use the selected media ID in shortcodes or `wp_set_featured_image`
-
-### Uploading new images
-- **User drops image in chat**: Read the file, base64-encode it, call `wp_upload_media` with filename, mime_type, bytes_base64, and alt_text
-- **Image at a URL**: Call `wp_upload_media_from_url` with the URL (server-side download, no base64 needed)
-- After upload, use the returned media ID in `[ux_image id="RETURNED_ID"]` or `wp_set_featured_image`
-
-### Placing images in content
-- Hero image at top of post: `[ux_image id="MEDIA_ID" image_size="original"]`
-- Featured image (thumbnail shown in listings): `wp_set_featured_image` tool
-- Inline image mid-content: Include `[ux_image id="MEDIA_ID"]` directly in the content at the right position
-
-## Content Creation Workflow
-
-Follow this order for a complete post:
-
-1. **Ask the user** what the post is about, who the author should be, and any specific requirements. Use Claude's question feature to gather missing info — make fields optional so the user can say "just go with defaults."
-2. **Find the author**: Call `wp_list_authors` to get available authors. If the user doesn't specify, use the default.
-3. **Find categories/tags**: Call `wp_list_terms` to find relevant categories. Create new terms with `wp_create_term` if needed.
-4. **Search for images**: Proactively call `wp_search_media` with relevant terms and **show the thumbnails visually** so the user can pick a featured image and any inline images.
-5. **Create the draft**: Call `wp_create_draft` with title, content (using shortcodes), excerpt, author, terms, and content_format: "html".
-6. **Set featured image**: Call `wp_set_featured_image` with the chosen media ID.
-7. **Set Yoast SEO**: Call `wp_update_yoast_metadata` with focus keyphrase, meta description, and SEO title.
-8. **Preview**: Call `wp_get_preview_link` and share the signed URL so the user can see exactly how it looks on the live site.
-9. **Iterate**: The user reviews the preview and requests changes. Use `wp_update_content` to adjust.
-10. **Publish**: When the user approves, call `wp_publish_content` (with optional future date for scheduling). This triggers the confirmation token flow.
-
-The user should never need to open WordPress. Everything happens in the chat.
-
-## Pro Tips
-
-- **Don't over-shortcode**: Plain text paragraphs are the norm. Only use shortcodes when layout requires it.
-- **Responsive design**: Always include `span__sm="12"` on columns for mobile single-column layout
-- **Spacing rhythm**: Use gaps consistently (15px, 20px, 30px) to create visual hierarchy
-- **Hero images**: Place them at the very top, before any text
-- **Author attribution**: Usually only at the very end of the post
-- **Show don't tell**: Always show image thumbnails visually rather than just listing metadata
-- **Preview is king**: Always share the preview link before publishing so the user sees the real result
-
-## Content Format Setting
-
-Always use:
-```
-content_format: "html"
-```
-
-This ensures shortcodes are processed correctly and not converted to markdown.