Tools Reference

As of 8.0 "Canopy", Respira exposes 197 MCP tools on any WordPress site and 302 with the WooCommerce add-on installed (105 of those are woocommerce_* tools), alongside 269 WebMCP browser abilities and 37 skills. Those numbers were measured by booting the MCP server and calling tools/list. This reference documents the core categories and naming patterns.

Tool Categories

Context Tools (3 tools)

Get information about your WordPress site, theme, and page builder.

• wordpress_get_site_context
• wordpress_get_theme_docs
• wordpress_get_builder_info

Page Tools (5 tools)

List, read, create, update, and delete pages.

• wordpress_list_pages
• wordpress_read_page
• wordpress_create_page_duplicate
• wordpress_update_page
• wordpress_delete_page

Post Tools (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

Builder Tools (3 tools)

Work directly with page builder structures (Divi, Elementor, Bricks, etc.).

• wordpress_extract_builder_content
• wordpress_inject_builder_content
• wordpress_update_module

Fidelity & Snapshot Tools (5 tools)

Safer comparison, rollback, and patch workflows on v2-capable sites.

• wordpress_list_snapshots
• wordpress_get_snapshot
• wordpress_diff_snapshots
• wordpress_restore_snapshot
• wordpress_apply_builder_patch

Analysis Tools (8 tools)

Read-only analysis of SEO, performance, images, and AI Engine Optimization (AEO).

• wordpress_analyze_seo
• wordpress_check_seo_issues
• wordpress_analyze_readability
• wordpress_analyze_performance
• wordpress_get_core_web_vitals
• wordpress_analyze_images
• wordpress_analyze_aeo
• wordpress_check_structured_data

Menu Tools (13 tools)

Manage WordPress navigation menus and menu items.

• 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_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.

Media Tools (5 tools)

Upload and manage media.

• wordpress_list_media
• wordpress_get_media
• wordpress_upload_media
• wordpress_update_media
• wordpress_delete_media

User Tools (5 tools)

Manage WordPress users.

• wordpress_list_users
• wordpress_get_user
• wordpress_create_user
• wordpress_update_user
• wordpress_delete_user

Taxonomy Tools (7 tools)

Manage taxonomies and 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

Custom Post Type Tools (7 tools)

Work with custom post types and their posts.

• wordpress_list_post_types
• wordpress_get_post_type
• wordpress_list_custom_posts
• wordpress_get_custom_post
• wordpress_create_custom_post
• wordpress_update_custom_post
• wordpress_delete_custom_post

Plugin Tools (6 tools)

Experimental plugin management (install/activate/update/delete).

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

Options Tools (4 tools)

Manage WordPress options (settings).

• wordpress_list_options
• wordpress_get_option
• wordpress_update_option
• wordpress_delete_option

Comment Tools (5 tools)

Read and manage comments.

• wordpress_list_comments
• wordpress_get_comment
• wordpress_create_comment
• wordpress_update_comment
• wordpress_delete_comment

Other Tools (2 tools)

Miscellaneous utilities.

• wordpress_validate_security
• wordpress_switch_site

Element Operations (7 tools) NEW in 5.2

Find, update, move, duplicate, and remove individual elements within any page builder.

• respira_find_element
• respira_update_element
• respira_move_element
• respira_duplicate_element
• respira_remove_element
• respira_batch_update
• respira_reorder_elements

Page Building (3 tools) NEW in 5.2

Create complete pages, convert HTML prototypes, and apply bulk changes.

• respira_build_page
• respira_convert_html_to_builder
• respira_bulk_pages_operation

Stock Images (2 tools) NEW in 5.2

Search and sideload openly-licensed images from Openverse.

• respira_search_stock_images
• respira_sideload_image

Widget Shortcuts (27 tools) NEW in 5.2

Quick single-element additions without building full page structures.

• respira_add_heading, respira_add_text, respira_add_button, respira_add_image, respira_add_video, respira_add_divider, respira_add_spacer, respira_add_icon, respira_add_icon_list, respira_add_social_icons, respira_add_form, respira_add_map, respira_add_counter, respira_add_progress_bar, respira_add_testimonial, respira_add_tabs, respira_add_accordion, respira_add_toggle, respira_add_alert, respira_add_html, respira_add_menu, respira_add_sidebar, respira_add_search, respira_add_gallery, respira_add_slider, respira_add_pricing_table, respira_add_section

Advanced Custom Fields (54 tools) NEW in 6.6

Full ACF and ACF Pro coverage: field reads/writes, field group management, repeater and flexible-content operations, galleries, options pages, relationships, user/term fields, and bulk operations across up to 500 posts. See ACF tools overview for the full list and example workflows.

Theme Builder — Divi (3 tools) NEW in 7.6

Discover and edit Divi's global Theme Builder templates (headers, footers, and body layouts), not just 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.

• respira_list_theme_builder_templates (read)
• respira_create_theme_builder_template (write)
• respira_update_theme_builder_template (write)

Site Editor / FSE (19 tools) NEW in 8.0

Read and write the native WordPress Site Editor: block templates and template parts, synced and unsynced patterns, block navigation, and global styles. Read-only discovery is available on any site with a block theme. Structural writes are beta-gated per site and off by default. See Site Editor (Full Site Editing).

• respira_list_site_templates, respira_get_site_template, respira_create_site_template, respira_update_site_template, respira_reset_site_template
• respira_list_site_patterns, respira_get_site_pattern, respira_create_site_pattern, respira_update_site_pattern, respira_delete_site_pattern
• respira_list_site_navigations, respira_get_site_navigation, respira_create_site_navigation, respira_update_site_navigation, respira_delete_site_navigation
• respira_list_design_tokens, respira_create_design_token, respira_update_design_token, respira_delete_design_token

Activity (2 tools) NEW in 8.0

Agent-facing activity history that links audit entries to the snapshots, proposals, approvals, and rollbacks they belong to.

• respira_list_activity, respira_get_activity

Translations — WPML (3 tools) NEW in 7.6

Create and update WPML translations through the agent. 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_get_translations (read)
• respira_create_translation (write)
• respira_update_translation (write)

Quick Reference Table

This table lists documented categories, not the per-site surface. Some categories only register when the matching builder or add-on is present, so the column total is higher than what a single site sees. The measured surface is 197 tools on any WordPress site, 302 with the WooCommerce add-on (105 woocommerce_* tools), alongside 269 WebMCP abilities and 37 skills. See the live counts on respira.press.

Tool Naming Convention

All tools follow the pattern: wordpress_[action]_[resource]

• 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?

Respira provides 234 tools across the categories above. 54 new in v6.6.0 (ACF), 39 new in v5.2.0 Elemental. With the WooCommerce add-on installed, all 21 WooCommerce tools register on top.

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.