Ir directamente al contenido

Referencia de herramientas MCP de WordPress.com

Este documento proporciona un mapeo completo de las herramientas MCP disponibles para desarrolladores de WordPress.com. Este es un documento vivo y se actualizará a medida que se añadan nuevas herramientas o se modifiquen las existentes.

Sitios de usuario (wpcom-mcp-user-sites)

Descripción: Listar y gestionar sitios de usuario con filtrado y métricas

Entradas:

  • page (entero, mín: 1, predeterminado: 1): Número de página para paginación
  • per_page (entero, mín: 1, máx: 100, predeterminado: 10): Número de sitios por página
  • filters (objeto, opcional):
  • search (cadena): Buscar en nombres de sitio y URL
  • status (enumerado: active/suspended/archived): Filtrar por estado del sitio
  • is_private (booleano): Filtrar por ajuste de privacidad
  • has_custom_domain (booleano): Filtrar por presencia de dominio personalizado
  • sort (objeto, opcional):
  • field (enumerado: name/url/created/updated, predeterminado: updated): Campo por el que ordenar
  • order (enumerado: asc/desc, predeterminado: desc): Orden de clasificación
  • include_metrics (booleano, predeterminado: false): Incluir métricas del sitio en la respuesta

Salidas:

  • success (booleano): Estado de éxito de la operación
  • sites (array): Objetos de sitio con blog_id, site_url, blogname, descripción, dominio, ruta, ajustes de privacidad, estado, fechas, idioma, métricas opcionales (visitas, entradas, almacenamiento, estado)
  • pagination (objeto): total_sites, total_pages, current_page, per_page
  • summary (objeto): total_sites, active_sites, private_sites, custom_domains

Logros de usuario (wpcom-mcp-user-achievements)

Descripción: Acceder a logros de usuario y seguimiento de progreso

Entradas:

  • action (enumerado: list/get_progress/get_stats/get_trophy_case/get_feats, predeterminado: list): Acción de logro a realizar
  • achievement_type (enumerado: all/achievements/feats, predeterminado: all): Tipo de logros a recuperar
  • limit (entero, mín: 1, máx: 100, predeterminado: 20): Número de elementos a devolver
  • blog_id (entero, opcional): Logros específicos del sitio

Salidas:

  • success (booleano): Estado de éxito de la operación
  • achievements (array): Objetos de logro con id, nombre, badge_type, nivel, achieved_at, blog_id, descripción
  • feats (array): Objetos de hazaña con id, nombre, nivel, best_level, achieved_at, blog_id
  • progress (objeto): total_achievements, total_feats, highest_level, recent_activity
  • trophy_case (objeto): featured_badges, badge_count, showcase

Usuarios del sitio (wpcom-mcp-site-users)

Descripción: Listar usuarios de un sitio específico con roles, permisos y métricas de actividad

Entradas:

  • wpcom_site (cadena, requerido): ID o URL del sitio del que obtener usuarios
  • page (entero, mín: 1, predeterminado: 1): Número de página para paginación
  • per_page (entero, mín: 1, máx: 50, predeterminado: 10): Número de usuarios por página
  • role (cadena, opcional): Filtrar por rol de usuario (administrador, editor, autor, etc.)
  • search (cadena, opcional): Buscar en nombres de usuario, correos electrónicos, nombres para mostrar
  • status (enumerado: active/inactive, opcional): Filtrar por estado de usuario
  • registration_after (cadena, formato de fecha, opcional): Filtrar por fecha de registro
  • registration_before (cadena, formato de fecha, opcional): Filtrar por fecha de registro
  • orderby (enumerado: registered/display_name/email/login, predeterminado: registered): Campo de ordenación
  • order (enumerado: asc/desc, predeterminado: desc): Dirección de ordenación
  • include_contact_info (booleano, predeterminado: false): Incluir información de correo electrónico/contacto
  • include_activity_metrics (booleano, predeterminado: false): Incluir último inicio de sesión, recuentos de entradas

Salidas:

  • success (booleano): Estado de éxito de la operación
  • users (array): Detalles de usuario con user_id, login, display_name, roles, capabilities, registration_date, email opcional/last_login/post_count/comment_count
  • pagination (objeto): Total de usuarios/páginas, página actual, per_page

Perfil de usuario (wpcom-mcp-user-profile)

Descripción: Obtener información completa del perfil de usuario

Entradas:

  • fields (array, opcional): Campos específicos a recuperar
  • include_preferences (booleano, predeterminado: false): Incluir preferencias y ajustes de usuario
  • include_stats (booleano, predeterminado: false): Incluir estadísticas básicas de cuenta
  • include_account (booleano, predeterminado: false): Incluir información de cuenta y suscripción
  • include_social (booleano, predeterminado: false): Incluir datos de participación social y comunitaria
  • include_activity (booleano, predeterminado: false): Incluir métricas de actividad y participación

Salidas:

  • success (booleano): Estado de éxito de la operación
  • profile (objeto): Perfil básico de usuario (id, username, email, display_name, avatar_url, locale, timezone)
  • preferences (objeto, opcional): Language, color_scheme, admin_interface, notifications, privacy_settings
  • stats (objeto, opcional): Total de sitios/entradas/páginas/comentarios, member_since, last_active
  • account (objeto, opcional): Plan, suscripciones, almacenamiento, ancho de banda, is_paying_customer
  • social (objeto, opcional): Recuentos de seguidos/seguidores, suscripciones de lector, me gusta, comentarios
  • activity (objeto, opcional): Sitio más activo, frecuencia de publicación, total de visitas/visitantes, actividad reciente

Conexiones de usuario (wpcom-mcp-user-connections)

Descripción: Gestionar conexiones sociales de usuario e integraciones

Entradas:

  • action (enumerado: list/get/test, predeterminado: list): Acción a realizar
  • connection_id (entero, opcional): ID de conexión para acciones get/test
  • service (cadena, opcional): Filtrar conexiones por nombre de servicio
  • status (enumerado: active/inactive/error, opcional): Filtrar conexiones por estado
  • force_refresh (booleano, predeterminado: false): Forzar actualización de datos de conexión desde servicios externos
  • include_capabilities (booleano, predeterminado: false): Incluir información detallada de capacidades

Salidas:

  • success (booleano): Estado de éxito de la operación
  • connections (array): Objetos de conexión con id, service, external_id/name/display, status, connected_date, last_tested, capabilities, información de estado
  • total (entero): Recuento total de conexiones
  • summary (objeto): Conexiones totales/activas, servicios conectados, última prueba de conexión

Notificaciones de usuario (wpcom-mcp-user-notifications)

Descripción: Acceder y filtrar notificaciones de usuario

Entradas:

  • action (enumerado: list/get_settings/get_devices/test_delivery, predeterminado: list): Acción a realizar
  • channel (enumerado: email/timeline/push/all, opcional): Canal de notificación a consultar
  • blog_id (entero, opcional): Ajustes específicos del sitio
  • setting_type (enumerado: blogs/other/wpcom, opcional): Tipo de ajustes de notificación
  • device_id (cadena, opcional): ID de dispositivo para notificaciones push

Salidas:

  • success (booleano): Estado de éxito de la operación
  • notification_settings (objeto): Ajustes de blog, otros ajustes (comment_like/reply), ajustes de wpcom (marketing/research/community/digest/news/reports)
  • devices (array): Información de dispositivo con device_id/name/type, estado habilitado, last_seen
  • summary (objeto): Total de sitios, sitios con correo habilitado, dispositivos push, recuento de notificaciones de wpcom

Bandeja de entrada de notificaciones de usuario (wpcom-mcp-user-notifications-inbox)

Descripción: Gestión completa de bandeja de entrada de notificaciones

Entradas:

  • action (enumerado: list/get_summary, predeterminado: list): Acción de notificación a realizar
  • limit (entero, mín: 1, máx: 100, predeterminado: 20): Número de notificaciones a devolver
  • unread_only (booleano, predeterminado: false): Devolver solo notificaciones no leídas
  • type (enumerado: like/follow/comment/mention/achievement/store_order/reblog/trophy, opcional): Filtrar por tipo de notificación
  • since (entero, opcional): Obtener notificaciones después de esta marca de tiempo
  • before (entero, opcional): Obtener notificaciones antes de esta marca de tiempo

Salidas:

  • success (booleano): Estado de éxito de la operación
  • notifications (array): Objetos de notificación detallados con id, user_id/name, estado no leído, type, timestamp, subject/body (text/html), meta (información de blog/entrada)
  • summary (objeto): Total de notificaciones, recuento de no leídas, última marca de tiempo, desglose de tipos
  • total (entero): Total de notificaciones
  • has_more (booleano): Más notificaciones disponibles

Seguridad de usuario (wpcom-mcp-user-security)

Descripción: Acceder a ajustes de seguridad de usuario y estado de 2FA

Entradas:

  • action (enumerado: get_status/list_sessions/get_login_history, predeterminado: get_status): Acción de seguridad a realizar
  • limit (entero, mín: 1, máx: 100, predeterminado: 10): Número de elementos a devolver para listas
  • days (entero, mín: 1, máx: 90, predeterminado: 30): Número de días para historial de inicio de sesión

Salidas:

  • success (booleano): Estado de éxito de la operación
  • security_status (objeto): Doble factor habilitado, seguridad mejorada, recuento de contraseñas de aplicación, sesiones activas, último inicio de sesión, antigüedad de cuenta, puntuación de seguridad
  • two_factor (objeto): Estado habilitado, métodos, recuento de códigos de respaldo, seguridad mejorada
  • sessions (array): Detalles de sesión con session_id, ip_address, user_agent, location, last_seen, is_current
  • app_passwords (array): Detalles de contraseña de aplicación con uuid, app_id, name, fechas created/last_used, last_ip
  • login_history (array): Intentos de inicio de sesión con timestamp, ip_address, user_agent, location, method, status

Suscripciones de usuario (wpcom-mcp-user-subscriptions)

Descripción: Gestionar suscripciones de usuario e información de facturación

Entradas:

  • action (enumerado: list/get_details/get_billing_history/get_usage/get_payment_methods, predeterminado: list): Acción de suscripción a realizar
  • subscription_id (entero, opcional): ID de suscripción para consultas detalladas
  • limit (entero, mín: 1, máx: 100, predeterminado: 10): Número de elementos a devolver
  • status (enumerado: active/cancelled/expired/all, predeterminado: active): Filtrar suscripciones por estado

Salidas:

  • success (booleano): Estado de éxito de la operación
  • subscriptions (array): Detalles de suscripción con id, product_name/slug, site_id/url, status, cost/currency, billing_period, fechas de pago, auto_renew, features
  • billing_history (array): Historial de transacciones con transaction_id, date, amount/currency, description, status, payment_method, receipt_url
  • payment_methods (array): Detalles de método de pago con id, type, last4, brand, fechas de caducidad, is_default
  • usage_data (objeto): Almacenamiento/ancho de banda usado/límites, recuento/límite de sitios
  • summary (objeto): Suscripciones totales/activas, costes mensuales/anuales, siguiente fecha de pago, is_paying_customer

Búsqueda de entradas (wpcom-mcp-posts-search)

Descripción: Buscar entradas en todos los sitios de usuario

Entradas:

  • wpcom_site (cadena, opcional): ID o URL del sitio donde buscar entradas (si no se proporciona, usa el sitio actual)
  • search (cadena, opcional): Consulta de búsqueda para encontrar entradas por título, contenido o extracto
  • post_type (enumerado: post/page/attachment/any, predeterminado: post): Tipo de entrada a buscar
  • posts_per_page (entero, mín: 1, máx: 50, predeterminado: 10): Número de entradas a devolver
  • paged (entero, mín: 1, predeterminado: 1): Número de página para paginación
  • order (enumerado: ASC/DESC, predeterminado: DESC): Orden de clasificación
  • orderby (enumerado: date/title/menu_order/modified/ID/relevance, predeterminado: date): Campo de ordenación
  • category (cadena, opcional): Slug o ID de categoría para filtrar entradas
  • tag (cadena, opcional): Slug o ID de etiqueta para filtrar entradas
  • post_status (enumerado: publish/private/draft/pending/future, predeterminado: publish): Filtro de estado de entrada
  • author (entero, opcional): ID de autor para filtrar entradas por
  • meta_key (cadena, opcional): Clave de campo personalizado para filtrar por
  • meta_value (cadena, opcional): Valor de campo personalizado para filtrar por

Salidas:

  • posts (array): Objetos de entrada con ID, title, content, excerpt, status, type, dates, permalink, información de autor, categorías, etiquetas
  • found_posts (entero): Total de entradas encontradas
  • max_pages (entero): Páginas máximas disponibles
  • current_page (entero): Número de página actual
  • site_info (objeto): ID de blog, nombre del sitio, URL del sitio

Obtener entrada (wpcom-mcp-post-get)

Descripción: Recuperar una sola entrada por ID o URL de cualquier sitio de WordPress.com

Entradas:

  • wpcom_site (cadena, opcional): ID o URL del sitio del que obtener entrada (si no se proporciona, usa el sitio actual)
  • post_id (entero, mín: 1, opcional): ID de entrada a recuperar
  • post_url (cadena, opcional): URL de entrada a recuperar
  • include_comments (booleano, predeterminado: false): Incluir comentarios de entrada en respuesta
  • Nota: Se debe proporcionar post_id o post_url

Salidas:

  • post (objeto): Datos completos de entrada con ID, title, content, excerpt, status, type, dates, permalink, información de autor, categorías, etiquetas, array de comentarios opcional
  • site_info (objeto): ID de blog, nombre del sitio, URL del sitio

Búsqueda de comentarios del sitio (wpcom-mcp-site-comments-search)

Descripción: Buscar comentarios dentro de un sitio de WordPress.com con filtrado y soporte de hilos

Entradas:

  • wpcom_site (cadena, requerido): ID o URL del sitio de WordPress.com sobre el que operar
  • search (cadena, opcional): Buscar contenido de comentarios e información de autor
  • status (enumerado: approved/pending/spam/trash/all, predeterminado: approved): Filtro de estado de comentario
  • post_id (entero, opcional): Filtrar comentarios por ID de entrada específico
  • author (entero, opcional): ID de autor para filtrar comentarios por
  • comments_per_page (entero, mín: 1, máx: 50, predeterminado: 10): Número de comentarios a devolver
  • paged (entero, mín: 1, predeterminado: 1): Número de página para paginación
  • order (enumerado: ASC/DESC, predeterminado: DESC): Orden de clasificación
  • orderby (enumerado: date/author/post, predeterminado: date): Campo de ordenación
  • date_after (cadena, formato de fecha, opcional): Filtrar comentarios después de esta fecha
  • date_before (cadena, formato de fecha, opcional): Filtrar comentarios antes de esta fecha
  • meta_key (cadena, opcional): Clave de campo personalizado para filtrar por
  • meta_value (cadena, opcional): Valor de campo personalizado para filtrar por

Salidas:

  • comments (array): Objetos de comentario con comment_ID, content, date, información de autor, parent, post_ID, status, type, post_title
  • found_comments (entero): Total de comentarios encontrados
  • max_pages (entero): Páginas máximas disponibles
  • current_page (entero): Número de página actual
  • site_info (objeto): ID de blog, nombre del sitio, URL del sitio

Plugins del sitio (wpcom-mcp-site-plugins)

Descripción: Obtener información de los plugins instalados para un sitio de WordPress.com, incluido el estado, detalles y disponibilidad de actualizaciones

Entradas:

  • wpcom_site (cadena, requerido): ID o URL del sitio de WordPress.com
  • status (enumerado: active/inactive/all, predeterminado: all): Filtrar plugins por estado
  • include_updates (booleano, predeterminado: true): Incluir información de disponibilidad de actualización

Salidas:

  • plugins (array): Detalles de plugin con name, plugin_uri, version, description, información de autor, text_domain, domain_path, estado de red, requisitos, status, plugin_file, permisos de activación, información de actualización
  • summary (objeto): Total de plugins activos/inactivos, recuento de actualizaciones disponibles

Ajustes del sitio (wpcom-mcp-site-settings)

Descripción: Obtener ajustes y configuración completos del sitio, incluidos ajustes generales, opciones de privacidad, ajustes de comentarios, estructura de enlaces permanentes y configuraciones de zona horaria

Entradas:

  • wpcom_site (cadena, requerido): ID o URL del sitio de WordPress.com para obtener ajustes
  • include_general (booleano, predeterminado: true): Incluir ajustes generales (blogname, blogdescription, admin_email, etc.)
  • include_writing (booleano, predeterminado: false): Incluir ajustes de escritura (categoría predeterminada, formato de entrada)
  • include_reading (booleano, predeterminado: false): Incluir ajustes de lectura (página de inicio, entradas por página, blog_public)
  • include_discussion (booleano, predeterminado: false): Incluir ajustes de discusión (comentarios, pingbacks, moderación)
  • include_media (booleano, predeterminado: false): Incluir ajustes de medios (tamaños de imagen, rutas de carga)
  • include_permalinks (booleano, predeterminado: false): Incluir ajustes de enlaces permanentes (estructura, base de categoría/etiqueta)
  • include_privacy (booleano, predeterminado: false): Incluir ajustes de privacidad (página de política, manejo de datos)

Salidas:

  • success (booleano): Estado de éxito de la operación
  • site_info (objeto): ID de blog, URL del sitio, nombre del sitio, estado de privacidad
  • general (objeto, opcional): Correo de administrador, nombre/descripción del blog, registro de comentarios, formatos de fecha/hora, desplazamiento GMT, zona horaria, ajustes de registro de usuario
  • writing (objeto, opcional): Categorías predeterminadas, categorías de correo/enlace, ajustes de app/xmlrpc, etiquetas de balance, emoticones
  • reading (objeto, opcional): Charset del blog, compresión, ajustes de página principal, entradas por página/RSS, ajustes de idioma/extracto RSS
  • discussion (objeto, opcional): Ajustes de avatar, moderación de comentarios, ajustes de notificación, hilos, paginación, requisitos de aprobación
  • media (objeto, opcional): Ajustes de incrustación, dimensiones de tamaño de imagen (miniatura, mediana, grande), ajustes de recorte
  • permalinks (objeto, opcional): Estructura de enlaces permanentes, base de categoría, base de etiqueta
  • privacy (objeto, opcional): Ajuste público del blog y opciones de visibilidad

Estadísticas del sitio (wpcom-mcp-site-statistics)

Descripción: Obtener estadísticas completas del sitio, incluidas visitas, visitantes, contenido principal, referentes y métricas de rendimiento

Entradas:

  • wpcom_site (cadena, requerido): ID o URL del sitio de WordPress.com
  • period (enumerado: day/week/month/year, predeterminado: day): Período de tiempo para estadísticas
  • num_periods (entero, mín: 1, máx: 365, predeterminado: 30): Número de períodos a incluir
  • include_views (booleano, predeterminado: true): Incluir datos de visitas y visitantes
  • include_top_content (booleano, predeterminado: true): Incluir entradas y páginas principales
  • include_referrers (booleano, predeterminado: false): Incluir datos de referentes principales
  • include_geographic (booleano, predeterminado: false): Incluir datos geográficos
  • include_devices (booleano, predeterminado: false): Incluir desglose de dispositivos y navegadores
  • include_all_time (booleano, predeterminado: false): Incluir estadísticas de todos los tiempos
  • max_items (entero, mín: 1, máx: 50, predeterminado: 10): Elementos máximos para listas

Salidas:

  • success (booleano): Estado de éxito de la operación
  • site_info (objeto): ID de blog, URL del sitio, nombre del sitio
  • period_stats (objeto): Período, num_periods, fechas de inicio/fin
  • views_data (objeto, opcional): Total de visitas/visitantes, promedio diario, tendencia, array de datos diarios
  • top_content (objeto, opcional): Matrices de entradas/páginas principales con title, URL, views, post_id
  • referrers (array, opcional): Datos de referente y visitas
  • geographic (objeto, opcional): Países/ciudades principales con visitas
  • devices (objeto, opcional): Desglose de tipos de dispositivos y navegadores
  • all_time (objeto, opcional): Estadísticas totales, fecha de primera entrada, antigüedad del sitio

Recursos del sitio (wpcom-mcp-user-sites-resource)

Tipo: Recurso Descripción: Representación de recurso de datos de sitios de usuario

Entradas: Ninguna Salidas: Devuelve formato de MCP TextResourceContents con datos de sitios en formato JSON, incluidos metadatos de mimeType y URI


Última actualización: febrero 03, 2026