Riferimento tool

Il server MCP registra 84 tool, tutti con nome wp_*. Qui sono raggruppati per attività, con lo scope che serve a ogni gruppo. Per i parametri di ogni tool e una chiamata d’esempio, apri il catalogo completo.

In questa pagina

Come i tool arrivano al tuo sito

L’assistente non vede mai WordPress direttamente. Chiama un tool come wp_set_seo sul server MCP; il server lo trasforma in una richiesta HTTPS all’API REST del plugin sotto /wp-json/wpcb/v1, firmata con il tuo token. Il plugin controlla gli scope del token e la capability WordPress dell’utente a cui appartiene, esegue la modifica e scrive una voce nel registro delle chiamate.

In Claude Code un tool compare come mcp__<nome del server>__wp_set_seo, dove il nome del server è quello che hai dato al sito quando l’hai aggiunto. L’assistente sceglie quello giusto quando nomini il sito nel prompt.

Un tool funziona solo se il token ha il suo scope. I tool di lettura chiedono …:read; tutto ciò che cambia il sito chiede il relativo scope di scrittura. Vedi Permessi dei token.

Articoli e pagine

Leggere, scrivere e pubblicare contenuti. Le modifiche salvano prima una revisione di WordPress; un articolo creato con stato “publish” resta una bozza se il token non ha content:publish.

Scopecontent:read · content:write · content:publish

wp_list_postswp_get_postwp_searchwp_create_postwp_update_postwp_delete_postwp_publish_postwp_list_pageswp_create_pagewp_update_pagewp_delete_page

Categorie e tag

Elencare i termini di qualsiasi tassonomia e crearne di nuovi.

Scopecontent:read · content:write

wp_list_termswp_create_term

Media

Elencare la libreria, caricare da URL o in base64, impostare testo alternativo, didascalie e descrizioni, ottimizzare immagini, trovare file che nessuno usa, eliminare con conferma.

Scopemedia:read · media:write

wp_list_mediawp_upload_media_urlwp_upload_media_b64wp_set_media_metawp_optimize_imagewp_find_unused_mediawp_delete_media

SEO

Leggere e scrivere i meta SEO nei campi che il tuo plugin SEO già usa, analizzare un articolo, controllarne molti insieme, verificare la sitemap, trovare i link rotti.

Scopeseo:read · seo:write

wp_get_seowp_set_seowp_analyze_seowp_audit_seo_bulkwp_get_sitemap_statuswp_find_broken_links

Analytics

Leggere il traffico dal plugin di statistiche del sito: panoramica, contenuti più visti, parole chiave, provenienze, un singolo articolo, confronto tra periodi, andamento per categoria, pagine senza traffico.

Scopeanalytics:read

wp_analytics_detectwp_analytics_overviewwp_analytics_top_postswp_analytics_top_keywordswp_analytics_top_referrerswp_analytics_post_statswp_analytics_compare_periodwp_analytics_trend_by_categorywp_analytics_no_traffic_pages

Multilingua

Lingue, traduzioni di articoli e media, controllo delle traduzioni delle stringhe. Funziona con WPML; sui siti senza un plugin multilingua supportato questi tool non trovano lingue.

Scopecontent:read · content:write · media:write

wp_multilingual_detectwp_list_languageswp_get_post_translationswp_link_post_translationwp_set_post_languagewp_get_media_translationswp_set_media_translation_metawp_audit_media_translationswp_list_string_translationswp_audit_string_translations

Tema e aspetto

Il tema attivo e i suoi file, CSS personalizzato, cambio di tema, menu, widget e Customizer. La scrittura dei file del tema conserva la versione precedente.

Scopetheme:read · theme:write · site:read · site:write

wp_get_active_themewp_list_theme_fileswp_read_theme_filewp_write_theme_filewp_inject_custom_csswp_switch_themewp_get_menuswp_create_menuwp_update_menuwp_get_widgetswp_set_widgetswp_get_customizerwp_set_customizer

Plugin

Elencare i plugin con gli aggiornamenti disponibili, installare dalla directory di WordPress.org, da un URL di uno zip o da uno zip locale fino a 20 MB (con conferma), attivare, disattivare, leggere e scrivere i file dei plugin, creare lo scheletro di un nuovo plugin.

Scopeplugin:read · plugin:write · plugin:install

wp_list_pluginswp_install_plugin_repowp_install_plugin_zipwp_activate_pluginwp_deactivate_pluginwp_read_plugin_filewp_write_plugin_filewp_scaffold_plugin

File

Elencare, leggere, cercare e scaricare file; scrivere, caricare, creare cartelle, rinominare ed eliminare. Dal plugin 1.7.0, site:write cambia file solo dentro la cartella uploads (solo tipi inerti); altrove serve anche fs:admin, e lì ogni sovrascrittura, rinomina o eliminazione chiede conferma. I segreti come wp-config.php e .env non si leggono e non si cambiano mai. Tutti i tool dei file richiedono un account amministratore.

Scopesite:read · site:write · fs:admin

wp_fs_listwp_fs_readwp_fs_searchwp_fs_downloadwp_fs_writewp_fs_uploadwp_fs_mkdirwp_fs_renamewp_fs_delete

Sito e sistema

Impostazioni (cambiare l’indirizzo del sito o l’email dell’amministratore chiede conferma), controlli di salute e prestazioni, backup completi su richiesta e ripristino.

Scopesite:read · site:write · system:backup

wp_get_settingswp_set_settingswp_health_checkwp_performance_checkwp_backup_createwp_backup_listwp_backup_restore

Avanzati

SQL attraverso una protezione che di default ammette solo SELECT e chiede conferma per ogni scrittura, e WP-CLI limitato a una lista di comandi e spento finché il proprietario del sito non lo attiva.

Scopedb:read · db:write · cli:exec

wp_db_querywp_cli_exec

Cosa non è un tool

Alcune route REST del plugin non hanno un tool MCP, perché le usa direttamente Xaflo Desktop: la manutenzione (/maintenance), la console di debug.log (/debug/log), il registro delle chiamate e la gestione dei token. Il link monouso per entrare in wp-admin (/admin/login-link) è escluso di proposito: è una credenziale per una persona, non per un modello. Tutte le route sono nel Riferimento API REST.