WordPress.com MCP tools reference

This document provides a comprehensive mapping of MCP tools available for WordPress.com developers. This is a living document and will be updated as new tools are added or existing ones are modified.

User Sites (wpcom-mcp-user-sites)

Description: List and manage user sites with filtering and metrics

Inputs:

• page (integer, min: 1, default: 1): Page number for pagination
• per_page (integer, min: 1, max: 100, default: 10): Number of sites per page
• filters (object, optional):
• search (string): Search in site names and URLs
• status (enum: active/suspended/archived): Filter by site status
• is_private (boolean): Filter by privacy setting
• has_custom_domain (boolean): Filter by custom domain presence
• sort (object, optional):
• field (enum: name/url/created/updated, default: updated): Field to sort by
• order (enum: asc/desc, default: desc): Sort order
• include_metrics (boolean, default: false): Include site metrics in response

Outputs:

• success (boolean): Operation success status
• sites (array): Site objects with blog_id, site_url, blogname, description, domain, path, privacy settings, status, dates, language, optional metrics (views, posts, storage, health)
• pagination (object): total_sites, total_pages, current_page, per_page
• summary (object): total_sites, active_sites, private_sites, custom_domains

---

User Achievements (wpcom-mcp-user-achievements)

Description: Access user achievements and progress tracking

Inputs:

• action (enum: list/get_progress/get_stats/get_trophy_case/get_feats, default: list): Achievement action to perform
• achievement_type (enum: all/achievements/feats, default: all): Type of achievements to retrieve
• limit (integer, min: 1, max: 100, default: 20): Number of items to return
• blog_id (integer, optional): Site-specific achievements

Outputs:

• success (boolean): Operation success status
• achievements (array): Achievement objects with id, name, badge_type, level, achieved_at, blog_id, description
• feats (array): Feat objects with id, name, level, best_level, achieved_at, blog_id
• progress (object): total_achievements, total_feats, highest_level, recent_activity
• trophy_case (object): featured_badges, badge_count, showcase

---

Site Users (wpcom-mcp-site-users)

Description: List users from a specific site with roles, permissions, and activity metrics

Inputs:

• wpcom_site (string, required): Site ID or URL to get users from
• page (integer, min: 1, default: 1): Page number for pagination
• per_page (integer, min: 1, max: 50, default: 10): Number of users per page
• role (string, optional): Filter by user role (admin, editor, author, etc.)
• search (string, optional): Search in user names, emails, display names
• status (enum: active/inactive, optional): Filter by user status
• registration_after (string, date format, optional): Filter by registration date
• registration_before (string, date format, optional): Filter by registration date
• orderby (enum: registered/display_name/email/login, default: registered): Sort field
• order (enum: asc/desc, default: desc): Sort direction
• include_contact_info (boolean, default: false): Include email/contact information
• include_activity_metrics (boolean, default: false): Include last login, post counts

Outputs:

• success (boolean): Operation success status
• users (array): User details with user_id, login, display_name, roles, capabilities, registration_date, optional email/last_login/post_count/comment_count
• pagination (object): Total users/pages, current page, per_page

---

User Profile (wpcom-mcp-user-profile)

Description: Get comprehensive user profile information

Inputs:

• fields (array, optional): Specific fields to retrieve
• include_preferences (boolean, default: false): Include user preferences and settings
• include_stats (boolean, default: false): Include basic account statistics
• include_account (boolean, default: false): Include account and subscription information
• include_social (boolean, default: false): Include social and community engagement data
• include_activity (boolean, default: false): Include activity and engagement metrics

Outputs:

• success (boolean): Operation success status
• profile (object): Basic user profile (id, username, email, display_name, avatar_url, locale, timezone)
• preferences (object, optional): Language, color_scheme, admin_interface, notifications, privacy_settings
• stats (object, optional): Total sites/posts/pages/comments, member_since, last_active
• account (object, optional): Plan, subscriptions, storage, bandwidth, is_paying_customer
• social (object, optional): Following/followers counts, reader subscriptions, likes, comments
• activity (object, optional): Most active site, publishing frequency, total views/visitors, recent activity

---

User Connections (wpcom-mcp-user-connections)

Description: Manage user social connections and integrations

Inputs:

• action (enum: list/get/test, default: list): Action to perform
• connection_id (integer, optional): Connection ID for get/test actions
• service (string, optional): Filter connections by service name
• status (enum: active/inactive/error, optional): Filter connections by status
• force_refresh (boolean, default: false): Force refresh connection data from external services
• include_capabilities (boolean, default: false): Include detailed capability information

Outputs:

• success (boolean): Operation success status
• connections (array): Connection objects with id, service, external_id/name/display, status, connected_date, last_tested, capabilities, health info
• total (integer): Total connections count
• summary (object): Total/active connections, services connected, last connection test

---

User Notifications (wpcom-mcp-user-notifications)

Description: Access and filter user notifications

Inputs:

• action (enum: list/get_settings/get_devices/test_delivery, default: list): Action to perform
• channel (enum: email/timeline/push/all, optional): Notification channel to query
• blog_id (integer, optional): Site-specific settings
• setting_type (enum: blogs/other/wpcom, optional): Type of notification settings
• device_id (string, optional): Device ID for push notifications

Outputs:

• success (boolean): Operation success status
• notification_settings (object): Blog settings, other settings (comment_like/reply), wpcom settings (marketing/research/community/digest/news/reports)
• devices (array): Device info with device_id/name/type, enabled status, last_seen
• summary (object): Total sites, email enabled sites, push devices, wpcom notifications count

---

User Notifications Inbox (wpcom-mcp-user-notifications-inbox)

Description: Comprehensive notifications inbox management

Inputs:

• action (enum: list/get_summary, default: list): Notification action to perform
• limit (integer, min: 1, max: 100, default: 20): Number of notifications to return
• unread_only (boolean, default: false): Return only unread notifications
• type (enum: like/follow/comment/mention/achievement/store_order/reblog/trophy, optional): Filter by notification type
• since (integer, optional): Get notifications after this timestamp
• before (integer, optional): Get notifications before this timestamp

Outputs:

• success (boolean): Operation success status
• notifications (array): Detailed notification objects with id, user_id/name, unread status, type, timestamp, subject/body (text/html), meta (blog/post info)
• summary (object): Total notifications, unread count, latest timestamp, types breakdown
• total (integer): Total notifications
• has_more (boolean): More notifications available

---

User Security (wpcom-mcp-user-security)

Description: Access user security settings and 2FA status

Inputs:

• action (enum: get_status/list_sessions/get_login_history, default: get_status): Security action to perform
• limit (integer, min: 1, max: 100, default: 10): Number of items to return for lists
• days (integer, min: 1, max: 90, default: 30): Number of days for login history

Outputs:

• success (boolean): Operation success status
• security_status (object): Two factor enabled, enhanced security, application passwords count, active sessions, last login, account age, security score
• two_factor (object): Enabled status, methods, backup codes count, enhanced security
• sessions (array): Session details with session_id, ip_address, user_agent, location, last_seen, is_current
• app_passwords (array): Application password details with uuid, app_id, name, created/last_used dates, last_ip
• login_history (array): Login attempts with timestamp, ip_address, user_agent, location, method, status

---

User Subscriptions (wpcom-mcp-user-subscriptions)

Description: Manage user subscriptions and billing information

Inputs:

• action (enum: list/get_details/get_billing_history/get_usage/get_payment_methods, default: list): Subscription action to perform
• subscription_id (integer, optional): Subscription ID for detailed queries
• limit (integer, min: 1, max: 100, default: 10): Number of items to return
• status (enum: active/cancelled/expired/all, default: active): Filter subscriptions by status

Outputs:

• success (boolean): Operation success status
• subscriptions (array): Subscription details with id, product_name/slug, site_id/url, status, cost/currency, billing_period, payment dates, auto_renew, features
• billing_history (array): Transaction history with transaction_id, date, amount/currency, description, status, payment_method, receipt_url
• payment_methods (array): Payment method details with id, type, last4, brand, expiry dates, is_default
• usage_data (object): Storage/bandwidth used/limits, sites count/limit
• summary (object): Total/active subscriptions, monthly/yearly costs, next payment date, is_paying_customer

Posts Search (wpcom-mcp-posts-search)

Description: Search posts across all user sites

Inputs:

• wpcom_site (string, optional): Site ID or URL to search posts from (if not provided, uses current site)
• search (string, optional): Search query to find posts by title, content, or excerpt
• post_type (enum: post/page/attachment/any, default: post): Post type to search
• posts_per_page (integer, min: 1, max: 50, default: 10): Number of posts to return
• paged (integer, min: 1, default: 1): Page number for pagination
• order (enum: ASC/DESC, default: DESC): Sort order
• orderby (enum: date/title/menu_order/modified/ID/relevance, default: date): Sort field
• category (string, optional): Category slug or ID to filter posts
• tag (string, optional): Tag slug or ID to filter posts
• post_status (enum: publish/private/draft/pending/future, default: publish): Post status filter
• author (integer, optional): Author ID to filter posts by
• meta_key (string, optional): Custom field key to filter by
• meta_value (string, optional): Custom field value to filter by

Outputs:

• posts (array): Post objects with ID, title, content, excerpt, status, type, dates, permalink, author info, categories, tags
• found_posts (integer): Total posts found
• max_pages (integer): Maximum pages available
• current_page (integer): Current page number
• site_info (object): Blog ID, site name, site URL

---

Post Get (wpcom-mcp-post-get)

Description: Retrieve a single post by ID or URL from any WordPress.com site

Inputs:

• wpcom_site (string, optional): Site ID or URL to get post from (if not provided, uses current site)
• post_id (integer, min: 1, optional): Post ID to retrieve
• post_url (string, optional): Post URL to retrieve
• include_comments (boolean, default: false): Include post comments in response
• Note: Either post_id or post_url must be provided

Outputs:

• post (object): Complete post data with ID, title, content, excerpt, status, type, dates, permalink, author info, categories, tags, optional comments array
• site_info (object): Blog ID, site name, site URL

---

Site Comments Search (wpcom-mcp-site-comments-search)

Description: Search comments within a WordPress.com site with filtering and threading support

Inputs:

• wpcom_site (string, required): WordPress.com site ID or URL to operate on
• search (string, optional): Search comment content and author information
• status (enum: approved/pending/spam/trash/all, default: approved): Comment status filter
• post_id (integer, optional): Filter comments by specific post ID
• author (integer, optional): Author ID to filter comments by
• comments_per_page (integer, min: 1, max: 50, default: 10): Number of comments to return
• paged (integer, min: 1, default: 1): Page number for pagination
• order (enum: ASC/DESC, default: DESC): Sort order
• orderby (enum: date/author/post, default: date): Sort field
• date_after (string, date format, optional): Filter comments after this date
• date_before (string, date format, optional): Filter comments before this date
• meta_key (string, optional): Custom field key to filter by
• meta_value (string, optional): Custom field value to filter by

Outputs:

• comments (array): Comment objects with comment_ID, content, date, author info, parent, post_ID, status, type, post_title
• found_comments (integer): Total comments found
• max_pages (integer): Maximum pages available
• current_page (integer): Current page number
• site_info (object): Blog ID, site name, site URL

---

Site Plugins (wpcom-mcp-site-plugins)

Description: Get installed plugins information for a WordPress.com site including status, details, and update availability

Inputs:

• wpcom_site (string, required): WordPress.com site ID or URL
• status (enum: active/inactive/all, default: all): Filter plugins by status
• include_updates (boolean, default: true): Include update availability information

Outputs:

• plugins (array): Plugin details with name, plugin_uri, version, description, author info, text_domain, domain_path, network status, requirements, status, plugin_file, activation permissions, update info
• summary (object): Total/active/inactive plugins, updates available count

Site Settings (wpcom-mcp-site-settings)

Description: Get comprehensive site settings and configuration including general settings, privacy options, comment settings, permalink structure, and timezone configurations

Inputs:

• wpcom_site (string, required): WordPress.com site ID or URL to get settings for
• include_general (boolean, default: true): Include general settings (blogname, blogdescription, admin_email, etc.)
• include_writing (boolean, default: false): Include writing settings (default category, post format)
• include_reading (boolean, default: false): Include reading settings (homepage, posts per page, blog_public)
• include_discussion (boolean, default: false): Include discussion settings (comments, pingbacks, moderation)
• include_media (boolean, default: false): Include media settings (image sizes, upload paths)
• include_permalinks (boolean, default: false): Include permalink settings (structure, category/tag base)
• include_privacy (boolean, default: false): Include privacy settings (policy page, data handling)

Outputs:

• success (boolean): Operation success status
• site_info (object): Blog ID, site URL, site name, privacy status
• general (object, optional): Admin email, blog name/description, comment registration, date/time formats, GMT offset, timezone, user registration settings
• writing (object, optional): Default categories, email/link categories, app/xmlrpc settings, balance tags, smilies
• reading (object, optional): Blog charset, compression, front page settings, posts per page/RSS, RSS language/excerpt settings
• discussion (object, optional): Avatar settings, comment moderation, notification settings, threading, pagination, approval requirements
• media (object, optional): Embed settings, image size dimensions (thumbnail, medium, large), crop settings
• permalinks (object, optional): Permalink structure, category base, tag base
• privacy (object, optional): Blog public setting and visibility options

Site Statistics (wpcom-mcp-site-statistics)

Description: Get comprehensive site statistics including views, visitors, top content, referrers, and performance metrics

Inputs:

• wpcom_site (string, required): WordPress.com site ID or URL
• period (enum: day/week/month/year, default: day): Time period for statistics
• num_periods (integer, min: 1, max: 365, default: 30): Number of periods to include
• include_views (boolean, default: true): Include views and visitors data
• include_top_content (boolean, default: true): Include top posts and pages
• include_referrers (boolean, default: false): Include top referrers data
• include_geographic (boolean, default: false): Include geographic data
• include_devices (boolean, default: false): Include device and browser breakdown
• include_all_time (boolean, default: false): Include all-time statistics
• max_items (integer, min: 1, max: 50, default: 10): Maximum items for lists

Outputs:

• success (boolean): Operation success status
• site_info (object): Blog ID, site URL, site name
• period_stats (object): Period, num_periods, start/end dates
• views_data (object, optional): Total views/visitors, daily average, trend, daily data array
• top_content (object, optional): Top posts/pages arrays with title, URL, views, post_id
• referrers (array, optional): Referrer and views data
• geographic (object, optional): Top countries/cities with views
• devices (object, optional): Device types and browsers breakdown
• all_time (object, optional): Total stats, first post date, site age

Site Resources (wpcom-mcp-user-sites-resource)

Type: Resource Description: Resource representation of user sites data

Inputs: None Outputs: Returns MCP TextResourceContents format with sites data in JSON format, including mimeType and URI metadata

---