Tools Reference

Respira provides 125 MCP tools for AI assistants to interact with WordPress. 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 (12 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

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

Quick Reference Table

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 125 tools across the categories above (39 new in v5.2.0 Elemental). With WooCommerce add-on tools enabled, the inventory increases further.

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.