npm - @mangerik/wordpress-mcp - Versions diffs - 0.1.0 → 0.1.1 - Mend

@mangerik/wordpress-mcp 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/docs/TOOLS.md ADDED Viewed

@@ -0,0 +1,1458 @@
+# Tool Reference
+_This file is auto-generated by `scripts/gen-tools-doc.mjs`. Last regenerated: 96 tools._
+Each tool ships a JSON Schema; clients (Claude Desktop, Kiro, etc.) read it automatically. This document is a human-readable summary.
+## Table of contents
+- [🏠 Site & discovery](#site-discovery) (6)
+- [📝 Posts](#posts) (6)
+- [📄 Pages](#pages) (5)
+- [🖼️ Media](#media) (6)
+- [💬 Comments](#comments) (5)
+- [🏷️ Taxonomies (categories & tags)](#taxonomies-categories-tags) (10)
+- [👤 Users](#users) (6)
+- [🧰 Generic CPT / plugin namespaces](#generic-cpt-plugin-namespaces) (5)
+- [🛒 WooCommerce](#woocommerce) (19)
+- [📈 SEO (Yoast & Rank Math)](#seo-yoast-rank-math) (6)
+- [🧱 Block themes (WP 5.9+)](#block-themes-wp-59) (12)
+- [🌐 Multisite](#multisite) (7)
+- [📦 Batch operations](#batch-operations) (2)
+- [🔐 JWT diagnostics](#jwt-diagnostics) (1)
+## 🏠 Site & discovery
+### `wp_site_info`
+**Site info**
+Get the REST API root index: site name, description, namespaces, and discovered routes. Use this to detect WooCommerce, Yoast, or other plugins exposing REST endpoints.
+_Hints: read-only, idempotent, network call_
+_(no arguments)_
+### `wp_get_settings`
+**Get site settings**
+Get WordPress site settings (requires manage_options).
+_Hints: read-only, idempotent, network call_
+_(no arguments)_
+### `wp_update_settings`
+**Update site settings**
+Update site settings such as title, description, timezone, or default category. Use with caution.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `title` | string |  |  |
+| `description` | string |  |  |
+| `url` | string (uri) |  |  |
+| `email` | string (email) |  |  |
+| `timezone` | string |  |  |
+| `date_format` | string |  |  |
+| `time_format` | string |  |  |
+| `start_of_week` | number |  |  |
+| `language` | string |  |  |
+| `use_smilies` | boolean |  |  |
+| `default_category` | number |  |  |
+| `default_post_format` | string |  |  |
+| `posts_per_page` | number |  |  |
+| `default_ping_status` | `"open"` \| `"closed"` |  |  |
+| `default_comment_status` | `"open"` \| `"closed"` |  |  |
+### `wp_get_post_types`
+**List post types**
+List registered post types (post, page, attachment, plus any custom post types).
+_Hints: read-only, idempotent, network call_
+_(no arguments)_
+### `wp_get_taxonomies`
+**List taxonomies**
+List registered taxonomies (category, post_tag, plus custom taxonomies).
+_Hints: read-only, idempotent, network call_
+_(no arguments)_
+### `wp_search`
+**Search content**
+Universal search across posts, pages, and other public content via /wp/v2/search.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `query` | string | ✓ |  |
+| `type` | `"post"` \| `"term"` \| `"post-format"` |  |  |
+| `subtype` | string |  | Post type slug or taxonomy slug |
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+## 📝 Posts
+### `wp_get_posts`
+**List posts**
+List WordPress posts with filters. Use `_fields` to keep responses small (e.g. 'id,title,slug').
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `status` | `"publish"` \| `"draft"` \| `"private"` \| `"pending"` \| `"future"` \| `"any"` |  |  |
+| `categories` | number[] |  |  |
+| `tags` | number[] |  |  |
+| `author` | number |  |  |
+| `orderby` | `"date"` \| `"id"` \| `"title"` \| `"modified"` \| `"relevance"` \| `"rand"` \| `"slug"` |  |  |
+| `order` | `"asc"` \| `"desc"` |  |  |
+| `after` | string |  | ISO8601 lower bound (inclusive) |
+| `before` | string |  | ISO8601 upper bound (inclusive) |
+| `slug` | string[] |  |  |
+| `_fields` | string |  |  |
+| `_embed` | boolean |  |  |
+| `context` | `"view"` \| `"edit"` |  |  |
+### `wp_get_post`
+**Get a post**
+Get a single WordPress post by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `context` | `"view"` \| `"edit"` |  |  |
+| `_fields` | string |  |  |
+| `_embed` | boolean |  |  |
+### `wp_create_post`
+**Create a post**
+Create a new WordPress post. Defaults to status=draft for safety. Set `meta` to write custom fields (must be registered server-side).
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `title` | string | ✓ |  |
+| `content` | string | ✓ |  |
+| `excerpt` | string |  |  |
+| `status` | `"publish"` \| `"draft"` \| `"private"` \| `"pending"` \| `"future"` |  |  |
+| `slug` | string |  |  |
+| `categories` | number[] |  |  |
+| `tags` | number[] |  |  |
+| `featured_media` | number |  |  |
+| `date` | string |  |  |
+| `comment_status` | `"open"` \| `"closed"` |  |  |
+| `ping_status` | `"open"` \| `"closed"` |  |  |
+| `format` | `"standard"` \| `"aside"` \| `"chat"` \| `"gallery"` \| `"link"` \| `"image"` \| `"quote"` \| `"status"` \| `"video"` \| `"audio"` |  |  |
+| `sticky` | boolean |  |  |
+| `author` | number |  |  |
+| `meta` | object |  |  |
+### `wp_update_post`
+**Update a post**
+Update an existing WordPress post.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `title` | string |  |  |
+| `content` | string |  |  |
+| `excerpt` | string |  |  |
+| `status` | `"publish"` \| `"draft"` \| `"private"` \| `"pending"` \| `"future"` |  |  |
+| `slug` | string |  |  |
+| `categories` | number[] |  |  |
+| `tags` | number[] |  |  |
+| `featured_media` | number |  |  |
+| `date` | string |  |  |
+| `comment_status` | `"open"` \| `"closed"` |  |  |
+| `ping_status` | `"open"` \| `"closed"` |  |  |
+| `sticky` | boolean |  |  |
+| `author` | number |  |  |
+| `meta` | object |  |  |
+### `wp_delete_post`
+**Delete a post**
+Move a post to trash, or permanently delete with `force=true`. Force-delete is irreversible.
+_Hints: ⚠️ destructive, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `force` | boolean |  | Permanently delete (skip trash). Default false. |
+### `wp_get_post_revisions`
+**List post revisions**
+List revisions of a given post (audit trail).
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `per_page` | number |  |  |
+| `_fields` | string |  |  |
+## 📄 Pages
+### `wp_get_pages`
+**List pages**
+List WordPress pages.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `status` | `"publish"` \| `"draft"` \| `"private"` \| `"pending"` \| `"any"` |  |  |
+| `parent` | number |  |  |
+| `orderby` | `"date"` \| `"id"` \| `"title"` \| `"modified"` \| `"menu_order"` \| `"slug"` |  |  |
+| `order` | `"asc"` \| `"desc"` |  |  |
+| `_fields` | string |  |  |
+| `_embed` | boolean |  |  |
+| `context` | `"view"` \| `"edit"` |  |  |
+### `wp_get_page`
+**Get a page**
+Get a single WordPress page by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `context` | `"view"` \| `"edit"` |  |  |
+| `_fields` | string |  |  |
+| `_embed` | boolean |  |  |
+### `wp_create_page`
+**Create a page**
+Create a new WordPress page (default status=draft).
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `title` | string | ✓ |  |
+| `content` | string | ✓ |  |
+| `excerpt` | string |  |  |
+| `status` | `"publish"` \| `"draft"` \| `"private"` \| `"pending"` |  |  |
+| `slug` | string |  |  |
+| `parent` | number |  |  |
+| `menu_order` | number |  |  |
+| `featured_media` | number |  |  |
+| `template` | string |  |  |
+| `comment_status` | `"open"` \| `"closed"` |  |  |
+| `meta` | object |  |  |
+### `wp_update_page`
+**Update a page**
+Update an existing WordPress page.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `title` | string |  |  |
+| `content` | string |  |  |
+| `excerpt` | string |  |  |
+| `status` | `"publish"` \| `"draft"` \| `"private"` \| `"pending"` |  |  |
+| `slug` | string |  |  |
+| `parent` | number |  |  |
+| `menu_order` | number |  |  |
+| `featured_media` | number |  |  |
+| `template` | string |  |  |
+| `meta` | object |  |  |
+### `wp_delete_page`
+**Delete a page**
+Move a page to trash, or permanently delete with force=true.
+_Hints: ⚠️ destructive, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `force` | boolean |  |  |
+## 🖼️ Media
+### `wp_get_media`
+**List media**
+List WordPress media items (images, videos, files).
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `media_type` | `"image"` \| `"video"` \| `"audio"` \| `"application"` |  |  |
+| `mime_type` | string |  |  |
+| `parent` | number |  |  |
+| `orderby` | `"date"` \| `"id"` \| `"title"` \| `"modified"` \| `"slug"` |  |  |
+| `order` | `"asc"` \| `"desc"` |  |  |
+| `_fields` | string |  |  |
+### `wp_get_media_item`
+**Get a media item**
+Get a single media item by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+### `wp_upload_media_file`
+**Upload media from local file**
+Upload a media file from an absolute local path.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `file_path` | string | ✓ |  |
+| `title` | string |  |  |
+| `alt_text` | string |  |  |
+| `caption` | string |  |  |
+| `description` | string |  |  |
+| `post` | number |  |  |
+### `wp_upload_media_url`
+**Upload media from URL**
+Download a remote file and upload it to WordPress.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `url` | string (uri) | ✓ |  |
+| `title` | string |  |  |
+| `alt_text` | string |  |  |
+| `caption` | string |  |  |
+| `description` | string |  |  |
+| `post` | number |  |  |
+### `wp_update_media`
+**Update media metadata**
+Update metadata of an existing media item.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `title` | string |  |  |
+| `alt_text` | string |  |  |
+| `caption` | string |  |  |
+| `description` | string |  |  |
+| `post` | number |  |  |
+### `wp_delete_media`
+**Delete media**
+Permanently delete a media item. WordPress does not trash media; this is irreversible.
+_Hints: ⚠️ destructive, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `force` | boolean |  |  |
+## 💬 Comments
+### `wp_get_comments`
+**List comments**
+List WordPress comments with filters.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `post` | number |  |  |
+| `status` | `"approved"` \| `"hold"` \| `"spam"` \| `"trash"` \| `"any"` |  |  |
+| `author_email` | string (email) |  |  |
+| `after` | string |  |  |
+| `before` | string |  |  |
+| `orderby` | `"date"` \| `"id"` \| `"post"` |  |  |
+| `order` | `"asc"` \| `"desc"` |  |  |
+| `_fields` | string |  |  |
+### `wp_get_comment`
+**Get a comment**
+Get a single comment by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+### `wp_create_comment`
+**Create a comment**
+Create a comment on a post.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `post` | number | ✓ |  |
+| `content` | string | ✓ |  |
+| `author_name` | string |  |  |
+| `author_email` | string (email) |  |  |
+| `parent` | number |  |  |
+### `wp_update_comment`
+**Update / moderate a comment**
+Update or moderate a comment. Use status to approve / hold / spam / trash.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `content` | string |  |  |
+| `status` | `"approved"` \| `"hold"` \| `"spam"` \| `"trash"` |  |  |
+| `author_name` | string |  |  |
+| `author_email` | string (email) |  |  |
+### `wp_delete_comment`
+**Delete a comment**
+Move a comment to trash, or permanently delete with force=true.
+_Hints: ⚠️ destructive, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `force` | boolean |  |  |
+## 🏷️ Taxonomies (categories & tags)
+### `wp_get_categories`
+**List categories**
+List WordPress categories.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `hide_empty` | boolean |  |  |
+| `parent` | number |  |  |
+| `orderby` | `"id"` \| `"name"` \| `"slug"` \| `"count"` \| `"term_group"` |  |  |
+| `order` | `"asc"` \| `"desc"` |  |  |
+| `_fields` | string |  |  |
+### `wp_get_category`
+**Get a category**
+Get a single category by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+### `wp_create_category`
+**Create a category**
+Create a new category.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `name` | string | ✓ |  |
+| `slug` | string |  |  |
+| `description` | string |  |  |
+| `parent` | number |  |  |
+### `wp_update_category`
+**Update a category**
+Update a category.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `name` | string |  |  |
+| `slug` | string |  |  |
+| `description` | string |  |  |
+| `parent` | number |  |  |
+### `wp_delete_category`
+**Delete a category**
+Delete a category. Categories cannot be trashed; force is required.
+_Hints: ⚠️ destructive, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `force` | boolean |  |  |
+### `wp_get_tags`
+**List tags**
+List WordPress tags.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `hide_empty` | boolean |  |  |
+| `orderby` | `"id"` \| `"name"` \| `"slug"` \| `"count"` |  |  |
+| `order` | `"asc"` \| `"desc"` |  |  |
+| `_fields` | string |  |  |
+### `wp_get_tag`
+**Get a tag**
+Get a single tag by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+### `wp_create_tag`
+**Create a tag**
+Create a new tag.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `name` | string | ✓ |  |
+| `slug` | string |  |  |
+| `description` | string |  |  |
+### `wp_update_tag`
+**Update a tag**
+Update a tag.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `name` | string |  |  |
+| `slug` | string |  |  |
+| `description` | string |  |  |
+### `wp_delete_tag`
+**Delete a tag**
+Delete a tag. Tags cannot be trashed; force is required.
+_Hints: ⚠️ destructive, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `force` | boolean |  |  |
+## 👤 Users
+### `wp_get_users`
+**List users**
+List WordPress users.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `roles` | string[] |  |  |
+| `orderby` | `"id"` \| `"include"` \| `"name"` \| `"registered_date"` \| `"slug"` \| `"email"` \| `"url"` |  |  |
+| `order` | `"asc"` \| `"desc"` |  |  |
+| `_fields` | string |  |  |
+### `wp_get_user`
+**Get a user**
+Get a single user by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+### `wp_get_current_user`
+**Get current user**
+Get the currently authenticated user (the WP_USERNAME used to start this server).
+_Hints: read-only, idempotent, network call_
+_(no arguments)_
+### `wp_create_user`
+**Create a user**
+Create a new WordPress user. Requires the `create_users` capability.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `username` | string | ✓ |  |
+| `email` | string (email) | ✓ |  |
+| `password` | string | ✓ |  |
+| `name` | string |  |  |
+| `first_name` | string |  |  |
+| `last_name` | string |  |  |
+| `url` | string (uri) |  |  |
+| `description` | string |  |  |
+| `roles` | string[] |  |  |
+### `wp_update_user`
+**Update a user**
+Update a user's profile or role.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `email` | string (email) |  |  |
+| `name` | string |  |  |
+| `first_name` | string |  |  |
+| `last_name` | string |  |  |
+| `url` | string (uri) |  |  |
+| `description` | string |  |  |
+| `roles` | string[] |  |  |
+| `password` | string |  |  |
+### `wp_delete_user`
+**Delete a user**
+Permanently delete a user and reassign their content to another user. Always force-deletes (WP requirement).
+_Hints: ⚠️ destructive, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `reassign_to` | number | ✓ | User ID to receive the deleted user's content. |
+## 🧰 Generic CPT / plugin namespaces
+### `wp_list_items`
+**Generic list (any REST route)**
+List items from any REST collection route (CPT, custom taxonomy, plugin namespace). Pass plugin/CPT-specific params via `query`.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `route` | string | ✓ | REST route, e.g. 'wp/v2/product' or 'wc/v3/products' |
+| `query` | object |  | Query string parameters as key/value pairs |
+### `wp_get_item`
+**Generic get (any REST route)**
+Get a single item from any REST route by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `route` | string | ✓ |  |
+| `id` | number | ✓ |  |
+| `query` | object |  |  |
+### `wp_create_item`
+**Generic create (any REST route)**
+Create an item on any REST route. Use `wp_get_post_types` to find supported CPT slugs.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `route` | string | ✓ |  |
+| `body` | object | ✓ |  |
+### `wp_update_item`
+**Generic update (any REST route)**
+Update an item on any REST route by ID.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `route` | string | ✓ |  |
+| `id` | number | ✓ |  |
+| `body` | object | ✓ |  |
+### `wp_delete_item`
+**Generic delete (any REST route)**
+Delete an item on any REST route. Many endpoints require force=true.
+_Hints: ⚠️ destructive, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `route` | string | ✓ |  |
+| `id` | number | ✓ |  |
+| `force` | boolean |  |  |
+## 🛒 WooCommerce
+### `wc_list_products`
+**WC: list products**
+List WooCommerce products with filters.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `status` | `"any"` \| `"draft"` \| `"pending"` \| `"private"` \| `"publish"` |  |  |
+| `type` | `"simple"` \| `"grouped"` \| `"external"` \| `"variable"` |  |  |
+| `category` | string |  | Category slug |
+| `tag` | string |  | Tag slug |
+| `sku` | string |  |  |
+| `featured` | boolean |  |  |
+| `on_sale` | boolean |  |  |
+| `min_price` | string |  |  |
+| `max_price` | string |  |  |
+| `stock_status` | `"instock"` \| `"outofstock"` \| `"onbackorder"` |  |  |
+| `orderby` | `"date"` \| `"id"` \| `"include"` \| `"title"` \| `"slug"` \| `"price"` \| `"popularity"` \| `"rating"` |  |  |
+| `order` | `"asc"` \| `"desc"` |  |  |
+| `after` | string |  |  |
+| `before` | string |  |  |
+| `_fields` | string |  |  |
+### `wc_get_product`
+**WC: get product**
+Get a single product by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+### `wc_create_product`
+**WC: create product**
+Create a new WooCommerce product.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `name` | string | ✓ |  |
+| `type` | `"simple"` \| `"grouped"` \| `"external"` \| `"variable"` |  |  |
+| `regular_price` | string |  |  |
+| `sale_price` | string |  |  |
+| `description` | string |  |  |
+| `short_description` | string |  |  |
+| `sku` | string |  |  |
+| `status` | `"draft"` \| `"pending"` \| `"private"` \| `"publish"` |  |  |
+| `featured` | boolean |  |  |
+| `catalog_visibility` | `"visible"` \| `"catalog"` \| `"search"` \| `"hidden"` |  |  |
+| `manage_stock` | boolean |  |  |
+| `stock_quantity` | number |  |  |
+| `stock_status` | `"instock"` \| `"outofstock"` \| `"onbackorder"` |  |  |
+| `weight` | string |  |  |
+| `dimensions` | object |  |  |
+| `categories` | object[] |  |  |
+| `tags` | object[] |  |  |
+| `images` | object[] |  |  |
+| `attributes` | object[] |  |  |
+| `meta_data` | object[] |  |  |
+### `wc_update_product`
+**WC: update product**
+Update a WooCommerce product.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `name` | string | ✓ |  |
+| `type` | `"simple"` \| `"grouped"` \| `"external"` \| `"variable"` |  |  |
+| `regular_price` | string |  |  |
+| `sale_price` | string |  |  |
+| `description` | string |  |  |
+| `short_description` | string |  |  |
+| `sku` | string |  |  |
+| `status` | `"draft"` \| `"pending"` \| `"private"` \| `"publish"` |  |  |
+| `featured` | boolean |  |  |
+| `catalog_visibility` | `"visible"` \| `"catalog"` \| `"search"` \| `"hidden"` |  |  |
+| `manage_stock` | boolean |  |  |
+| `stock_quantity` | number |  |  |
+| `stock_status` | `"instock"` \| `"outofstock"` \| `"onbackorder"` |  |  |
+| `weight` | string |  |  |
+| `dimensions` | object |  |  |
+| `categories` | object[] |  |  |
+| `tags` | object[] |  |  |
+| `images` | object[] |  |  |
+| `attributes` | object[] |  |  |
+| `meta_data` | object[] |  |  |
+### `wc_delete_product`
+**WC: delete product**
+Delete a WooCommerce product. force=true is irreversible (skips trash).
+_Hints: ⚠️ destructive, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `force` | boolean |  |  |
+### `wc_list_variations`
+**WC: list product variations**
+List variations of a variable product.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `product_id` | number | ✓ |  |
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `_fields` | string |  |  |
+### `wc_create_variation`
+**WC: create product variation**
+Create a variation under a variable product.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `product_id` | number | ✓ |  |
+| `regular_price` | string |  |  |
+| `sale_price` | string |  |  |
+| `sku` | string |  |  |
+| `stock_quantity` | number |  |  |
+| `attributes` | object[] |  |  |
+| `image` | object |  |  |
+### `wc_list_product_categories`
+**WC: list product categories**
+List WooCommerce product categories.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `hide_empty` | boolean |  |  |
+| `parent` | number |  |  |
+| `orderby` | `"id"` \| `"include"` \| `"name"` \| `"slug"` \| `"term_group"` \| `"description"` \| `"count"` |  |  |
+| `order` | `"asc"` \| `"desc"` |  |  |
+### `wc_list_orders`
+**WC: list orders**
+List WooCommerce orders.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `status` | `"any"` \| `"pending"` \| `"processing"` \| `"on-hold"` \| `"completed"` \| `"cancelled"` \| `"refunded"` \| `"failed"` \| `"trash"` |  |  |
+| `customer` | number |  |  |
+| `product` | number |  |  |
+| `after` | string |  |  |
+| `before` | string |  |  |
+| `orderby` | `"date"` \| `"id"` \| `"include"` \| `"title"` \| `"slug"` |  |  |
+| `order` | `"asc"` \| `"desc"` |  |  |
+| `_fields` | string |  |  |
+### `wc_get_order`
+**WC: get order**
+Get a single order by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+### `wc_update_order`
+**WC: update order**
+Update an order — most commonly used to change status.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `status` | `"any"` \| `"pending"` \| `"processing"` \| `"on-hold"` \| `"completed"` \| `"cancelled"` \| `"refunded"` \| `"failed"` \| `"trash"` |  |  |
+| `customer_note` | string |  |  |
+| `transaction_id` | string |  |  |
+| `meta_data` | object[] |  |  |
+### `wc_create_order_note`
+**WC: add note to an order**
+Add a note (private or customer-facing) to an order.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `order_id` | number | ✓ |  |
+| `note` | string | ✓ |  |
+| `customer_note` | boolean |  | If true, visible to customer. |
+### `wc_create_refund`
+**WC: create order refund**
+Create a refund for an order.
+_Hints: ⚠️ destructive, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `order_id` | number | ✓ |  |
+| `amount` | string | ✓ | Refund amount as decimal string, e.g. '12.50' |
+| `reason` | string |  |  |
+| `api_refund` | boolean |  | Trigger payment gateway refund. |
+| `line_items` | object[] |  |  |
+### `wc_list_customers`
+**WC: list customers**
+List WooCommerce customers.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `email` | string (email) |  |  |
+| `role` | string |  |  |
+| `orderby` | `"id"` \| `"include"` \| `"name"` \| `"registered_date"` |  |  |
+| `order` | `"asc"` \| `"desc"` |  |  |
+### `wc_get_customer`
+**WC: get customer**
+Get a single customer by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+### `wc_list_coupons`
+**WC: list coupons**
+List WooCommerce coupons.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `code` | string |  |  |
+### `wc_create_coupon`
+**WC: create coupon**
+Create a new coupon.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `code` | string | ✓ |  |
+| `discount_type` | `"percent"` \| `"fixed_cart"` \| `"fixed_product"` |  |  |
+| `amount` | string |  |  |
+| `individual_use` | boolean |  |  |
+| `exclude_sale_items` | boolean |  |  |
+| `minimum_amount` | string |  |  |
+| `maximum_amount` | string |  |  |
+| `usage_limit` | number |  |  |
+| `usage_limit_per_user` | number |  |  |
+| `date_expires` | string |  |  |
+| `product_ids` | number[] |  |  |
+| `excluded_product_ids` | number[] |  |  |
+| `free_shipping` | boolean |  |  |
+| `description` | string |  |  |
+### `wc_get_sales_report`
+**WC: sales report**
+Get a sales summary report.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `period` | `"week"` \| `"month"` \| `"last_month"` \| `"year"` |  |  |
+| `date_min` | string |  | ISO date YYYY-MM-DD |
+| `date_max` | string |  | ISO date YYYY-MM-DD |
+### `wc_get_top_sellers`
+**WC: top sellers report**
+Get top-selling products.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `period` | `"week"` \| `"month"` \| `"last_month"` \| `"year"` |  |  |
+| `date_min` | string |  |  |
+| `date_max` | string |  |  |
+## 📈 SEO (Yoast & Rank Math)
+### `seo_get_meta`
+**Get SEO meta (Yoast / Rank Math)**
+Read SEO meta (title, description, focus keyword, robots, OG, Twitter) for a post or page. Specify which SEO plugin you use.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `plugin` | `"yoast"` \| `"rank_math"` | ✓ |  |
+| `post_type` | `"post"` \| `"page"` |  |  |
+| `id` | number | ✓ |  |
+### `seo_set_meta`
+**Set SEO meta (Yoast / Rank Math)**
+Write SEO meta (title, description, focus keyword, robots, OG, Twitter) to a post or page via the chosen SEO plugin's meta keys. NOTE: the meta keys must be exposed via REST (Yoast does this automatically; Rank Math may require enabling REST API in plugin settings).
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `plugin` | `"yoast"` \| `"rank_math"` | ✓ |  |
+| `post_type` | `"post"` \| `"page"` |  |  |
+| `id` | number | ✓ |  |
+| `title` | string |  | SEO title tag |
+| `description` | string |  | Meta description |
+| `focus_keyword` | string |  |  |
+| `canonical` | string (uri) |  |  |
+| `noindex` | boolean |  |  |
+| `nofollow` | boolean |  |  |
+| `og_title` | string |  |  |
+| `og_description` | string |  |  |
+| `og_image` | string (uri) |  |  |
+| `twitter_title` | string |  |  |
+| `twitter_description` | string |  |  |
+| `twitter_image` | string (uri) |  |  |
+### `yoast_get_head`
+**Yoast: get rendered SEO head HTML**
+Use Yoast's /yoast/v1/get_head endpoint to fetch the rendered <head> HTML for a given URL — useful for previewing what search engines will see.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `url` | string (uri) | ✓ |  |
+### `yoast_indexable_for_post`
+**Yoast: get post 'indexable' (computed SEO snapshot)**
+Read the Yoast indexable record (title, description, canonical, breadcrumbs) for a post via /yoast/v1/indexable.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+### `rankmath_list_redirections`
+**Rank Math: list redirections**
+List Rank Math redirection rules (requires Rank Math Pro REST API enabled).
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `status` | `"any"` \| `"active"` \| `"inactive"` |  |  |
+### `rankmath_create_redirection`
+**Rank Math: create redirection**
+Create a redirection rule.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `sources` | object[] | ✓ |  |
+| `url_to` | string | ✓ |  |
+| `header_code` | `"301"` \| `"302"` \| `"307"` \| `"410"` \| `"451"` |  |  |
+| `status` | `"active"` \| `"inactive"` |  |  |
+## 🧱 Block themes (WP 5.9+)
+### `wp_list_templates`
+**Block themes: list templates**
+List block theme templates (wp_template). IDs look like 'theme//slug'.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `theme` | string |  | Filter by theme slug |
+| `area` | string |  | Filter by template area (e.g. 'header') |
+| `post_type` | string |  | Filter by post type the template applies to |
+| `_fields` | string |  |  |
+### `wp_get_template`
+**Block themes: get template**
+Get a single template by 'theme//slug' ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | string | ✓ |  |
+### `wp_update_template`
+**Block themes: update template**
+Update a block template by 'theme//slug' ID. Pass content (block markup) and/or title/description.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | string | ✓ |  |
+| `content` | string |  |  |
+| `title` | string |  |  |
+| `description` | string |  |  |
+| `status` | `"publish"` \| `"draft"` \| `"auto-draft"` \| `"trash"` |  |  |
+### `wp_list_template_parts`
+**Block themes: list template parts**
+List template parts (wp_template_part), e.g. header / footer fragments.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `theme` | string |  |  |
+| `area` | string |  |  |
+| `_fields` | string |  |  |
+### `wp_get_template_part`
+**Block themes: get template part**
+Get a single template part by 'theme//slug' ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | string | ✓ |  |
+### `wp_update_template_part`
+**Block themes: update template part**
+Update a template part by 'theme//slug' ID.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | string | ✓ |  |
+| `content` | string |  |  |
+| `title` | string |  |  |
+| `description` | string |  |  |
+| `area` | string |  |  |
+### `wp_list_block_patterns`
+**Block themes: list patterns**
+List block patterns (registered via PHP, theme.json, or pattern directory).
+_Hints: read-only, idempotent, network call_
+_(no arguments)_
+### `wp_list_block_pattern_categories`
+**Block themes: list pattern categories**
+List the categories used to group block patterns.
+_Hints: read-only, idempotent, network call_
+_(no arguments)_
+### `wp_list_block_types`
+**Block themes: list block types**
+List registered Gutenberg block types.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `namespace` | string |  | Filter by block namespace, e.g. 'core' |
+### `wp_get_global_styles`
+**Block themes: get global styles for a theme**
+Get the active global styles record (theme.json overrides) for a given stylesheet.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `stylesheet` | string | ✓ | Theme stylesheet slug, e.g. 'twentytwentyfour' |
+### `wp_list_menus`
+**Menus: list**
+List navigation menus.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `_fields` | string |  |  |
+### `wp_list_menu_items`
+**Menus: list items**
+List items inside menus, optionally filtered by menu ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `menus` | number[] |  |  |
+| `per_page` | number |  |  |
+| `_fields` | string |  |  |
+## 🌐 Multisite
+### `ms_list_sites`
+**Multisite: list sites**
+List all sites in the network. Requires a Multisite REST plugin to be installed. Returns 404 (rest_no_route) on plain core WP.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+| `search` | string |  |  |
+| `network` | number |  |  |
+| `_fields` | string |  |  |
+### `ms_get_site`
+**Multisite: get site**
+Get a single network site by blog ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+### `ms_create_site`
+**Multisite: create site**
+Create a new site (subsite) in the network. Field names follow the multisite-rest-api plugin conventions; adjust if your plugin differs.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `domain` | string | ✓ |  |
+| `path` | string |  |  |
+| `title` | string |  |  |
+| `network_id` | number |  |  |
+| `meta` | object |  |  |
+### `ms_update_site`
+**Multisite: update site**
+Update a network site by blog ID.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `domain` | string |  |  |
+| `path` | string |  |  |
+| `title` | string |  |  |
+| `meta` | object |  |  |
+### `ms_delete_site`
+**Multisite: delete site**
+Delete a network site. Always destructive — there is no trash for sites.
+_Hints: ⚠️ destructive, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+| `force` | boolean |  |  |
+### `ms_list_networks`
+**Multisite: list networks**
+List networks (multi-network installs). Same plugin requirement as sites.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `page` | number |  |  |
+| `per_page` | number |  |  |
+### `ms_get_network`
+**Multisite: get network**
+Get a single network by ID.
+_Hints: read-only, idempotent, network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `id` | number | ✓ |  |
+## 📦 Batch operations
+### `wp_batch_options`
+**Batch: discover capabilities**
+OPTIONS /batch/v1 — returns the maximum requests per batch and accepted methods.
+_Hints: read-only, idempotent, network call_
+_(no arguments)_
+### `wp_batch`
+**Batch: execute write operations in one round-trip**
+POST /batch/v1 — execute multiple write operations in a single request. GET is not supported. Use validation='require-all-validate' to abort the whole batch if any request is invalid.
+_Hints: network call_
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `validation` | `"normal"` \| `"require-all-validate"` |  |  |
+| `requests` | object[] | ✓ | Up to ~25 by default; some sites raise the cap. Check wp_batch_options. |
+## 🔐 JWT diagnostics
+### `wp_jwt_validate`
+**JWT: validate current token**
+POST /jwt-auth/v1/token/validate — confirms the JWT in use is valid. Only useful in JWT auth mode.
+_Hints: read-only, idempotent, network call_
+_(no arguments)_