wsp_get_posts
Returns blog posts with full metadata.
LABSCO SUMMARY
Every ability is off until you turn it on, and every call is logged.
Two things make this safe enough to point an agent at a live site: writes stay unregistered by default across every suite, and the audit log records who called what and whether it was allowed, denied or errored — stored in your own database with nothing sent anywhere. The integration suites only appear when their plugin is active, so the tool list matches the site rather than a catalogue.
What it is
A WordPress plugin that ships its own MCP server at /wp-json/wsp-mcp/v1/mcp, with no companion plugin, adapter or Node bridge for clients that speak remote HTTP. Abilities are toggled individually in wp-admin, and each one enforces the WordPress capability it needs.
What you get
- Core WordPress — read, create, update and delete posts and pages; categories and tags; comment moderation; users; site info and active plugins; content search
- Media — list, get and count are reads; update, delete and upload are writes.
wsp_upload_mediaaccepts a public URL or base64 content, so a file attached to the chat goes straight into the library;wsp_get_mediareturns one attachment's metadata andwsp_list_mediabrowses the library - Elementor — list pages, read the element tree, find and update elements, add widgets and containers, remove elements, plus advanced design tools for kit colours and fonts, widget schemas, element duplication and responsive breakpoints
- WooCommerce — products and variations, orders and status changes, refunds, coupons, order notes, customers, sales reports, low-stock alerts and review moderation
- Advanced Custom Fields — field groups, fields, values with dot-notation deep access, custom post types, taxonomies and options pages
- Forms — Gravity Forms, WPForms and Contact Form 7 suites, each registered only when that plugin is active, with reads on by default and every write off
- An audit log table records each
tools/callwith tool name, UTC timestamp, acting user, request IP and outcome; a daily cron prunes entries older than 90 days
Requirements
WordPress 6.9+ and PHP 7.4+ — the authors recommend 7.0.3 or 6.9.6+ so the recent core security fixes are in place. Install and activate the plugin, enable the abilities you want under MCP > Settings, then copy the pre-filled snippet for your client from MCP > Connection. Authenticate with a WordPress Application Password or the plugin's own API key sent as Authorization: Bearer. Cursor, Codex and Antigravity connect natively; Claude Desktop and OpenClaw go through the mcp-remote bridge, which needs Node.js 18+. GPL 2.0.
Setup effort
Follow the published steps
USE CASES
01
Publishing a post without opening wp-admin
Draft the content in the conversation, create the post, and attach the image you uploaded in the same session.
02
Fixing a page's layout through Elementor
Read the element tree, find the element by type or content, and update its settings in place.
03
Answering a shop question
Pull the sales report and low-stock alerts, then update an order's status if it needs it.
04
Reviewing what the agent actually did
Open the audit log filtered by tool or outcome to see every call, who made it and whether it was denied.
178 tools
Listed in project code.
wsp_create_post
Creates a new blog post.
wsp_update_post
Updates an existing post by ID.
wsp_delete_post
Moves a post to trash by ID.
wsp_get_pages
Returns published pages.
wsp_create_page
Creates a new page (optionally Elementor-initialized).
wsp_update_page
Updates an existing page by ID.
wsp_delete_page
Moves a page to trash by ID.
wsp_get_categories
Returns all categories.
wsp_create_category
Creates a new category.
wsp_get_tags
Returns all tags.
wsp_create_tag
Creates a new tag.
wsp_get_comments
Returns comments.
wsp_approve_comment
Approves a pending comment by ID.
wsp_delete_comment
Trashes a comment by ID.
wsp_list_media
Browse and search the WordPress media library by type, keyword, or date.
wsp_get_media
Retrieve the full metadata of a specific media file by ID.
wsp_count_media
Get media library counts grouped by MIME type, plus a total.
wsp_update_media
Update the title, alt text, caption, or description of a media file by ID.
wsp_delete_media
Permanently delete a media file from the WordPress media library by ID.
wsp_upload_media
Upload an image into the WordPress media library. Provide EITHER "data" (base64-encoded file content — use this to upload a file attached to the chat directly, no public URL required) OR "url" (a public link to fetch). Supported types: jpg, png, gif, webp.
wsp_upload_media_from_url
Pull an image from any web link straight into your media library.
wsp_set_featured_image
Set an image as the featured image (thumbnail) for a post or page.
wsp_get_users
Lists registered users.
wsp_search
Search posts and pages by keyword.
wsp_get_site_info
Returns site name, URL, tagline, WP version, and language.
wsp_get_plugins
Lists active plugins with name, version, and author.
wsp_yoast_get_seo
Get Yoast SEO title, meta description, and focus keyphrase for a post or page.
wsp_yoast_update_seo
Update Yoast SEO title, meta description, and/or focus keyphrase for a post or page.
wsp_rankmath_get_seo
Get Rank Math SEO title, meta description, focus keyword, and SEO score for a post or page.
wsp_rankmath_update_seo
Update Rank Math SEO title, meta description, and/or focus keyword for a post or page. Focus keyword accepts multiple comma-separated keywords (first one is the primary). Pass an empty string to clear a field back to the global template.
wsp_woo_get_products
List products with filtering and pagination.
wsp_woo_get_product
Get single product details by ID.
wsp_woo_create_product
Create a new simple or variable product in the store.
wsp_woo_create_variation
Creates a variation for an existing variable product.
wsp_woo_update_product
Update an existing product details.
wsp_woo_list_orders
List recent orders with status filtering.
wsp_woo_update_order_status
Update the status of an order.
wsp_woo_refund_order
Create a full or partial refund for an order.
wsp_woo_create_coupon
Create a new coupon code (percentage or fixed discount).
wsp_woo_list_coupons
List all active store coupons with usage stats.
wsp_woo_create_order_note
Add a note to an existing order (internal or customer-facing).
wsp_woo_list_customers
List registered customers with billing details.
wsp_woo_report_sales
Get sales, orders, net revenue, and average order value reports.
wsp_woo_get_low_stock
Inspect and list products running low on stock.
wsp_woo_moderate_review
Approve, spam, trash, or reply to product reviews.
wsp_elementor_list_pages
Lists pages/posts built with Elementor.
wsp_elementor_get_page
Get the element tree of an Elementor page by post ID.
wsp_elementor_get_element
Get all settings for a specific element by post ID and element ID.
wsp_elementor_find_element
Find elements on a page by widget type or settings content.
wsp_elementor_list_templates
List Elementor saved templates from the library.
wsp_elementor_update_element
Update settings for a widget or container by element ID.
wsp_elementor_add_widget
Add a widget to a container or column on an Elementor page.
wsp_elementor_add_container
Add a layout container or section to an Elementor page.
wsp_elementor_remove_element
Remove a widget or container from an Elementor page by element ID.
wsp_elementor_get_active_kit
Retrieve global fonts, color palette, and layout from the active Elementor kit.
wsp_elementor_update_active_kit
Update colors and layout settings in the active Elementor kit.
wsp_elementor_regenerate_css
Clear and regenerate all Elementor CSS cache files.
wsp_elementor_get_widget_schema
Get control schema for a widget type — margins, padding, background, typography, etc.
wsp_elementor_duplicate_element
Clone a widget or container with new unique IDs recursively.
wsp_elementor_move_element
Reposition an element to a different parent or index position.
wsp_elementor_convert_css
Parse CSS rules into Elementor-compatible settings structure.
wsp_elementor_get_page_settings
Read global page config like template, background, and custom CSS.
wsp_elementor_update_page_settings
Update page template (canvas/full-width) and page-level settings.
wsp_elementor_copy_styles
Copy style settings from a source element to a destination element.
wsp_elementor_get_breakpoints
Read responsive breakpoint values from Elementor configuration.
wsp_acf_list_field_groups
List all registered custom field groups.
wsp_acf_get_field_group
Retrieve configuration parameters of a specific field group by key.
wsp_acf_create_field_group
Create a brand new custom field group configuration.
wsp_acf_update_field_group
Update location rules or active parameters of a field group.
wsp_acf_delete_field_group
Permanently delete or trash a field group by its key.
wsp_acf_import_field_groups
Import field groups config structure programmatically from JSON parameters.
wsp_acf_list_fields
List all custom fields declared inside a specific field group.
wsp_acf_get_field
Get full configurations and rules of a single field key.
wsp_acf_create_field
Inject a new custom field config inside an existing group configuration.
wsp_acf_update_field_config
Modify attribute settings for a single field configuration parameters.
wsp_acf_delete_field
Delete config mapping of a field configuration.
wsp_acf_duplicate_field
Duplicate an existing field config mapping.
wsp_acf_sync_fields
Sync database structures with local filesystem JSON config records.
wsp_acf_get_value_deep
Deep read custom field values with dot-notation pathing support (e.g. key.0.subkey).
wsp_acf_update_value_deep
Deep write custom field values supporting array indices with dot-notation (e.g. repeater.0.key).
wsp_acf_delete_value
Delete specific key field metadata value.
wsp_acf_get_all_values
Get all raw field values mapped on any object.
wsp_acf_bulk_update_values
Bulk update array values instantly.
wsp_acf_get_field_object
Return both config parameter object and loaded values.
wsp_acf_list_post_types
List registered post types.
wsp_acf_create_post_type
Programmatically register brand new WordPress Post Type.
wsp_acf_list_taxonomies
List taxonomies structure.
wsp_acf_create_taxonomy
Programmatically register brand new WordPress taxonomy.
wsp_acf_list_options_pages
List registered global options views.
wsp_acf_create_options_page
Programmatically register global ACF Options Page.
wsp_acf_get_option_value
Read global option value metadata.
wsp_acf_update_option_value
Write option values globally.
wsp_gravity_list_forms
Lists all Gravity Forms (ID, title, date, active status, entry count).
wsp_gravity_get_form
Retrieves full JSON structure of a form (fields, labels, types, choices, rules).
wsp_gravity_create_form
Creates a new Gravity Form structure with title and optional fields.
wsp_gravity_update_form
Updates form properties, fields, or active status.
wsp_gravity_delete_form
Deletes or trashes a Gravity Form.
wsp_gravity_list_entries
Lists submissions/leads for a specific form (paginated).
wsp_gravity_get_entry
Retrieves complete submission details by entry ID.
wsp_gravity_update_entry
Updates field values or status (read/unread/starred) inside an entry.
wsp_gravity_delete_entry
Trashes or permanently deletes an entry.
wsp_gravity_get_notifications
Gets notification settings (emails, feeds) for a form.
wsp_gravity_get_confirmations
Gets confirmation settings (thank-you messages, redirects) for a form.
wsp_gravity_create_notification
Creates a new email notification for a form (to, subject, message, from, etc.).
wsp_gravity_update_notification
Updates an existing notification (to, subject, message, active status, etc.).
wsp_gravity_delete_notification
Deletes a notification from a form.
wsp_gravity_create_confirmation
Creates a confirmation (thank-you message, redirect, or page) for a form.
wsp_gravity_update_confirmation
Updates an existing confirmation (message, redirect URL, default status, etc.).
wsp_gravity_delete_confirmation
Deletes a confirmation from a form.
wsp_gravity_update_form_settings
Updates form-level settings (label placement, restrictions, scheduling, honeypot, etc.).
wsp_cf7_list_forms
Lists all Contact Form 7 forms with ID, title, and shortcode.
wsp_cf7_get_form
Retrieves full CF7 form structure (markup, mail config, messages, tags).
wsp_cf7_create_form
Creates a new Contact Form 7 form with title and optional markup/properties.
wsp_cf7_update_form
Updates an existing CF7 form markup, mail settings, or messages.
wsp_cf7_delete_form
Trashes or permanently deletes a Contact Form 7 form.
wsp_cf7_list_entries
Lists Flamingo-stored form submissions (requires Flamingo plugin).
wsp_cf7_get_entry
Retrieves full details of a single Flamingo submission by ID.
wsp_cf7_validate_form
Runs the built-in configuration validator to check for email/syntax errors.
wsp_cf7_get_integrations
Lists active integration modules and reCAPTCHA configuration status.
wsp_cf7_moderate_entry
Mark a Flamingo submission as spam, unspam, trash, or untrash.
wsp_wpforms_list_forms
Lists all WPForms with ID, title, date, status, and field count.
wsp_wpforms_get_form
Retrieves full WPForms structure (fields, settings, payments).
wsp_wpforms_describe_schema
Returns supported field types and editable attributes to guide AI on create/update field actions.
wsp_wpforms_get_form_stats
Fetch entry counts and analytics (Pro entry stats).
wsp_wpforms_create_form
Creates a new WPForms form with fields, settings, and notification email.
wsp_wpforms_update_form_settings
Update form settings (title, description, submit text, AJAX, anti-spam).
wsp_wpforms_add_field
Add a new field to an existing form with auto-assigned ID.
wsp_wpforms_update_field
Update a field label, description, required status, or choices.
wsp_wpforms_delete_form
Trashes or permanently deletes a WPForms form.
wsp_wpforms_list_entries
Lists submission entries for a form (requires WPForms Pro).
wsp_wpforms_get_entry
Retrieves full details and field values of a single entry.
wsp_wpforms_delete_entry
Trashes or permanently deletes a submission entry (Pro).
wsp_uae_widgets_activate
UAE Tool: widgets activate
wsp_uae_widgets_deactivate
UAE Tool: widgets deactivate
wsp_uae_widgets_list
UAE Tool: widgets list
wsp_uae_widgets_bulk_toggle
UAE Tool: widgets bulk toggle
wsp_uae_widgets_deactivate_unused
UAE Tool: widgets deactivate unused
wsp_uae_widgets_get_usage
UAE Tool: widgets get usage
wsp_uae_templates_list
UAE Tool: templates list
wsp_uae_templates_create
UAE Tool: templates create
wsp_uae_templates_delete
UAE Tool: templates delete
wsp_uae_templates_duplicate
UAE Tool: templates duplicate
wsp_uae_active_get
UAE Tool: active get
wsp_uae_templates_get
UAE Tool: templates get
wsp_uae_templates_update
UAE Tool: templates update
wsp_uae_templates_restore
UAE Tool: templates restore
wsp_uae_shortcode_render
UAE Tool: shortcode render
wsp_uae_pages_list
UAE Tool: pages list
wsp_uae_pages_create
UAE Tool: pages create
wsp_uae_pages_delete
UAE Tool: pages delete
wsp_uae_pages_restore
UAE Tool: pages restore
wsp_uae_pages_update_meta
UAE Tool: pages update meta
wsp_uae_pages_update_status
UAE Tool: pages update status
wsp_uae_builder_get_structure
UAE Tool: builder get structure
wsp_uae_builder_add_section
UAE Tool: builder add section
wsp_uae_builder_insert_widget
UAE Tool: builder insert widget
wsp_uae_builder_update_widget
UAE Tool: builder update widget
wsp_uae_builder_remove_element
UAE Tool: builder remove element
wsp_uae_builder_move_element
UAE Tool: builder move element
wsp_uae_builder_add_column
UAE Tool: builder add column
wsp_uae_builder_build
UAE Tool: builder build
wsp_uae_builder_regenerate_css
UAE Tool: builder regenerate css
wsp_uae_maintenance_clear_cache
UAE Tool: maintenance clear cache
wsp_uae_builder_undo
UAE Tool: builder undo
wsp_uae_builder_get_schema
UAE Tool: builder get schema
wsp_uae_builder_list_widget_types
UAE Tool: builder list widget types
wsp_uae_settings_get
UAE Tool: settings get
wsp_uae_settings_update
UAE Tool: settings update
wsp_uae_info_get
UAE Tool: info get
wsp_uae_pro_features
UAE Tool: pro features
wsp_uae_extensions_list
UAE Tool: extensions list
wsp_uae_extensions_toggle
UAE Tool: extensions toggle
wsp_uae_theme_get_info
UAE Tool: theme get info
wsp_uae_theme_set_method
UAE Tool: theme set method
wsp_uae_design_system_get_tokens
UAE Tool: design system get tokens
wsp_uae_display_rules_get_locations
UAE Tool: display rules get locations
wsp_uae_display_rules_update
UAE Tool: display rules update
BEFORE YOU INSTALL
What to know first
Tools you get
178 tools registered in the project's code. The plugin registers 178 tools in its source, but each suite beyond core WordPress and media (Yoast SEO, Rank Math, Elementor, WooCommerce, ACF, Ultimate Addons for Elementor, Gravity Forms, WPForms, Contact Form 7) registers only when its host plugin is active, and most abilities are off until enabled in MCP > Settings, so a fresh install exposes a small fraction of them.
INSTALLATION
Connect your client
Server setup
Prerequisites: WordPress 6.9+ (7.0.3 or 6.9.6+ recommended), PHP 7.4+. Claude Desktop and OpenClaw additionally need Node.js 18+ for the mcp-remote bridge; Cursor, Codex and Antigravity connect natively.
Install & activate this plugin on your WordPress site (plugin folder slug is wsp-mcp-ai-agents-connector as of v2.3.0)
Go to MCP > Settings in wp-admin and enable the abilities you need (most are OFF by default)
Go to MCP > Connection and pick your client tab (Claude Desktop, Cursor, Codex, Antigravity, OpenClaw, or OpenCode)
Copy the generated snippet — the endpoint URL (/wp-json/wsp-mcp/v1/mcp on your own site) and API key are already filled in — and paste it into your client's config
Reconnect / restart the client
Review agent activity under MCP > Audit Log
