Tools Reference

As of plugin 9.2.3 and MCP server 8.5.0 (npm @respira/wordpress-mcp-server), the MCP server lists 252 core tools, 356 with the WooCommerce add-on. 91 more tools come from modules that list them where they apply:

• 54 ACF tools, only when Advanced Custom Fields is active
• 25 Bricks tools, only on Bricks
• 8 tools from the Elementor module: 7 only on Elementor, and respira_add_stock_image, which every site sees
• 4 YOOtheme Pro template tools, only on YOOtheme Pro

The public tools catalog counts all of them: 447 tools in 30 categories. It is counted from the code on every release, so it is the place to check the current numbers. This page follows the same categories. Tool names here use the wordpress_ prefix, as the catalog does; an MCP client lists the same tools as respira_*.

What one site sees

A site sees fewer tools than the catalog, because the server lists only the tools for the site's builder and plugins. Measured tools/list counts:

Other surfaces

• The site's own MCP endpoint, used by the claude.ai and ChatGPT connectors, lists 353 tools named respira_wordpress_*. 10 of them are only there. They are listed further down this page.
• WordPress Abilities: the plugin registers 360. Across the MCP server and the abilities that makes 366 distinct tools and abilities (360+), or 262 (260+) without the paid WooCommerce add-on.

Tool Categories

Context & Site Intelligence (19 tools)

Site context, the sites in a multi-site setup, and the native Site Editor: block templates, template parts, synced and unsynced patterns, and block navigation.

• wordpress_get_site_context
• wordpress_list_sites
• wordpress_get_active_site
• wordpress_list_site_templates
• wordpress_get_site_template
• wordpress_create_site_template
• wordpress_update_site_template
• wordpress_reset_site_template
• wordpress_list_site_patterns
• wordpress_get_site_pattern
• wordpress_create_site_pattern
• wordpress_update_site_pattern
• wordpress_delete_site_pattern
• wordpress_list_site_navigations
• wordpress_get_site_navigation
• wordpress_create_site_navigation
• wordpress_update_site_navigation
• wordpress_delete_site_navigation
• wordpress_switch_site

The Site Editor tools are new in 8.0. Read-only discovery works on any site with a block theme. Structural writes are off by default; the site owner turns them on in Respira > Settings. See Site Editor (Full Site Editing). The Site Editor's design tokens are under Art Direction.

Pages (10 tools)

List, read, duplicate, update and delete pages, read a page's outline, run PageSpeed on it, build a complete page in one call and apply one change across many pages.

• wordpress_list_pages
• wordpress_read_page
• wordpress_create_page_duplicate
• wordpress_update_page
• wordpress_delete_page
• wordpress_get_page_outline
• wordpress_run_pagespeed_audit
• wordpress_analyze_pagespeed
• wordpress_build_page creates a complete page from a declarative structure
• wordpress_bulk_pages_operation applies operations across many pages, with a snapshot of each

Posts (5 tools)

Manage blog posts with full CRUD operations.

• wordpress_list_posts
• wordpress_read_post
• wordpress_create_post_duplicate
• wordpress_update_post
• wordpress_delete_post

Custom Post Types (11 tools)

Register custom post types and work with their posts.

• wordpress_list_post_types
• wordpress_get_post_type
• wordpress_create_post_type
• wordpress_update_post_type
• wordpress_delete_post_type
• wordpress_list_custom_post_types
• wordpress_list_custom_posts
• wordpress_get_custom_post
• wordpress_create_custom_post
• wordpress_update_custom_post
• wordpress_delete_custom_post

Media (7 tools)

Upload, read, update and delete media, update many items in one call, and import an image from a URL into the Media Library.

• wordpress_list_media
• wordpress_upload_media
• wordpress_get_media
• wordpress_update_media
• wordpress_update_media_batch
• wordpress_delete_media
• wordpress_sideload_image

Menus (14 tools)

Manage WordPress navigation menus, menu items and menu locations.

• wordpress_build_mega_menu NEW in 7.6.1: builds a complete Divi mega menu in one call (a top item with the mega-menu class, columns as children, links as grandchildren) and can assign it to a theme location. Works on Divi 4 and Divi 5.
• wordpress_list_menus
• wordpress_get_menu
• wordpress_create_menu
• wordpress_update_menu
• wordpress_delete_menu
• wordpress_list_menu_locations
• wordpress_assign_menu_location
• wordpress_list_menu_items
• wordpress_create_menu_item
• wordpress_get_menu_item
• wordpress_update_menu_item
• wordpress_delete_menu_item
• wordpress_add_menu

Taxonomies & Terms (11 tools)

Register custom taxonomies and manage their terms (categories, tags, custom taxonomies).

• wordpress_list_taxonomies
• wordpress_get_taxonomy
• wordpress_list_terms
• wordpress_get_term
• wordpress_create_term
• wordpress_update_term
• wordpress_delete_term
• wordpress_create_taxonomy
• wordpress_update_taxonomy
• wordpress_delete_taxonomy
• wordpress_list_custom_taxonomies

Users (5 tools)

Manage WordPress users.

• wordpress_list_users
• wordpress_get_user
• wordpress_create_user
• wordpress_update_user
• wordpress_delete_user

Comments (5 tools)

Read and manage comments.

• wordpress_list_comments
• wordpress_get_comment
• wordpress_create_comment
• wordpress_update_comment
• wordpress_delete_comment

Options & Settings (4 tools)

Manage WordPress options (settings).

• wordpress_list_options
• wordpress_get_option
• wordpress_update_option
• wordpress_delete_option

Redirects (4 tools) NEW in 9.2.0

Redirects, another domain included, written through Redirection when it is active and kept in Respira's own list otherwise. WordPress's own addresses, loops and permanent redirects to dead pages are refused, and the home page or a catch-all pattern waits for a person's approval. Every write keeps a snapshot.

• wordpress_list_redirects
• wordpress_create_redirect
• wordpress_update_redirect
• wordpress_delete_redirect

Plugins (6 tools)

Experimental plugin management: list, install, activate, deactivate, update and delete. Quarantining a plugin is under Security.

• wordpress_list_plugins
• wordpress_install_plugin
• wordpress_activate_plugin
• wordpress_deactivate_plugin
• wordpress_update_plugin
• wordpress_delete_plugin

Page Builder Core (19 tools)

Work directly with page builder structures (Divi, Elementor, Bricks, YOOtheme Pro and the rest): detect the builder, extract and inject content, patch it, convert HTML into native builder elements, and find, update, move, duplicate, remove and reorder single elements (new in 5.2).

• wordpress_get_builder_info
• wordpress_list_theme_builder_templates (Divi Theme Builder, read)
• wordpress_create_theme_builder_template (Divi Theme Builder, write)
• wordpress_update_theme_builder_template (Divi Theme Builder, write)
• wordpress_extract_builder_content
• wordpress_find_builder_targets
• wordpress_get_builder_inline_schemas
• wordpress_inject_builder_content
• wordpress_make_responsive
• wordpress_update_module
• wordpress_apply_builder_patch
• respira_find_element
• wordpress_update_element
• wordpress_move_element
• wordpress_duplicate_element
• wordpress_remove_element
• wordpress_batch_update
• wordpress_reorder_elements
• wordpress_convert_html_to_builder

The three Divi Theme Builder tools, new in 7.6, discover and edit Divi's global Theme Builder templates (headers, footers and body layouts), not only regular pages: list the templates on a site, edit a header in place (for example to build a mega menu), or create a new global template with page assignments. Every edit is snapshot-protected. Divi 5.

Widget Shortcuts (27 tools) NEW in 5.2

Quick single-element additions without building full page structures. wordpress_add_menu is under Menus.

• wordpress_add_heading, wordpress_add_text, wordpress_add_button, wordpress_add_image, wordpress_add_section, wordpress_add_video, wordpress_add_divider, wordpress_add_spacer, wordpress_add_icon, wordpress_add_icon_list, wordpress_add_social_icons, wordpress_add_form, wordpress_add_map, wordpress_add_counter, wordpress_add_progress_bar, wordpress_add_testimonial, wordpress_add_tabs, wordpress_add_accordion, wordpress_add_toggle, wordpress_add_alert, wordpress_add_html, wordpress_add_sidebar, wordpress_add_search, wordpress_add_gallery, wordpress_add_slider, wordpress_add_pricing_table, wordpress_add_stock_image

Elementor Intelligence (7 tools)

Listed only when Elementor is the site's builder: the widget catalog and schemas, global colours and typography, custom JavaScript and JSON validation.

• wordpress_list_elementor_widgets, wordpress_get_elementor_widget_schema, wordpress_elementor_design_system, wordpress_update_elementor_global_colors, wordpress_update_elementor_global_typography, wordpress_elementor_add_custom_js, wordpress_validate_elementor_json

Bricks Intelligence (25 tools)

Listed only when Bricks is the site's builder: global classes, theme styles, colour palette, typography, components, section presets, ACSS, BEM and query loops.

• wordpress_list_bricks_global_classes, wordpress_create_bricks_global_class, wordpress_update_bricks_global_class, wordpress_delete_bricks_global_class, wordpress_get_bricks_theme_styles, wordpress_update_bricks_theme_styles, wordpress_get_bricks_color_palette, wordpress_update_bricks_color_palette, wordpress_get_bricks_typography, wordpress_update_bricks_typography, wordpress_list_bricks_components, wordpress_get_bricks_component, wordpress_apply_bricks_component, wordpress_search_bricks_elements, wordpress_bricks_health_check, wordpress_bricks_detect_acss, wordpress_bricks_import_acss, wordpress_bricks_import_design_tokens, wordpress_bricks_list_section_presets, wordpress_bricks_insert_section_preset, wordpress_bricks_scaffold_bem, wordpress_bricks_lint_bem, wordpress_bricks_query_loops, wordpress_bricks_style_profile, wordpress_bricks_design_system

YOOtheme Pro (4 tools) NEW in 9.2.0

Listed only when YOOtheme Pro is the site's builder. A YOOtheme template is a builder layout the theme renders for a whole view: every single post, the blog index, a category archive, search or the 404 page. A new template starts disabled for review, and a live one changes only with confirm_live_edit. Pages themselves are edited with the page and element tools. See YOOtheme Pro.

• wordpress_list_yootheme_templates
• wordpress_get_yootheme_template
• wordpress_create_yootheme_template
• wordpress_update_yootheme_template

Advanced Custom Fields (58 tools) NEW in 6.6

Full ACF and ACF Pro coverage: field reads and writes, field group management, repeater and flexible-content operations, galleries, options pages, relationships, user and term fields, and bulk operations across up to 500 posts. The 4 field group tools below are listed on every site. The other 54 respira_acf_* tools are listed only when Advanced Custom Fields is active. See the ACF tools overview for the full list and example workflows.

• wordpress_create_acf_field_group
• wordpress_update_acf_field_group
• wordpress_delete_acf_field_group
• wordpress_list_acf_field_groups

WooCommerce (104 tools)

Products, orders, inventory, storefront, feeds, extensions and store analytics, listed when the paid WooCommerce Add-on is active. See the WooCommerce tools reference.

Audits & Analysis (18 tools)

Read-only analysis of SEO, readability, performance, images, structured data and AI Engine Optimization (AEO), accessibility scans, the activity history (new in 8.0), and a search of the published HTML for text that is not in page content. Only wordpress_apply_accessibility_fixes writes.

• wordpress_list_activity: agent-facing activity history that links audit entries to the snapshots, proposals, approvals and rollbacks they belong to
• wordpress_get_activity
• wordpress_generate_activity_report
• wordpress_validate_security
• wordpress_analyze_performance
• wordpress_get_core_web_vitals
• wordpress_analyze_images
• wordpress_analyze_seo
• wordpress_check_seo_issues
• wordpress_analyze_readability
• wordpress_analyze_rankmath
• wordpress_analyze_aeo
• wordpress_check_structured_data
• respira_find_in_page NEW in 9.1.11: finds text in the published HTML, head included, and names the snippet or setting that holds it
• wordpress_list_accessibility_scans
• wordpress_get_accessibility_scan
• wordpress_scan_page_accessibility
• wordpress_apply_accessibility_fixes

Safety & Approvals (14 tools)

Snapshots, rollback, sessions, plan mode, duplicate approval and owner approval links. Every write in a plan-mode session answers a proposed step instead of changing the site; the person reads the plan and one call applies it (new in 9.1). See Plan mode for MCP clients.

• wordpress_list_snapshots
• wordpress_get_snapshot
• wordpress_diff_snapshots
• wordpress_restore_snapshot
• wordpress_restore_session
• respira_begin_session (with mode: "plan" for plan mode)
• wordpress_end_session
• wordpress_approve_duplicate
• wordpress_reject_duplicate
• respira_get_plan
• respira_apply_plan (write, the person's approval)
• respira_discard_plan
• wordpress_create_approval_link
• wordpress_revoke_approval_link

Theme Docs (2 tools)

Theme documentation and a search of the Respira docs.

• wordpress_get_theme_docs
• wordpress_search_docs

Stock Imagery (1 tool)

Search openly licensed images from Openverse. wordpress_sideload_image, under Media, imports one into the Media Library.

• wordpress_search_stock_images

Review & Sharing (12 tools)

Share preview links, review links and the comments reviewers leave on them, and Murmur split tests: half the visitors of a page see a draft copy, and the wins are counted for each version (plugin 9.2.28 and MCP server 8.7.1). See Share Preview Links and Murmur: Review Links, Request Links and Split Tests.

• wordpress_create_share_link
• wordpress_create_review_link
• wordpress_list_review_links
• wordpress_revoke_review_link
• wordpress_list_review_comments
• wordpress_get_review_comment
• wordpress_reply_to_review_comment
• wordpress_resolve_review_comment
• wordpress_start_split_test
• wordpress_get_split_test
• wordpress_list_split_tests
• wordpress_end_split_test

Art Direction (16 tools)

Design tokens (the Site Editor's global styles), saved design directions, design checks and design previews.

• wordpress_list_design_tokens
• wordpress_create_design_token
• wordpress_update_design_token
• wordpress_delete_design_token
• wordpress_get_design_direction
• wordpress_list_design_directions
• wordpress_save_design_direction
• wordpress_activate_design_direction
• wordpress_deactivate_design_direction
• wordpress_delete_design_direction
• wordpress_import_design_tokens
• wordpress_apply_design_direction
• wordpress_export_design_direction
• wordpress_check_design
• wordpress_mint_design_preview
• wordpress_get_design_apply_reports

Divi Presets & Library (7 tools)

Divi presets, the Divi Library and the Divi 5 migration readiness report.

• wordpress_get_divi_migration_readiness
• wordpress_list_divi_presets
• wordpress_upsert_divi_presets
• wordpress_delete_divi_preset
• wordpress_save_divi_library_item
• wordpress_apply_divi_library_item
• wordpress_resolve_divi_preset

Security (7 tools)

Security audit, core security updates, theme updates, revoking an application password, quarantining a plugin and flushing rewrite rules.

• wordpress_run_security_audit
• wordpress_update_core_security
• wordpress_update_theme
• wordpress_revoke_application_password
• wordpress_quarantine_plugin
• wordpress_restore_quarantined_plugin
• wordpress_flush_rewrites

Updates & Site Health (5 tools)

Connection diagnosis, server compatibility, cache purge, and listing and running the updates waiting on the site.

• wordpress_diagnose_connection
• wordpress_get_server_compatibility
• wordpress_purge_cache
• wordpress_list_updates
• wordpress_run_updates

Memory, Skills & Playbooks (12 tools)

Playbooks, notes the agent keeps for a site, and the site's own skills: instructions for agents kept under Respira > AI Skills (new in 9.1). See Playbooks and Site Skills.

• wordpress_create_playbook
• wordpress_list_playbooks
• wordpress_get_playbook
• wordpress_update_playbook
• wordpress_delete_playbook
• wordpress_remember
• wordpress_forget
• wordpress_list_memory
• respira_list_skills
• respira_get_skill
• respira_write_skill (write, only when the user asked)
• respira_delete_skill (write, approval-gated)

Other (12 tools)

Abilities from other plugins, WPML translations, theme files, issue reports and token redemption. The WPML tools (new in 7.6) create and update translations: a created translation joins the page's existing language group so WPML treats it as a real translation, and the builder content is carried across into the new copy.

• respira_search_abilities (read; live search of the site's Abilities API since 9.1)
• wordpress_abilities_gap_report
• respira_invoke_ability
• respira_duplicate_with_translations
• wordpress_get_translations
• wordpress_create_translation
• wordpress_update_translation
• wordpress_read_theme_file
• wordpress_write_theme_file
• wordpress_append_theme_file
• wordpress_report_issue
• wordpress_redeem_token

Only on the site's own MCP endpoint

The site's own MCP endpoint, used by the claude.ai and ChatGPT connectors, lists 353 tools named respira_wordpress_*. 10 of them are only there and not on the npm server, among them the guarded update tools:

Guarded update and backups (4 tools) NEW in 9.1

One wordpress.org plugin, one advisory, with a restore point before, four health checks after and a rollback from wordpress.org. See Guarded plugin update.

• respira_check_guarded_update (read)
• respira_guarded_plugin_update (write, approval-gated)
• respira_get_guarded_update (read)
• respira_take_backup (write, approval-gated)

Quick Reference Table

This table follows the public catalog. Some categories are listed only when the matching builder, plugin or add-on is present, so the total is higher than what a single site sees. Read-only counts the tools that only read; Write counts every tool that can change the site.

Tool Naming Convention

Core tools follow the pattern respira_[action]_[resource]. ACF tools are named respira_acf_* and WooCommerce tools woocommerce_*.

• list_* - Get multiple items
• get_* / read_* - Get single item
• create_* - Create new item
• update_* - Modify existing item
• delete_* - Remove item
• analyze_* - Read-only analysis
• check_* - Quick validation

FAQ

How many tools does Respira have?

As of plugin 9.2.3 and MCP server 8.5.0: 252 core tools, 356 with the WooCommerce add-on. 91 more come from modules listed where they apply (ACF, Bricks, Elementor and YOOtheme Pro), so the public catalog counts 447 tools in 30 categories. One site sees between 253 and 436, depending on its builder and plugins. The plugin also registers 360 WordPress Abilities. The live tools catalog has the current numbers.

What's the difference between read-only and write tools?

Read-only tools (like wordpress_list_pages, wordpress_analyze_seo) only retrieve information—they never modify your site. Write tools (like wordpress_update_page, wordpress_delete_post) can change content. Write operations use the duplicate-first workflow by default, so you review changes before they go live.

Which tools are safe to use on production?

All analysis tools are completely safe as they're read-only. For write operations, Respira's duplicate-first workflow protects your live content. The AI creates a draft copy, you review it in WordPress Admin (Respira → Approve Edits), and only then does it replace the original. You can also use wordpress_validate_security to check content before saving.

Can I manage multiple sites with these tools?

Yes. Use wordpress_switch_site to switch between configured WordPress sites during a session. Configure multiple sites in ~/.respira/config.json and the AI can work across all of them.

Do I need to remember all the tool names?

No. Your AI assistant knows all available tools and will choose the right one based on your natural language request. Just describe what you want ("update the homepage title", "list all pages", "analyze SEO") and the AI selects the appropriate tool.