WordPress MCP Server
Provides comprehensive control over WordPress sites, enabling AI agents to read blog context, create and update draft posts, manage post lifecycle (publish, draft, trash, delete), handle categories and tags with multilingual support, upload featured images from local paths/URLs/Base64, manage and audit plugins with WordPress.org update checks, moderate and reply to comments, update site settings, and purge caches (WP Super Cache, Docket Cache, OPcache).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WordPress MCP Server draft a post about our summer sale and add a featured image"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WordPress MCP Server
Servidor de Model Context Protocol (MCP) basado en Python y FastMCP que proporciona a agentes de Inteligencia Artificial (Claude Desktop, Cursor, Antigravity, VS Code / Cline, Windsurf, etc.) control integral sobre sitios WordPress.
Desarrollado y mantenido por Rodrigo Ernesto Hernandez (4Ruy.com).
Permite redactar y publicar artículos, gestionar taxonomías multilingües con Polylang, subir imágenes de portada (locales, URLs o Base64), administrar plugins con comprobación de versiones en WordPress.org, moderar y responder comentarios, y purgar cachés de forma atómica.
📋 Tabla de Contenidos
Related MCP server: WordPress MCP Server
✨ Características Principales
Gestión Editorial Completa: Lectura contextual del blog en texto plano para evitar duplicidad de temas, creación de borradores enriquecidos en HTML, actualización de posts existentes y control del ciclo de vida (borrador, publicar, papelera o eliminación permanente).
Soporte Multilingüe (Polylang Free): Vinculación bidireccional nativa entre entradas en distintos idiomas (
pll_save_post_translations) y de términos taxonómicos (pll_save_term_translations) superando las limitaciones de la REST API estándar de Polylang Free.Taxonomías Técnicas: CRUD de categorías y etiquetas con asignación de idioma, slugs limpios y descripciones optimizadas para SEO.
Biblioteca Multimedia Inteligente: Subida de portadas e imágenes destacadas aceptando rutas locales del sistema operativo, URLs remotas o datos codificados en Base64, con asignación automática de texto alternativo (
alt_text) y vinculación directa al post.Administración y Auditoría de Plugins: Listado de plugins activos e inactivos, consulta en tiempo real a la API pública de WordPress.org para verificar si existen actualizaciones disponibles, activación, desactivación y actualización de plugins.
Moderación y Respuestas de Comentarios: Consulta de comentarios por estado (aprobado, pendiente, spam), cambio de estado y publicación de respuestas oficiales anidadas en el hilo.
Purgado Multinivel de Caché: Endpoint optimizado para invalidar simultáneamente WP Super Cache, Docket Cache y la caché de código de bytes OPcache de PHP.
🏗️ Arquitectura y Estructura
wordpress-mcp-server/
├── wp_mcp_server.py # Servidor FastMCP en Python (17 herramientas operativas)
├── requirements.txt # Dependencias esenciales de Python
├── pyproject.toml # Empaquetado y metadatos estándar de Python
├── .env.example # Plantilla para variables de entorno de conexión
├── .gitignore # Reglas estrictas de exclusión (ignora .env, cachés, etc.)
├── LICENSE # Licencia de código abierto MIT
├── README.md # Documentación técnica completa
└── wordpress-plugin/
├── README.md # Guía de instalación del plugin puente
└── polylang-mcp-bridge.php # Plugin WordPress para Polylang Free y purga de caché🧰 Tecnologías Utilizadas
FastMCP / Model Context Protocol: Protocolo estándar abierto que permite a los LLMs interactuar de forma segura con herramientas locales y APIs.
Python 3.10+: Motor del servidor, con tipado estricto mediante anotaciones de tipo (
typing).Requests & HTTPBasicAuth: Comunicación robusta con la REST API de WordPress usando Application Passwords.
WordPress REST API (v2): Interfaz REST estándar de WordPress para posts, taxonomías, medios, plugins y ajustes.
Polylang Bridge (PHP): Micro-plugin complementario para solventar la ausencia de endpoints nativos de vinculación en la versión gratuita de Polylang.
🛠️ Catálogo de Herramientas MCP (17 Tools)
Módulo | Herramienta | Parámetros Principales | Descripción |
Contenido |
|
| Obtiene los artículos recientes en texto plano para contextualizar estilo y evitar temas repetidos. |
Contenido |
|
| Crea o actualiza una entrada en estado borrador con metadatos completos y asignación de idioma. |
Contenido |
|
| Actualiza selectivamente cualquier campo de una entrada existente. |
Contenido |
|
| Gestiona el ciclo de vida y visibilidad de un post. |
Polylang |
|
| Enlaza dos publicaciones como traducciones recíprocas Español/Inglés en Polylang Free. |
Taxonomías |
|
| Operaciones CRUD completas para categorías con soporte multilingüe. |
Taxonomías |
|
| Operaciones CRUD completas para etiquetas (tags). |
Taxonomías |
|
| Vincula dos términos como traducciones directas en Polylang Free. |
Medios |
|
| Sube una imagen a la biblioteca de medios y opcionalmente la asigna como destacada. |
Caché |
| (Ninguno) | Invalida de forma atómica WP Super Cache, Docket Cache y OPcache. |
Plugins |
|
| Lista plugins instalados (activos/inactivos) y consulta actualizaciones en WordPress.org. |
Plugins |
|
| Modifica el estado o actualiza cualquier plugin instalado. |
Comentarios |
|
| Lista comentarios con filtros por estado o por post. |
Comentarios |
|
| Aplica acciones de moderación sobre comentarios de usuarios. |
Comentarios |
|
| Publica una respuesta oficial anidada en el hilo de discusión. |
Ajustes |
| (Ninguno) | Consulta metadatos globales del sitio (título, descripción, zona horaria, URL, etc.). |
Ajustes |
|
| Actualiza configuraciones generales de WordPress. |
🔑 Requisitos Previos en WordPress
1. Generar una Contraseña de Aplicación (Application Password)
WordPress incluye soporte nativo para Application Passwords desde la versión 5.6:
Inicia sesión en el panel de control de WordPress con un usuario Administrador o Editor.
Dirígete a Usuarios > Tu perfil.
Desplázate hacia abajo hasta la sección Contraseñas de aplicación.
Escribe un nombre descriptivo (por ejemplo:
MCP Server) y pulsa en Añadir nueva contraseña de aplicación.Copia la contraseña de 24 caracteres generada (ej:
xxxx xxxx xxxx xxxx xxxx xxxx).
La contraseña de aplicación no expone tu contraseña personal y puede ser revocada en cualquier momento desde el mismo panel.
2. Instalar el Plugin Puente para Polylang y Caché (Opcional pero recomendado)
Si utilizas Polylang o sistemas de caché en servidor:
Copia el archivo
wordpress-plugin/polylang-mcp-bridge.phpen la carpetawp-content/plugins/polylang-mcp-bridge/de tu instalación de WordPress.Activa el plugin WordPress MCP REST Bridge (Polylang & Cache) desde el menú Plugins de WordPress.
🚀 Instalación y Puesta en Marcha
1. Clonar el Repositorio
git clone https://github.com/ernestoh0183/wordpress-mcp-server.git
cd wordpress-mcp-server2. Configurar el Entorno Virtual de Python
# Crear entorno virtual
python -m venv .venv
# Activar en Windows (PowerShell):
.\.venv\Scripts\Activate.ps1
# Activar en Linux/macOS:
source .venv/bin/activate
# Instalar dependencias
pip install -r requirements.txt3. Configurar Credenciales (.env)
Copia la plantilla .env.example:
cp .env.example .envEdita .env con los datos de tu sitio:
WP_URL=https://your-wordpress-site.com
WP_USER=your_username
WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx🔌 Configuración en Clientes MCP
Claude Desktop
Edita tu archivo de configuración de Claude Desktop:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"wordpress": {
"command": "python",
"args": ["C:/ruta/a/wordpress-mcp-server/wp_mcp_server.py"],
"env": {
"WP_URL": "https://your-wordpress-site.com",
"WP_USER": "your_username",
"WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
}
}
}
}Cursor
En Cursor, abre Settings > Features > MCP Servers y añade un nuevo servidor:
Name:
wordpressType:
commandCommand:
python C:/ruta/a/wordpress-mcp-server/wp_mcp_server.py
Antigravity / Gemini CLI
Añade a tu configuración en mcp_config.json:
{
"mcpServers": {
"wordpress": {
"command": "python",
"args": ["C:/ruta/a/wordpress-mcp-server/wp_mcp_server.py"],
"env": {
"WP_URL": "https://your-wordpress-site.com",
"WP_USER": "your_username",
"WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
}
}
}
}🔒 Seguridad
Sin credenciales maestras: Se apoya exclusivamente en Application Passwords con autenticación HTTP Basic sobre TLS/HTTPS.
Protección de
.env: El archivo.envestá expresamente excluido en.gitignorepara evitar filtraciones accidentales de credenciales.Validación de entradas: Todos los slugs, IDs y contenidos HTML son sanitizados y validados antes de transmitirse a la REST API de WordPress.
Permisos de usuario: Cada endpoint respeta los roles y capacidades del usuario autenticado en WordPress (
edit_posts,manage_categories,manage_options).
👨💻 Autor y Contacto
Creado y mantenido por Rodrigo Ernesto Hernandez.
Si buscas consultoría, integración personalizada de agentes de IA con WordPress, desarrollo a medida o automatización de flujos de trabajo editoriales para tu empresa, puedes contactarme directamente:
🌐 Sitio Web Personal: rodrigo.us
🚀 Portal Tecnológico: 4ruy.com
✉️ Correo Electrónico: rodrigo@4ruy.com / rodrigo@rodrigo.us
¿Te resulta útil este proyecto? Dale una ⭐ en GitHub y compártelo.
📄 Licencia
Este proyecto es de código abierto y está distribuido bajo la Licencia MIT. Creado por Rodrigo Ernesto Hernandez (© 2026). Consulta el archivo LICENSE para más detalles.
Available Tools
17 toolsactualizar_configuracionB
Actualiza opciones generales de WordPress (Título, Tagline, Zona Horaria, Logo o Favicon).
Args: titulo: Nuevo título para el blog (opcional). descripcion: Nuevo subtítulo o lema (tagline) del sitio (opcional). zona_horaria: Identificador de zona horaria (ej. 'America/Santiago') (opcional). site_logo_id: Media ID de la imagen para el logotipo oficial del sitio (opcional). site_icon_id: Media ID de la imagen para el icono/favicon del sitio (opcional).
Returns: Confirmación de las configuraciones modificadas.
Inputs: titulo, descripcion, site_icon_id, site_logo_id, +1 more. Returns: result
actualizar_postB
Actualiza atributos específicos de un post existente en WordPress (título, contenido, extracto, slug, portada, categorías, etiquetas o estado).
Args: post_id: ID del post a modificar en WordPress. titulo: Nuevo título (opcional). contenido_html: Nuevo cuerpo en HTML (opcional). extracto: Nuevo extracto descriptivo (opcional). slug: Nuevo slug para la URL (opcional). imagen_portada_id: Media ID de la imagen destacada (opcional). categorias: Lista de IDs de categorías a asignar (opcional). etiquetas: Lista de IDs de etiquetas a asignar (opcional). estado: 'draft', 'publish', 'pending', etc. (opcional).
Returns: Confirmación de los campos actualizados y enlace de la publicación.
Inputs: post_id (required), slug, estado, titulo, +5 more. Returns: result
administrar_pluginA
Permite activar, desactivar, instalar o eliminar un plugin en WordPress.
Args: plugin_slug: Slug o clave del plugin. Para instalar: slug del directorio de WordPress.org (ej. 'classic-editor'). Para activar/desactivar/eliminar: clave del plugin (ej. 'akismet/akismet'). accion: Una de las siguientes acciones: 'activar', 'desactivar', 'instalar', 'eliminar'.
Returns: Mensaje con el resultado de la operación.
Inputs: accion (required), plugin_slug (required). Returns: result
gestionar_categoriaA
Gestiona categorías en WordPress: listar, crear, actualizar o eliminar, con soporte para descripciones SEO y vinculación Polylang.
Args: accion: 'listar', 'crear', 'actualizar', o 'eliminar'. nombre: Nombre de la categoría (para crear/actualizar). slug: Slug amigable para la URL (opcional). descripcion: Descripción temática para SEO y GEO/AEO (opcional). categoria_id: ID de la categoría (requerido para actualizar o eliminar). idioma: 'es' o 'en' (opcional, para vincular en Polylang). categoria_traduccion_id: ID de la categoría hermana en el otro idioma (opcional).
Returns: Listado de categorías o confirmación de la operación realizada.
Inputs: accion (required), slug, idioma, nombre, +3 more. Returns: result
gestionar_etiquetaA
Gestiona etiquetas (tags) en WordPress: listar, crear, actualizar o eliminar, con soporte para descripciones SEO y vinculación Polylang.
Args: accion: 'listar', 'crear', 'actualizar', o 'eliminar'. nombre: Nombre de la etiqueta (para crear/actualizar). slug: Slug amigable para la URL (opcional). descripcion: Descripción de la tecnología o concepto para SEO (opcional). etiqueta_id: ID de la etiqueta (requerido para actualizar o eliminar). idioma: 'es' o 'en' (opcional, para vincular en Polylang). etiqueta_traduccion_id: ID de la etiqueta hermana en el otro idioma (opcional).
Returns: Listado de etiquetas o confirmación de la operación realizada.
Inputs: accion (required), slug, idioma, nombre, +3 more. Returns: result
gestionar_postA
Gestiona el ciclo de vida de una publicación en WordPress (publicar, volver a borrador o eliminar).
Args: post_id: ID del post en WordPress. accion: 'publicar' (status='publish'), 'borrador' (status='draft'), o 'eliminar' (borrado definitivo).
Returns: Confirmación de la acción realizada con la URL actualizada del post.
Inputs: accion (required), post_id (required). Returns: result
leer_contexto_blogA
Obtiene los artículos publicados más recientes del blog en texto plano.
Permite al agente comprender el tono editorial, estilo y temas recientemente cubiertos para evitar contenido duplicado. Soporta filtrado por idioma (es/en).
Args: limite: Cantidad de artículos a consultar (por defecto 5, máx 20). idioma: Código de idioma opcional según Polylang ('es' para español, 'en' para inglés).
Returns: Resumen estructurado con ID, fecha, título, link y extracto de cada publicación.
Inputs: idioma, limite. Returns: result
moderar_comentarioB
Modifica el estado de un comentario o lo elimina.
Args: comentario_id: ID del comentario en WordPress. accion: 'aprobar' (approve), 'pendiente' (hold), 'spam', 'papelera' (trash), o 'eliminar_definitivo' (borrado irreversible).
Returns: Confirmación del cambio de estado.
Inputs: accion (required), comentario_id (required). Returns: result
obtener_configuracionesA
Obtiene las configuraciones y metadatos generales del sitio web (título, descripción, URL, email administrativo, zona horaria, formato de fecha e idioma del sitio).
Returns: Resumen de las opciones configuradas en WordPress.
Inputs: no named parameters. Returns: result
publicar_borrador_wpA
Crea un nuevo post o actualiza uno existente en WordPress en estado 'draft' (borrador).
Soporta categorías, etiquetas técnicas, slug SEO, extracto descriptivo, imagen de portada y asignación/vinculación de idioma en Polylang.
Args: titulo: Título del post. contenido_html: Cuerpo completo del post en HTML limpio (h2, p, code, etc.). imagen_portada_id: ID devuelto previamente por 'subir_imagen_portada' (opcional). categorias: Lista de IDs de categorías de WP (ej. [132, 137]). etiquetas: Lista de IDs de etiquetas de WP (ej. [147, 157]). slug: Slug amigable para la URL del post (ej. 'caddy-docker-microservices'). extracto: Resumen breve del artículo para meta-descripción y feeds (opcional). idioma: Código del idioma ('es' o 'en') para Polylang (opcional). post_traduccion_id: ID del post en el otro idioma para vincularlos como traducciones (opcional). post_id: ID del post existente a actualizar (si se omite, crea un post nuevo).
Returns: Confirmación con ID del post, título, estado y enlaces directos de previsualización y edición.
Inputs: titulo (required), contenido_html (required), slug, idioma, +6 more. Returns: result
purgar_cache_sitioA
Purga de inmediato las cachés del servidor (WP Super Cache, Docket Cache y OPcache) para que las publicaciones, cambios de menú, widgets y taxonomías se reflejen en el acto.
Returns: Confirmación de las cachés purgadas y timestamp.
Inputs: no named parameters. Returns: result
responder_comentarioB
Publica una respuesta a un comentario específico de un post.
Args: comentario_id: ID del comentario padre al que se responde. post_id: ID del post donde se encuentra el comentario. contenido: Texto de la respuesta.
Returns: Confirmación con el ID del nuevo comentario generado.
Inputs: post_id (required), contenido (required), comentario_id (required). Returns: result
revisar_comentariosA
Lista los comentarios del blog según su estado de moderación.
Args: estado: Filtro por estado: 'all' (todos), 'hold' (pendientes de revisión), 'approve' (aprobados), 'spam' o 'trash' (papelera). limite: Número máximo de comentarios a devolver (por defecto 10, máx 30).
Returns: Listado con ID del comentario, ID del post, autor, fecha, estado y contenido.
Inputs: estado, limite. Returns: result
revisar_pluginsA
Obtiene la lista completa de plugins instalados en WordPress, su estado (activo/inactivo), versión actual, y opcionalmente verifica si hay actualizaciones en WordPress.org.
Args: verificar_actualizaciones: Si es True, consulta el repositorio oficial de WordPress.org para ver si la versión instalada está actualizada.
Returns: Reporte consolidado de todos los plugins instalados.
Inputs: verificar_actualizaciones. Returns: result
subir_imagen_portadaA
Sube una imagen a la biblioteca de medios de WordPress para ser usada como portada.
El argumento 'origen_imagen' puede ser:
Una ruta a un archivo local en disco (ej. 'C:\imagenes\portada.jpg').
Una URL pública directa a la imagen (ej. 'https://.../imagen.jpg').
Una cadena codificada en Base64.
Args: origen_imagen: Ruta local, URL HTTP/HTTPS o string en base64 de la imagen. nombre_archivo: Nombre con el que se guardará en WordPress (opcional, ej. 'ia-portada.jpg'). texto_alt: Texto alternativo para SEO y accesibilidad (opcional).
Returns: Diccionario con el resultado, ID asignado en WordPress y URL pública: {"status": "success", "id": 1045, "url": "https://..."}
Inputs: origen_imagen (required), texto_alt, nombre_archivo.
vincular_terminos_polylangB
Vincula dos términos taxonómicos (categorías o etiquetas) en Polylang Free para que se reconozcan como versiones traducidas en Español e Inglés.
Args: termino_id_es: ID del término en español. termino_id_en: ID del término en inglés. taxonomia: 'category' para categorías o 'post_tag' para etiquetas.
Returns: Confirmación del enlace en Polylang.
Inputs: termino_id_en (required), termino_id_es (required), taxonomia. Returns: result
vincular_traducciones_polylangB
Vincula dos artículos existentes en WordPress para que Polylang los reconozca como la versión en Español y la versión en Inglés del mismo artículo.
Args: post_id_es: ID del artículo en español. post_id_en: ID del artículo en inglés.
Returns: Confirmación del enlace entre ambas traducciones.
Inputs: post_id_en (required), post_id_es (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Most tools are clearly distinct (settings vs. media vs. plugins vs. comments), but three post tools overlap: publicar_borrador_wp can both create and update via post_id, actualizar_post updates many of the same fields including estado, and gestionar_post also changes status/delete. An agent could reasonably be unsure whether to update a post with publicar_borrador_wp, actualizar_post, or gestionar_post.
Nearly all names follow a Spanish verb_noun pattern (obtener_configuraciones, actualizar_post, gestionar_categoria, revisar_comentarios), which is predictable. Minor deviations exist: the _wp suffix on publicar_borrador_wp, singular vs. plural (revisar_plugins / administrar_plugin), and English nouns (post, plugin) mixed with Spanish verbs.
17 tools is slightly above the ideal range but each covers a distinct area (posts, taxonomies, translations, media, plugins, comments, settings, cache). The set is well-scoped for a full WordPress management server rather than padded.
Core lifecycle is well covered: post create/update/publish/delete, category and tag CRUD, comment list/moderate/reply, plugin list/manage, media upload, settings get/update, and cache purge. Minor gaps remain, such as fetching a single post by ID, listing/deleting media, and menu or user management.
Maintenance
Related MCP Connectors
Manage your WordPress site from your AI assistant: posts, pages, media, comments and WooCommerce.
Manage your WordPress site from ChatGPT or Claude: posts, WooCommerce, SEO, images and upkeep.
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
Manage a WordPress site from your AI assistant: read, search, propose edits, Search Console data.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI agents to manage WordPress sites with 190+ tools for content management, theme/plugin customization, file system operations, WooCommerce, and complete site control through natural language.10029 npm56MIT
- AlicenseCqualityDmaintenanceEnables AI to manage WordPress sites with 190+ tools for complete control over content, themes, plugins, files, and more.100MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to manage WordPress sites via ~74 capabilities including content, media, plugins, themes, and more.-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to manage WordPress sites through the WordPress REST API, supporting content, media, users, settings, and Elementor management with safety policies for production use.MIT