Skip to main content
Glama
ars-nova-wordpress-mcp

ars-nova-wordpress-mcp

Official

ars-nova-wordpress-mcp

Local MCP server for managing arsnovasingers.org via the WordPress REST API.

Built for Jonathan Raabe (Marketing Director, Ars Nova Singers) so Claude can read, audit, and (in later phases) update the WordPress site directly.

Phases

Phase

Scope

Status

1

Read-only audit (posts, pages, media, users, plugins, themes, settings, SEO meta)

In progress

2

Content writes (create/update posts + pages, upload media)

Planned

2.5

WPEngine API integration (cache flush, perf metrics, backups)

Deferred until needed

3

Custom Ars Nova endpoints (events, season pages, ACF fields if discovered)

Planned

4

Eval suite (10 read-only complex questions)

Planned

Related MCP server: ItchWPMCP

Setup

1. Generate a WordPress Application Password

  1. Log into wp-admin at https://arsnovasingers.org/wp-admin

  2. Go to Users → Profile

  3. Scroll to Application Passwords

  4. Name it claude-mcp and click Add New Application Password

  5. Copy the 24-character password — WordPress only shows it once

2. Install + build

cd ars-nova-wordpress-mcp
npm install
npm run build

This produces dist/index.js which is the entry point Claude Desktop runs.

3. Add to claude_desktop_config.json

{
  "mcpServers": {
    "ars-nova-wordpress": {
      "command": "node",
      "args": [
        "C:\\Users\\jonra\\Claud Projects\\Ars Nova\\Ars Nova\\ars-nova-wordpress-mcp\\dist\\index.js"
      ],
      "env": {
        "WP_SITE_URL": "https://arsnovasingers.org",
        "WP_USERNAME": "your_wp_username",
        "WP_APP_PASSWORD": "your_24_char_password"
      }
    }
  }
}

Restart Claude Desktop after editing.

4. Smoke test

In a Claude Desktop conversation, ask:

Use the ars-nova-wordpress MCP to call wp_get_site_info.

If it returns the site name, tagline, and WP version, auth is working.

Tool list (Phase 1)

Content

  • wp_list_posts — list posts with filters

  • wp_get_post — fetch one post by ID or slug

  • wp_list_pages — list pages with filters

  • wp_get_page — fetch one page by ID or slug

  • wp_search_content — search across posts and pages

Media

  • wp_list_media — list media library items

  • wp_get_media_item — fetch one media item with full metadata

  • wp_upload_media — add a file by drive_file_id, source_url, base64_content (+ filename, sha256) or file_path, with alt_text, attach_to_post and set_featured_on[]. Wraps ans-ops/v1/media/sideload in the site's ars-nova-media 1.2.0+ plugin (20 MB, jpeg/png/webp/gif/svg/pdf). On the hosted connector file_path is the Cloud Run container, never your PC. Tests: npm test.

Users

  • wp_list_users — list users and their roles

  • wp_get_user — fetch one user by ID

Taxonomy

  • wp_list_categories — list categories

  • wp_list_tags — list tags

Site

  • wp_get_site_info — site name, tagline, WP version, REST namespaces

  • wp_list_themes — installed themes (active flagged)

  • wp_list_plugins — installed plugins (active flagged, version reported)

  • wp_get_settings — general WP settings

  • wp_list_post_types — registered post types (reveals custom post types)

SEO

  • wp_get_seo_meta — auto-detects Yoast / RankMath / AIOSEO and returns the per-page SEO meta

  • wp_audit_alt_text — scans the media library for items missing alt text

Tool conventions

Every tool:

  • Uses snake_case naming with wp_ prefix

  • Validates inputs with Zod (.strict())

  • Supports response_format: "markdown" | "json" (default markdown)

  • Implements pagination with limit, offset, has_more, next_offset

  • Returns both content[] (text) and structuredContent (typed object)

  • Declares MCP annotations: readOnlyHint, destructiveHint, idempotentHint, openWorldHint

  • Truncates responses larger than CHARACTER_LIMIT (25,000) with a clear message

  • Surfaces 401/403/429 errors with actionable next-step guidance

Auth model

WordPress Application Passwords (built into WP 5.6+, no plugin required). Sent as Basic Auth on every request. Application Passwords can be revoked individually from the WP profile page without affecting the user's normal login.

Google sign-in (OAuth) for the hosted connector

Added 2026-11-09 (INFRA-15) so the connector can be added at the Claude organisation level and used from web, desktop and phone. Set all five or none: PUBLIC_URL, GOOGLE_OAUTH_CLIENT_ID, GOOGLE_OAUTH_CLIENT_SECRET, OAUTH_SECRET (32+ random bytes, base64) and OAUTH_ALLOWED_DOMAIN. Register <PUBLIC_URL>/oauth/google/callback as a redirect URI on the Google OAuth client.

Who gets in: a verified Google account in the allowed domain and an MCP_AUTH_IDENTITIES entry with a matching "email", whose WordPress Application Password the session then uses. An entry may have an email and no token (OAuth-only). Unmapped emails are refused unless listed in OAUTH_SHARED_EMAILS (comma-separated; they act as the env-var WordPress account) or OAUTH_UNMAPPED=shared (everyone in the domain does). Static tokens keep working alongside OAuth.

Project structure

ars-nova-wordpress-mcp/
├── package.json
├── tsconfig.json
├── README.md
├── src/
│   ├── index.ts             # Entry point — registers all tools, starts stdio transport
│   ├── constants.ts         # CHARACTER_LIMIT, default limits, API namespace
│   ├── types.ts             # Shared TypeScript interfaces
│   ├── services/
│   │   └── wp-client.ts     # Axios client with auth + shared error handling
│   ├── schemas/
│   │   └── common.ts        # Shared Zod schemas (pagination, response_format)
│   └── tools/
│       ├── content.ts       # Posts, pages, search
│       ├── media.ts         # Media library
│       ├── users.ts         # Users, roles
│       ├── taxonomy.ts      # Categories, tags
│       ├── site.ts          # Site info, themes, plugins, settings, post types
│       └── seo.ts           # SEO meta + alt text audit
└── dist/                    # Build output — entry point: dist/index.js

Available Tools

89 tools
ans_rest_callCall an Ars Nova plugin REST routeA
Destructive

Call any route in one of the Ars Nova plugins' own REST namespaces. Use this for capabilities that have no dedicated tool yet — it means a new plugin endpoint is usable the moment it is deployed, with no connector rebuild.

RESTRICTED BY DESIGN to namespaces we author: ars-nova/v1, ans-ops/v1, ans-notes/v1, ansg/v1. It cannot call wp/v2, wc/v3 or third-party plugin routes — those have their own purpose-built tools with validation this does not provide.

Environment safety: this goes through the same client as every other tool, so it hits whichever site this connector is configured for. Call wp_check_environment first if you are unsure whether you are on DEV or LIVE.

Useful ars-nova/v1 routes (ars-nova-ticketing-bridge v1.4.0):

  • GET tickera/introspect — what is ACTUALLY registered: shortcodes, post types, taxonomies, ticket-product meta keys. Use this instead of assuming.

  • GET tickera/status

  • GET tickera/events | tickera/event/{id}

  • POST tickera/event/{id} — update title/date/location/status

  • DEL tickera/event/{id} — trash (?force=1 to delete)

  • GET tickera/ticket-types | tickera/ticket-type/{id}

  • POST tickera/ticket-type/{id} — update price/status/template/stock/virtual

  • POST tickera/assign-template — { template_id, event_id?, product_ids? }

  • GET tickera/event-categories — the season's "projects"

  • POST tickera/event-categories — { name, slug?, description?, ans_page_id? }

  • POST tickera/event-category/{id} — rename, re-describe, re-link, reassign events

  • GET tickera/attendees — issued tickets

Args:

  • namespace (enum): one of the allowed namespaces. Required.

  • route (string): path within it, no leading slash. Required.

  • method (enum): GET | POST | PUT | PATCH | DELETE. Default GET.

  • query (object): query-string parameters.

  • body (object): JSON body for writes.

  • response_format (enum): markdown | json.

Returns: the endpoint's JSON response verbatim.

Inputs: route (required), namespace (required), body, query, +2 more.

tickera_create_eventCreate Tickera EventA

Create a Tickera event (tc_events). Use for one performance/show date. Defaults to status='draft' so nothing goes public until you're ready. Date accepts any parseable value (e.g. '2026-09-19 19:30'); stored as Tickera's 'Y-m-d H:i'. After creating the event, add ticket tiers with tickera_create_ticket_type.

Inputs: title (required), date, status, end_date, +3 more.

tickera_create_ticket_typeCreate Tickera Ticket TypeA

Create a ticket tier for an event (e.g. Orchestra / Balcony / GA / Student). Creates a WooCommerce product and wires it to the event via the Bridge meta, so it sells through the normal Woo cart/Stripe checkout. Requires an existing event_id (from tickera_create_event or tickera_list_events).

Inputs: name (required), event_id (required), sku, price, +6 more.

tickera_get_eventGet Tickera EventA
Read-only

Get one Tickera event by ID, including its ticket-type products.

Inputs: event_id (required), response_format.

tickera_list_eventsList Tickera EventsA
Read-only

List all Tickera events (tc_events) with their date, location, status, and any linked ticket-type products.

Inputs: response_format.

tickera_list_templatesList Tickera Ticket TemplatesA
Read-only

List Tickera ticket templates (used on PDF/printed tickets). Use to pick a ticket_template ID for tickera_create_ticket_type; if omitted there, the plugin uses the default template.

Inputs: response_format.

tickera_list_ticket_typesList Tickera Ticket TypesA
Read-only

List ticket-type products, optionally filtered to one event_id.

Inputs: event_id, response_format.

tickera_statusTickera Bridge StatusA
Read-only

Check that the Ars Nova Ticketing Bridge plugin is active and that WooCommerce, Tickera, and the Bridge for WooCommerce are all present. Returns the default ticket-template ID. Call this before creating events/tickets.

Inputs: response_format.

wc_create_productCreate WooCommerce ProductA

Create a new WooCommerce product. For Tickera ticket products, set type='simple' and the product will be available for Tickera bridge mapping. Supports simple products with price, description, categories, and images.

Inputs: name (required), sku, type, status, +10 more.

wc_get_settingsGet WooCommerce SettingsA
Read-only

Read a WooCommerce settings group. Groups include: general, products, tax, shipping, checkout (= payments), advanced, email. Returns all setting IDs and their current values for the group.

Inputs: group (required), response_format.

wc_get_system_statusWooCommerce System StatusA
Read-only

Get WooCommerce system status including environment info, database, active plugins, theme, settings, and pages. Use for health checks.

Inputs: response_format.

wc_list_ordersList WooCommerce OrdersA
Read-only

List WooCommerce orders with optional status filter. Returns order ID, status, total, customer info, and line items.

Inputs: page, status, per_page, response_format.

wc_list_payment_gatewaysList WooCommerce Payment GatewaysA
Read-only

List all registered payment gateways and their enabled/disabled status. Shows gateway ID, title, description, enabled state, and method title. Use this to check if Stripe is enabled and in test mode.

Inputs: response_format.

wc_list_productsList WooCommerce ProductsA
Read-only

List WooCommerce products with optional filters. Returns product ID, name, type, status, price, SKU, and stock info.

Inputs: page, type, search, status, +2 more.

wc_list_shipping_zonesList WooCommerce Shipping ZonesA
Read-only

List shipping zones and their methods. Use to verify shipping is disabled or check what zones exist.

Inputs: response_format.

wc_list_tax_classesList WooCommerce Tax ClassesA
Read-only

List available tax classes.

Inputs: response_format.

wc_update_payment_gatewayUpdate WooCommerce Payment GatewayA
Idempotent

Update a payment gateway's settings. Use to enable/disable a gateway or change its title/description. For Stripe test mode keys, Jon handles those directly in WP Admin — this tool can enable/disable the gateway only.

Inputs: gateway_id (required), title, enabled, description, +1 more.

wc_update_productUpdate WooCommerce ProductA
Idempotent

Update an existing WooCommerce product by ID. Only the fields you pass are changed.

Inputs: product_id (required), sku, name, status, +7 more.

wc_update_settingUpdate WooCommerce SettingA
Idempotent

Update a single WooCommerce setting by group and setting ID. Example: group='general', setting_id='woocommerce_currency', value='USD'. Common settings: general: woocommerce_currency, woocommerce_store_address, woocommerce_store_city, woocommerce_default_country, woocommerce_store_postcode, woocommerce_calc_taxes (yes/no) tax: woocommerce_prices_include_tax, woocommerce_tax_based_on, woocommerce_tax_display_shop, woocommerce_tax_display_cart advanced: woocommerce_cart_page_id, woocommerce_checkout_page_id, woocommerce_myaccount_page_id, woocommerce_terms_page_id

Inputs: group (required), value (required), setting_id (required), response_format.

wp_audit_alt_textAudit Alt TextA
Read-onlyIdempotent

Scan the media library and report which IMAGE items are missing alt text. Skips non-image media (video/audio/file). Designed to be paginated for large libraries — start at offset 0, then re-run with the returned next_offset.

Args:

  • scan_limit (number): How many media items to scan in this call, 1-500. Default 100.

  • limit (number): How many missing-alt items to return in the result. Default 20.

  • offset (number): Pagination offset INTO THE MEDIA LIBRARY (not into the missing list). Default 0.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: WPAltTextAuditResult object with shape: { "total_media_scanned": number, "total_images_scanned": number, "missing_alt_count": number, "missing_alt_items": [ { "id": number, "title": string, "source_url": string, "attached_to_id": number } ], "has_more": boolean, "next_offset": number // Present if has_more }

Note: missing_alt_count is the count WITHIN this scan window only. Re-run with the returned next_offset to continue scanning the rest of the library.

Inputs: limit, offset, scan_limit, response_format.

wp_build_menuBuild a Whole Menu in One CommandA

Create an entire navigation menu — nested submenus, ordering, and theme-location assignment — from one structured spec. Ideal for rebuilding a site's primary navigation by command.

Each item links to a page (page_id) OR a custom URL (url), OR neither (a non-linking dropdown parent that just holds children). Children create submenus. Order follows array order.

Args:

  • name (string): Menu name to create.

  • locations (string[]): Optional theme locations, e.g. ['primary'].

  • items: ordered array of { title, page_id?, url?, children?[] }.

  • response_format (enum): markdown | json.

Example items: [ { "title": "Concerts", "children": [ { "title": "This Season", "page_id": 123 }, { "title": "Tickets", "page_id": 3285 } ]}, { "title": "Donate", "url": "/support/donate/" } ]

Returns: { menu_id, items_created, locations }. Note: creates a NEW menu; it does not merge into an existing one. Use wp_list_menus / wp_delete_menu first if replacing.

Inputs: name (required), items (required), locations, response_format.

wp_bulk_assign_termsBulk Assign Categories/Tags to Posts from CSVA
DestructiveIdempotent

Assign categories or tags to many posts using term NAMES (not IDs). Missing tag names are auto-created by default. Required columns: post_id, taxonomy (category|tag), term_names (comma-separated). Defaults to dry_run=true.

This REPLACES existing terms in that taxonomy on each post. To merge with existing terms, look those up first and include them in term_names.

Inputs: csv_path (required), dry_run, stop_on_error, response_format, +1 more.

wp_bulk_create_postsBulk Create Posts from CSVA

Create many posts from a CSV. Required columns: title, content. Optional: status (default 'draft'), slug, excerpt, categories (comma-sep IDs), tags (comma-sep IDs), date, featured_media. Defaults to dry_run=true.

Use case: import a content calendar.

Inputs: csv_path (required), dry_run, stop_on_error, response_format.

wp_bulk_update_media_alt_textBulk Update Media Alt Text from CSVA
DestructiveIdempotent

Backfill alt text (and optionally caption/description/title) across many media items from a CSV. Required columns: id, alt_text. Optional: caption, description, title. Defaults to dry_run=true.

Use case: the 2020-era alt-text backfill on arsnovasingers.org.

Inputs: csv_path (required), dry_run, stop_on_error, response_format.

wp_bulk_update_postsBulk Update Posts from CSVA
DestructiveIdempotent

Update many posts from a CSV. Required column: id. Optional: title, content, status, slug, excerpt, categories (comma-separated IDs), tags (comma-separated IDs), featured_media. Empty cells are SKIPPED (no change to that field). Defaults to dry_run=true.

Args:

  • csv_path (string): Path to CSV file. Required.

  • dry_run (boolean): Default true. Set false to apply changes.

  • stop_on_error (boolean): Default false.

  • response_format (enum): markdown | json. Default 'markdown'.

Use case: backfill categories on the 45 "Uncategorized" posts.

Inputs: csv_path (required), dry_run, stop_on_error, response_format.

wp_bulk_update_usersBulk Update Users from CSVA
DestructiveIdempotent

Update many users from a CSV. Required column: id. Optional: roles (single role like 'subscriber' or comma-sep for multiple), email, first_name, last_name, name, description. Defaults to dry_run=true.

Use case: demote stale admins identified in the website audit.

Inputs: csv_path (required), dry_run, stop_on_error, response_format.

wp_check_environmentCheck WordPress EnvironmentA

⚠️ SAFETY CHECK — Call this before any write, update, or delete operation. Returns the site URL and environment label so you can confirm you are on the correct site (LIVE vs DEV) before making changes. Never skip this on write operations.

Inputs: no named parameters.

wp_create_categoryCreate WordPress CategoryA

Create a new post category.

Args:

  • name (string): Required. Display name.

  • slug (string): Optional. Auto-generated from name if omitted.

  • description (string): Optional.

  • parent (number): Optional parent category ID. 0 for top-level.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The created WPTermItem.

Inputs: name (required), slug, parent, description, +1 more.

wp_create_menuCreate Navigation MenuA

Create an empty navigation menu, optionally assigning it to theme locations (e.g. ['primary']). Returns the new menu ID. Requires admin.

Args:

  • name (string): Menu name.

  • locations (string[]): Optional theme locations to assign.

  • response_format (enum): markdown | json.

Inputs: name (required), locations, response_format.

wp_create_menu_itemAdd Menu ItemA

Add a single item to a menu. Link it to a page (page_id) or to a custom URL (url). Nest it by setting parent to another item's ID. Requires admin.

Args:

  • menu_id (number): Menu to add to.

  • title (string): Label.

  • page_id (number): Link to this page ID (or use url).

  • url (string): Custom URL (or use page_id).

  • parent (number): Parent item ID for nesting. 0 = top level.

  • menu_order (number): Position within its level.

  • response_format (enum): markdown | json.

Inputs: title (required), menu_id (required), url, parent, +3 more.

wp_create_pageCreate WordPress PageA

Create a new static page. Defaults to status='draft'.

Args:

  • title, content, excerpt, slug, status, author, featured_media, date: same as wp_create_post.

  • parent (number): Parent page ID. 0 for top-level.

  • menu_order (number): Numeric position in the page hierarchy.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The created WPContentItem.

Inputs: date, slug, title, author, +7 more.

wp_create_postCreate WordPress PostA

Create a new blog post. Defaults to status='draft' for safety — set status='publish' to publish immediately.

Args:

  • title (string): Post title.

  • content (string): HTML body.

  • excerpt (string): Optional short summary.

  • slug (string): URL slug. Auto-generated from title if omitted.

  • status (enum): publish | future | draft | pending | private. Default 'draft'.

  • author (number): Author user ID. Defaults to authenticated user.

  • featured_media (number): Featured image media ID.

  • date (string): ISO 8601 schedule date. Set status='future' for scheduling.

  • categories (number[]): Category IDs.

  • tags (number[]): Tag IDs.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The created WPContentItem (id, slug, status, link, etc.)

Inputs: date, slug, tags, title, +7 more.

wp_create_redirectCreate a RedirectA

Create a 301 (or 302/307/308) redirect in the Redirection plugin. Use after any slug change or page re-parenting so the old URL keeps working and search authority transfers.

Requires the Redirection plugin to be active and admin rights.

Args:

  • source (string): Old path to redirect FROM, e.g. '/listen/current-season/'. Required.

  • target (string): Path or URL to redirect TO, e.g. '/concerts/this-season/'. Required.

  • code (301|302|307|308): Default 301 (permanent).

  • title (string): Optional note shown in the admin list.

  • group_id (number): Redirection group. Default 1.

  • regex (boolean): Treat source as a regex. Default false.

  • response_format (enum): markdown | json.

Returns: the created redirect.

Inputs: source (required), target (required), code, regex, +3 more.

wp_create_tagCreate WordPress TagA

Create a new post tag.

Args:

  • name (string): Required. Display name.

  • slug (string): Optional. Auto-generated from name if omitted.

  • description (string): Optional.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The created WPTermItem.

Inputs: name (required), slug, description, response_format.

wp_create_widgetCreate Widget (block)A

Create a block-based widget in a sidebar/widget area. Use for populating Kadence footer columns. Requires admin.

Args:

  • sidebar (string): target widget-area ID (from wp_get_sidebars).

  • content (string): block markup for the widget body.

Returns: the created widget (incl. its new id).

Inputs: content (required), sidebar (required), response_format.

wp_delete_mediaDelete WordPress Media ItemA
Destructive

Permanently delete a media item. WP REST does NOT support trashing media; deletion is always permanent.

Args:

  • id (number): Media item ID. Required.

  • force (boolean): Default true. False will trigger a WP validation error.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: { deleted: true, previous: }

Inputs: id (required), force, response_format.

wp_delete_menuDelete Navigation MenuA
DestructiveIdempotent

Permanently delete a navigation menu and all its items (force delete). Requires admin. This cannot be undone via the API.

Args:

  • menu_id (number): Menu to delete.

  • response_format (enum): markdown | json.

Inputs: menu_id (required), response_format.

wp_delete_menu_itemDelete Menu ItemA
DestructiveIdempotent

Permanently remove a single menu item (force delete). Requires admin.

Args:

  • item_id (number): Menu-item ID to remove.

  • response_format (enum): markdown | json.

Inputs: item_id (required), response_format.

wp_delete_pageDelete WordPress PageA
Destructive

Delete a page. Defaults to trash. Set force=true to permanently delete.

Args:

  • id (number): Page ID. Required.

  • force (boolean): Default false (trash). True = permanent.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Deletion outcome (see wp_delete_post for shape).

Inputs: id (required), force, response_format.

wp_delete_pluginDelete PluginA
Destructive

Deactivate (if needed) and permanently delete an installed plugin from the site. 'plugin' is the basename (folder/file.php). On the LIVE production site this refuses unless confirm_production=true. This cannot be undone.

Inputs: plugin (required), response_format, confirm_production.

wp_delete_postDelete WordPress PostA
Destructive

Delete a post. Defaults to trash (recoverable for 30 days). Set force=true to permanently delete.

Args:

  • id (number): Post ID to delete. Required.

  • force (boolean): Default false. True = permanent delete (skip trash).

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: JSON with deletion outcome:

  • force=false: the post object with status='trash'

  • force=true: { deleted: true, previous: }

Inputs: id (required), force, response_format.

wp_delete_userDelete WordPress UserA
Destructive

Permanently delete a user. WP requires a reassign target — the deleted user's content (posts, pages, media) gets transferred to that user ID. WP REST does NOT support trashing users; deletion is always permanent.

Args:

  • id (number): User ID to delete. Required.

  • reassign (number): User ID to receive the deleted user's content. Required.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: { deleted: true, previous: }

Inputs: id (required), reassign (required), response_format.

wp_get_acf_optionsGet ACF Options Page FieldsA
Read-onlyIdempotent

Read fields from an ACF (Advanced Custom Fields) Options page on arsnovasingers.org.

Requires the "ACF to REST API" plugin (airesvsg) to be installed and active. Reads from /wp-json/acf/v3/options/{option_page}.

Use this for Stagehand's global site content — footer columns/headers, alert bars, sponsor blocks, etc. — that aren't stored on a specific page.

Args:

  • option_page (string): Options page slug. Default 'options' (Stagehand's main Options page).

  • field (string, optional): Specific field name to return. If omitted, returns all fields.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: WPACFOptionsResult { acf: { [field_name]: value, ... } }

Inputs: field, option_page, response_format.

wp_get_media_itemGet WordPress Media ItemA
Read-onlyIdempotent

Fetch a single media item by ID. Returns full metadata including dimensions, file size, MIME type, alt text, caption, and source URL.

Args:

  • id (number): Numeric media item ID.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: A single WPMediaItem object.

Inputs: id (required), response_format.

wp_get_pageGet WordPress PageA
Read-onlyIdempotent

Fetch a single page by ID or slug. Returns the full content (rendered to plain text — HTML stripped).

At least one of 'id' or 'slug' must be provided.

Args:

  • id (number): Numeric page ID. Mutually exclusive with slug.

  • slug (string): URL handle of the page (e.g. "about", "concerts"). Mutually exclusive with id.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: A single WPContentItem object with full content_preview expanded.

Inputs: id, slug, response_format.

wp_get_postGet WordPress PostA
Read-onlyIdempotent

Fetch a single blog post by ID or slug. Returns the full content of the post (rendered to plain text — HTML stripped).

At least one of 'id' or 'slug' must be provided.

Args:

  • id (number): Numeric post ID. Mutually exclusive with slug.

  • slug (string): URL handle of the post. Mutually exclusive with id.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: A single WPContentItem object with the full content_preview field expanded to up to 500 characters of plain-text content. For full content, the JSON response includes the original raw body.

Inputs: id, slug, response_format.

wp_get_raw_contentGet Raw Block ContentA
Read-onlyIdempotent

Read a page/post's RAW Gutenberg block markup (comment-delimited blocks), via core REST with context=edit. This is the editable source that wp_get_page/wp_get_post strip away. Use to inspect and transform page content, then write it back with wp_update_page. Requires admin.

Args:

  • id (number): page/post ID.

  • type ('page' | 'post'): default 'page'.

  • response_format (enum): markdown | json.

Returns: { id, title, slug, content } where content is the raw block markup.

Inputs: id (required), type, response_format.

wp_get_seo_metaGet WordPress SEO MetaA
Read-onlyIdempotent

Get SEO meta (title, description, canonical, OG/Twitter, focus keyword) for a single post or page. Auto-detects the active SEO plugin (Yoast, RankMath, AIOSEO) and normalizes the fields where possible.

Either 'id' or 'slug' must be provided.

Args:

  • content_type (enum): post | page. Required.

  • id (number): Numeric ID of target. Mutually exclusive with slug.

  • slug (string): Slug of target. Mutually exclusive with id.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: WPSeoMetaResult object with shape: { "detected_plugin": "yoast" | "rankmath" | "aioseo" | "none", "meta_title"?: string, "meta_description"?: string, "canonical_url"?: string, "noindex"?: boolean, "og_title"?: string, "og_description"?: string, "og_image"?: string, "twitter_title"?: string, "twitter_description"?: string, "twitter_image"?: string, "focus_keyword"?: string, "raw"?: object // The raw plugin-specific blob for reference }

Inputs: content_type (required), id, slug, response_format.

wp_get_settingsGet WordPress SettingsA
Read-onlyIdempotent

Fetch WP general settings (title, tagline, admin email, timezone, date/time formats, posts-per-page, front page mode, default category, etc.).

Note: Requires admin (manage_options capability).

Args:

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: RawWpSettings object — see wp_get_site_info for the field list.

Inputs: response_format.

wp_get_sidebarsList Widget Areas (Sidebars)A
Read-onlyIdempotent

List all registered widget areas / sidebars (incl. Kadence footer areas) with their IDs and the widgets currently in each. Core REST /wp/v2/sidebars. Requires admin.

Returns: array of { id, name, status, widgets[] }.

Inputs: response_format.

wp_get_site_infoGet WordPress Site InfoA
Read-onlyIdempotent

Get high-level info about the WordPress site: name, tagline, admin email, REST API namespaces, supported authentication, plus general WP settings.

Combines /wp-json (root, public) with /wp/v2/settings (admin-only). Settings fields will be omitted gracefully if your user lacks the manage_options capability.

Args:

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: WPSiteInfo object with shape: { "site_url": string, "api_namespaces": string[], "api_authentication": string[], "title"?: string, "description"?: string, "url"?: string, "email"?: string, "timezone"?: string, "language"?: string, "posts_per_page"?: number, "show_on_front"?: "posts" | "page", "page_on_front"?: number, "page_for_posts"?: number, "default_category"?: number, "default_post_format"?: string }

Inputs: response_format.

wp_get_theme_modsGet Theme Mods (Kadence/Customizer)A
Read-onlyIdempotent

Read the active theme's theme_mods — the storage behind Kadence/Customizer settings (header layout, logo, colors, fonts, page-title display, etc.). Core REST does not expose these; this uses the companion "Ars Nova Bridge" plugin (must be active).

Args:

  • keys (string[]): optional filter to specific theme_mod keys.

  • response_format (enum): markdown | json.

Returns: active theme slug/name and the theme_mods map.

Inputs: keys, response_format.

wp_get_userGet WordPress UserA
Read-onlyIdempotent

Fetch a single user by ID. Use context='edit' to get roles/capabilities (requires admin).

Args:

  • id (number): Numeric user ID.

  • context (enum): view | embed | edit. Default 'view'.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: A single WPUserItem object.

Inputs: id (required), context, response_format.

wp_get_widgetsList WidgetsA
Read-onlyIdempotent

List all widget instances across sidebars, with their IDs, sidebar assignment, and rendered/raw content. Core REST /wp/v2/widgets. Requires admin.

Inputs: response_format.

wp_install_pluginInstall PluginA

Install a plugin on the target WordPress site. Pick ONE source: slug (from WordPress.org), url (allow-listed zip), zip_b64, or zip_path (a local zip file the connector reads for you). Set activate=true to activate right after install. For updating an already-installed plugin, use wp_update_plugin instead (or pass overwrite=true here). On the LIVE production site this refuses unless confirm_production=true.

Inputs: url, slug, zip_b64, activate, +4 more.

wp_list_categoriesList WordPress CategoriesA
Read-onlyIdempotent

List post categories with hierarchy + post counts.

Args:

  • limit (number): Page size, 1-100. Default 20.

  • offset (number): Pagination offset.

  • search (string): Optional keyword filter.

  • hide_empty (boolean): Default false. Set true to skip categories with no posts.

  • orderby (enum): id | name | slug | count | include. Default 'name'.

  • order (enum): asc | desc. Default 'asc'.

  • parent (number): Optional parent category ID filter. Use 0 for top-level.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Paginated envelope of WPTermItem objects with shape: { id, name, slug, description, count, parent, link }

Inputs: limit, order, offset, parent, +4 more.

wp_list_mediaList WordPress Media LibraryA
Read-onlyIdempotent

List items in the WP media library with filtering and pagination.

Args:

  • limit (number): Page size, 1-100. Default 20.

  • offset (number): Pagination offset.

  • media_type (enum): image | video | audio | file | any. Default 'any'.

  • search (string): Optional keyword filter.

  • parent (number): Optional attachment-to-post-ID filter (0 = unattached).

  • orderby (enum): date | title | id | modified. Default 'date'.

  • order (enum): asc | desc. Default 'desc'.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Paginated envelope of WPMediaItem objects with shape: { id, date, slug, title, alt_text, caption, description, media_type, mime_type, source_url, file_size, width, height, author_id, attached_to_id }

Inputs: limit, order, offset, parent, +4 more.

wp_list_menu_itemsList Menu ItemsA
Read-onlyIdempotent

List the items in a navigation menu, in order, including nesting (parent IDs). Use the menu_id from wp_list_menus.

Args:

  • menu_id (number): The menu ID.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: { count, items: [{ id, title, type, object, object_id, url, parent, menu_order }] }

Inputs: menu_id (required), response_format.

wp_list_menusList Navigation MenusA
Read-onlyIdempotent

List all WordPress navigation menus with their IDs, slugs, and assigned theme locations. Requires admin (edit_theme_options).

Args:

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: { count, items: [{ id, name, slug, locations }] }

Inputs: response_format.

wp_list_pagesList WordPress PagesA
Read-onlyIdempotent

List static pages on arsnovasingers.org. Pages differ from posts: they are hierarchical, ordered by menu_order rather than date, and used for evergreen content (About, Concerts, Education, Contact, etc.).

Args:

  • limit (number): Page size, 1-100. Default 20.

  • offset (number): Pagination offset. Default 0.

  • status (enum): publish | future | draft | pending | private | trash | any. Default 'publish'.

  • search (string): Optional keyword filter.

  • parent (number): Optional parent page ID filter. Use 0 for top-level pages.

  • orderby (enum): Default 'menu_order' (respects WP page tree).

  • order (enum): Default 'asc'.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Paginated envelope (same shape as wp_list_posts) of WPContentItem objects.

Inputs: limit, order, offset, parent, +4 more.

wp_list_pluginsList WordPress PluginsA
Read-onlyIdempotent

List installed plugins with version, status, and metadata. The active plugins are flagged with status='active'.

Note: This endpoint requires admin (activate_plugins capability). Returns 403 otherwise.

Args:

  • status (enum): active | inactive | any. Default 'any'.

  • search (string): Optional keyword filter against plugin name/description.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Array of WPPluginItem objects with shape: { plugin, status, name, plugin_uri, author, version, description, network_only, requires_wp, requires_php, textdomain }

Inputs: search, status, response_format.

wp_list_postsList WordPress PostsA
Read-onlyIdempotent

List blog posts on arsnovasingers.org with filtering, pagination, and sorting.

Returns a paginated list of posts (default 20 per page). Posts are returned newest-first by default. Use status='any' to include drafts/pending/private (requires edit_posts capability).

Args:

  • limit (number): Page size, 1-100. Default 20.

  • offset (number): Pagination offset. Default 0.

  • status (enum): publish | future | draft | pending | private | trash | any. Default 'publish'.

  • search (string): Optional keyword to search title + content.

  • author (number): Optional author ID filter.

  • categories (number[]): Optional list of category IDs to filter to.

  • tags (number[]): Optional list of tag IDs to filter to.

  • orderby (enum): date | modified | id | title | slug | author | relevance. Default 'date'.

  • order (enum): asc | desc. Default 'desc'.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Paginated envelope with shape: { "total": number, // Total matching posts on the server "count": number, // Posts in this response "offset": number, // Pagination offset "items": [WPContentItem], // Trimmed post shape (id, title, slug, status, link, excerpt, content_preview, author_id, etc.) "has_more": boolean, "next_offset": number // Present if has_more }

Inputs: tags, limit, order, author, +6 more.

wp_list_post_typesList WordPress Post TypesA
Read-onlyIdempotent

List all registered post types (built-in + custom). Useful for discovering custom post types added by Stagehand or other plugins (e.g. 'event', 'concert', 'season').

Args:

  • context (enum): view | edit. Default 'view'.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Object keyed by post type slug, each value containing { name, slug, rest_base, rest_namespace, hierarchical, has_archive, taxonomies, description }

Inputs: context, response_format.

wp_list_redirectsList RedirectsA
Read-onlyIdempotent

List the 301/302 redirects managed by the Redirection plugin. Requires the plugin to be active and admin rights.

Args:

  • search (string): Optional keyword filter on source/target URLs.

  • per_page (number): Page size, 1-200. Default 50.

  • page (number): 1-based page number. Default 1.

  • response_format (enum): markdown | json.

Returns: { count, total, items: [{ id, url, action_code, action_data, enabled, hits }] }

Inputs: page, search, per_page, response_format.

wp_list_site_notesList Site Notes (in-context front-end notes)A
Read-onlyIdempotent

List the in-context notes/change-tasks captured on the front end via the companion "Ars Nova Site Notes" plugin (must be active). Each note carries page URL/title, priority (1-10), type, done/completed status, who added it + when, and an optional linked element. Use this to sync notes into the project tracker + wiki, or to review what's outstanding on a site.

Whichever site this connector targets (DEV or LIVE) is the source. Run on both connectors and tag rows by site to get the full picture.

Args:

  • status (enum): open | done | all. Default 'all'.

  • page_url (string): optional path filter for a single page.

  • response_format (enum): markdown | json.

Returns: the notes, sorted open-first then priority high->low.

Inputs: status, page_url, response_format.

wp_list_tagsList WordPress TagsA
Read-onlyIdempotent

List post tags with post counts.

Args:

  • limit (number): Page size, 1-100. Default 20.

  • offset (number): Pagination offset.

  • search (string): Optional keyword filter.

  • hide_empty (boolean): Default false.

  • orderby (enum): id | name | slug | count | include. Default 'name'.

  • order (enum): asc | desc. Default 'asc'.

  • parent (number): Tags do not have hierarchy on most sites; this is usually ignored.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Paginated envelope of WPTermItem objects.

Inputs: limit, order, offset, parent, +4 more.

wp_list_themesList WordPress ThemesA
Read-onlyIdempotent

List installed themes. The active theme is flagged with status='active'. Child themes are detected (template != stylesheet).

Note: This endpoint requires admin (edit_themes capability). Will return 403 if the Application Password user is not an admin.

Args:

  • status (enum): active | inactive | any. Default 'any'.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Array of WPThemeItem objects with shape: { stylesheet, template, name, status, version, author, author_uri, description, theme_uri, is_child_theme, requires_wp, requires_php, tags, textdomain, screenshot? }

Inputs: status, response_format.

wp_list_usersList WordPress UsersA
Read-onlyIdempotent

List users on the WP site. Use context='edit' to see roles/capabilities (requires admin).

Args:

  • limit (number): Page size, 1-100. Default 20.

  • offset (number): Pagination offset.

  • search (string): Optional keyword filter (matches username, email, name).

  • roles (string[]): Optional filter to users in these roles.

  • orderby (enum): id | name | registered_date | slug | include. Default 'name'.

  • order (enum): asc | desc. Default 'asc'.

  • context (enum): view | embed | edit. Default 'view'. Use 'edit' to get roles/capabilities.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Paginated envelope of WPUserItem objects with shape: { id, name, slug, url, description, link, roles?, capabilities?, registered_date? }

Inputs: limit, order, roles, offset, +4 more.

wp_ops_statusOps / Installer StatusA
Read-only

Check that the Ars Nova Ops (Plugin Installer) plugin is active on the target site. Returns whether this is the production site, whether file modifications are allowed (DISALLOW_FILE_MODS), the current user's install capability, and the allow-listed zip hosts. Call before installing/updating plugins.

Inputs: response_format.

wp_read_theme_fileRead Theme Source FileA
Read-onlyIdempotent

Read theme source on the server (sandboxed to wp-content/themes) via the Ars Nova Bridge plugin. Directory path -> listing; file path -> contents (cap 500 KB). Use to discover Kadence footer-builder option keys. Requires Bridge plugin active + admin.

Args:

  • path (string): relative to wp-content/themes (e.g. 'kadence/inc'). Omit to list themes.

Inputs: path, response_format.

wp_search_contentSearch WordPress ContentA
Read-onlyIdempotent

Cross-content keyword search across posts and pages using WP's built-in /wp/v2/search endpoint. Lighter-weight than wp_list_posts(search=...) because it returns just (id, title, url, type, subtype) per match.

Args:

  • query (string): Required, minimum 2 characters.

  • type (enum): post | page | any. Default 'any' (searches both).

  • limit (number): Page size, 1-100. Default 20.

  • offset (number): Pagination offset. Default 0.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Paginated envelope of search hits with shape: { "total": number, "count": number, "offset": number, "items": [{ "id": number, "title": string, "url": string, "type": string, "subtype": string }], "has_more": boolean, "next_offset": number }

Inputs: query (required), type, limit, offset, +1 more.

wp_set_page_metaSet Page/Post MetaA
DestructiveIdempotent

Write post meta on a page/post (e.g. Kadence per-page settings such as _kad_post_title to disable the title on one page). POSTs { meta: {...} } to core REST. Only REST-registered meta keys can be written. Requires admin.

Args:

  • id (number): page/post ID.

  • type ('page' | 'post'): default 'page'.

  • meta (object): key:value pairs to set.

  • response_format (enum): markdown | json.

Returns: the updated meta object.

Inputs: id (required), meta (required), type, response_format.

wp_set_plugin_statusActivate / Deactivate PluginA
Idempotent

Activate or deactivate an installed plugin. 'plugin' is the plugin basename (folder/file.php), e.g. 'ars-nova-site-notes/ars-nova-site-notes.php' — the value shown as "plugin" by wp_list_plugins.

Inputs: active (required), plugin (required), response_format.

wp_set_theme_modsSet Theme Mods (Kadence/Customizer)A
Destructive

Set and/or remove the active theme's theme_mods — drives Kadence/Customizer settings by command. Uses the companion "Ars Nova Bridge" plugin (must be active). Requires admin.

CAUTION: theme_mods control header/layout/colors. ALWAYS read current values with wp_get_theme_mods and back them up before bulk changes. Removing a key resets it to the theme default.

Args:

  • mods (object): key:value pairs to set. Values may be string/number/bool/array/object.

  • remove (string[]): keys to reset to default.

  • response_format (enum): markdown | json.

Returns: what changed/removed plus the full updated theme_mods map.

Inputs: mods, remove, response_format.

wp_strip_leading_coverStrip Leading Cover HeroA
Destructive

Remove the embedded leading core/cover hero block from one or more pages, so the theme's page-title bar takes over. SAFE: only removes a block that is BOTH the first block AND a core/cover; pages without a leading cover are left unchanged. Reads/strips/writes server-side (no page content passes through the client), so it scales to many pages in one call. Requires admin.

Args:

  • ids (number[]): page/post IDs.

  • type ('page' | 'post'): default 'page'.

  • dry_run (bool): if true, report what would change WITHOUT saving.

  • response_format (enum): markdown | json.

Returns: per-id { title, removedCover, saved }.

Inputs: ids (required), type, dry_run, response_format.

wp_update_acf_optionsUpdate ACF Options Page FieldsA
Idempotent

Write one or more fields to an ACF Options page on arsnovasingers.org.

Requires the "ACF to REST API" plugin (airesvsg) to be installed and active. Posts to /wp-json/acf/v3/options/{option_page} with body { fields: {...} }.

ONLY the field names you include in 'fields' are modified — omitted fields are untouched. This is safe for incremental edits to the footer, alert bar, etc., without needing to re-send the entire Options page.

For repeater fields (e.g. footer_sponsors, alert_bar), you must send the COMPLETE new array — repeaters are replaced wholesale, not merged. Read first with wp_get_acf_options to get the current array, modify it locally, then send back.

Args:

  • option_page (string): Options page slug. Default 'options'.

  • fields (object): { field_name: new_value, ... }. Values: strings (HTML for WYSIWYG, plain text), numbers, booleans, arrays (full replacement for repeaters), or nested objects (for groups).

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: Result of the write including the updated fields and any plugin-returned metadata.

Inputs: fields (required), option_page, response_format.

wp_update_categoryUpdate WordPress CategoryA
DestructiveIdempotent

Update an existing category's name, slug, description, or parent.

Args:

  • id (number): Category ID. Required.

  • name, slug, description (string): Optional.

  • parent (number): New parent category ID.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The updated WPTermItem.

Inputs: id (required), name, slug, parent, +2 more.

wp_update_mediaUpdate WordPress Media ItemA
DestructiveIdempotent

Update metadata on an existing media item — title, alt text, caption, description, or attachment target. Most common use: backfilling alt_text on images that don't have it.

Args:

  • id (number): Media item ID. Required.

  • alt_text (string): New alt text. Pass empty string to clear.

  • title, caption, description (string): Optional.

  • post (number): Reassign to a different post/page ID (0 = unattach).

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The updated WPMediaItem.

Inputs: id (required), post, title, caption, +3 more.

wp_update_menuUpdate Navigation MenuA
Idempotent

Rename a menu and/or change its theme-location assignments. Requires admin.

Args:

  • menu_id (number): Menu to update.

  • name (string): Optional new name.

  • locations (string[]): Optional new location list (replaces existing).

  • response_format (enum): markdown | json.

Inputs: menu_id (required), name, locations, response_format.

wp_update_menu_itemUpdate Menu ItemA
Idempotent

Update a single existing menu item IN PLACE — rename it, repoint it, re-nest it, or reorder it — without rebuilding the menu. Only the fields you pass are changed. Requires admin.

Prefer this over wp_build_menu for small edits. Rebuilding a menu regenerates EVERY item ID, which breaks anything referencing them and leaves orphaned rows behind; this changes one row.

Args:

  • item_id (number): Menu-item ID to update (from wp_list_menu_items). Required.

  • title (string): New label.

  • page_id (number): Repoint at this page ID. Mutually exclusive with url.

  • url (string): Repoint at this custom URL. Mutually exclusive with page_id.

  • parent (number): New parent item ID. 0 = top level.

  • menu_order (number): New position within its level.

  • target (enum): '' (same tab) | '_blank' (new tab).

  • description (string), attr_title (string), classes (string[]).

  • response_format (enum): markdown | json.

Returns: the updated menu item.

Inputs: item_id (required), url, title, parent, +7 more.

wp_update_pageUpdate WordPress PageA
DestructiveIdempotent

Update an existing page. Only the fields you pass will change.

Args:

  • id (number): Page ID. Required.

  • All other fields optional, same shape as wp_create_page.

  • content_path (string): Optional. Absolute local file path; its contents become the page content (for bodies too large to pass inline). Overrides 'content'.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The updated WPContentItem.

Inputs: id (required), date, slug, title, +9 more.

wp_update_pluginUpdate PluginA

Update / replace an already-installed plugin in place (overwrite forced on). Pick ONE source: slug, url, zip_b64, or zip_path (a local zip the connector reads for you). Keeps the plugin's activation state. On the LIVE production site this refuses unless confirm_production=true.

Inputs: url, slug, zip_b64, activate, +3 more.

wp_update_postUpdate WordPress PostA
DestructiveIdempotent

Update an existing post. Only the fields you pass will change; omitted fields preserve their current values.

Args:

  • id (number): Post ID to update. Required.

  • title, content, excerpt, slug, status, author, featured_media, date, categories, tags: all optional, same shape as wp_create_post.

  • content_path (string): Optional. Absolute local file path; its contents become the post content (for bodies too large to pass inline). Overrides 'content'.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The updated WPContentItem.

Inputs: id (required), date, slug, tags, +9 more.

wp_update_seo_metaUpdate WordPress SEO Meta (Yoast)A
DestructiveIdempotent

Update Yoast SEO meta on a post or page: title, description, canonical, noindex, focus keyword, OG, Twitter. Writes via WP REST's meta sub-object using Yoast's underlying postmeta keys.

Args:

  • content_type (enum): post | page. Required.

  • id (number): ID of the post/page. Required.

  • meta_title, meta_description, canonical_url, focus_keyword: optional strings.

  • noindex (boolean): true = noindex, false = index, undefined = leave Yoast's default.

  • og_title, og_description, twitter_title, twitter_description: optional social-share overrides.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The updated content item (with the new Yoast meta applied — re-fetch with wp_get_seo_meta to verify rendering).

Note: This is for Yoast specifically. RankMath / AIOSEO sites need different keys (not supported in v1).

Inputs: id (required), content_type (required), noindex, og_title, +8 more.

wp_update_settingsUpdate WordPress SettingsA
Idempotent

Update core WP general settings (title, tagline, posts-per-page, and the front-page / blog-page assignment). Requires admin (manage_options). Only the fields you pass are changed.

The most common use is setting the static homepage: show_on_front='page', page_on_front=, page_for_posts=.

NOTE: This cannot toggle "Discourage search engines" (blog_public) — core does not expose it via REST. Use the WP Admin Reading screen or the planned control plugin for that.

Args:

  • title, description (string)

  • posts_per_page (number)

  • show_on_front ('posts' | 'page')

  • page_on_front, page_for_posts, default_category (number)

  • response_format (enum): markdown | json.

Returns: the updated settings object.

Inputs: title, description, page_on_front, show_on_front, +4 more.

wp_update_tagUpdate WordPress TagA
DestructiveIdempotent

Update an existing tag's name, slug, or description.

Args:

  • id (number): Tag ID. Required.

  • name, slug, description (string): Optional.

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The updated WPTermItem.

Inputs: id (required), name, slug, description, +1 more.

wp_update_userUpdate WordPress UserA
DestructiveIdempotent

Update an existing user's name, email, roles, or profile fields. Common use: demoting an admin to editor or subscriber.

Args:

  • id (number): User ID. Required.

  • name, email, first_name, last_name, url, description, slug: optional fields to update.

  • roles (string[]): Replaces existing roles. e.g. ['editor'], ['subscriber'], ['administrator'].

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The updated WPUserItem.

Inputs: id (required), url, name, slug, +6 more.

wp_update_widgetUpdate / Move WidgetA
Destructive

Update a widget's content and/or move it to another sidebar (use sidebar 'wp_inactive_widgets' to deactivate). Core REST PUT /wp/v2/widgets/{id}. Requires admin.

Inputs: id (required), content, sidebar, response_format.

wp_upload_mediaUpload File to WordPress Media LibraryA

Upload a local file to the WP media library as a new attachment. Reads the file from file_path on the MCP host machine, sends as multipart/form-data, and returns the created media item.

Args:

  • file_path (string): Absolute path to the file on disk. Required.

  • title (string): Optional title (defaults to filename).

  • alt_text (string): Optional alt text.

  • caption (string): Optional caption.

  • description (string): Optional description.

  • post (number): Optional post/page ID to attach the media to (0 = unattached).

  • response_format (enum): markdown | json. Default 'markdown'.

Returns: The newly-created WPMediaItem with id, source_url, dimensions, etc.

Notes:

  • The MCP host process must have read access to file_path.

  • For best SEO, always pass alt_text on image uploads.

  • WP MIME-sniffs the file; the upload will be rejected if the extension is on WP's disallowed list (e.g. executables).

Inputs: file_path (required), post, title, caption, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 89 tools

    Disambiguation3/5

    Several tools have overlapping boundaries (e.g., wp_get_site_info vs wp_get_settings, wp_get_sidebars vs wp_get_widgets, tickera_list_ticket_types vs wc_list_products, wp_search_content vs wp_list_posts with search). Descriptions help clarify but ambiguity remains in selection.

    Naming Consistency4/5

    Naming largely follows a consistent verb_noun pattern with clear prefixes (wp_, wc_, tickera_). Minor outliers like wp_ops_status, tickera_status, and ans_rest_call break the pattern slightly but are still recognizable.

    Tool Count1/5

    With 89 tools, this server far exceeds reasonable scope. Even for a comprehensive WordPress/WooCommerce/Tickera management server, the sheer number overwhelms agents and creates excessive selection overhead.

    Completeness2/5

    Significant gaps exist: no delete for categories/tags, no update/delete for redirects or widgets, no theme activation/deletion, and WooCommerce orders are list-only. These missing lifecycle operations will cause agent failures in common workflows.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers