tools

name	tools
description	Browse all 239 mcpwp MCP tools by category — pages, Elementor, WooCommerce, media, SEO, and more. Use to discover available tools before working with a WordPress site.
user-invocable	true

mcpwp Tools Reference

Browse and learn about all 239 mcpwp MCP tools. $ARGUMENTS = category name or tool name.

Categories

Category	Count	Description
site	~37	Site info, menus, options, custom CSS, design references, guides, workflows
content	~28	Pages, posts, drafts, bulk create/update, search, clone, meta
elementor	~12	Get/set Elementor data, edit sections, edit widgets, find-replace
elementor-build	~8	build_page from blueprints, landing pages, clone, globals
elementor-templates	~15	Templates, archetypes, reusable parts
elementor-theme	~10	Theme builder templates, conditions, custom code
elementor-info	~5	Widget schemas, widget help, status, CSS regeneration
media	~7	Upload file/URL/base64, delete, screenshot
taxonomy	~5	Categories, tags, custom taxonomy terms
gutenberg	~4	Blocks content, block types, patterns
admin	~16	API keys, rate limits, settings, updates, integrations, feedback
seo	~10	Meta tags, analysis, bulk SEO, scan, report, noindex, Google indexing
woocommerce	~21	Products, orders, categories, tags, customers, analytics, archetypes
learnpress	~18	Courses, lessons, quizzes, curriculum, categories, stats
webhooks	~7	Create/test/monitor webhook deliveries

Essential Tools (Start Here)

First Connection

• wp_introspect() — Full site briefing: identity, tools, capabilities, recommended actions
• wp_site_info() — Site name, URL, theme, plugins, Elementor status
• wp_get_site_context() — Brand voice, design system, target audience

Content

• wp_list_pages(per_page, status) — List all pages
• wp_create_page(title, content, status) — Create a page
• wp_update_page(id, title, content) — Update a page
• wp_search(query) — Search across all content

Elementor Page Building

• wp_build_page(title, sections[]) — Build entire page from blueprints
• wp_get_elementor(id) — Read full Elementor JSON for a page
• wp_get_elementor_summary(id) — Quick overview: section count, widget types, IDs
• wp_set_elementor(id, elementor_data) — Write full Elementor JSON
• wp_edit_widget(page_id, widget_id, settings) — Change one widget's settings
• wp_edit_section(page_id, element_id, settings) — Change section/container settings
• wp_add_section(id, position, elements) — Insert a new section
• wp_get_widget_schema(widget_type) — Get valid control keys for any widget

Media

• wp_upload_media_from_url(url, title, alt) — Download and upload an image
• wp_upload_media_b64(data, filename, title) — Upload base64 image
• wp_list_media(per_page, search) — Browse media library

Blueprint Types (for wp_build_page)

Each creates a fully styled Elementor section:

Type	What it generates
hero	Full-width hero with heading, subheading, CTA button
features	3-column icon-box grid with cards, shadows, buttons
cta	Call-to-action with dark background, centered text, button
pricing	Price table columns with features lists
faq	Accordion with questions and answers
testimonials	Quote cards with name, title, optional photo
text	Simple text section with heading and paragraph
gallery	Image gallery grid
contact_form	Contact form (requires form plugin)
map	Google Maps embed
countdown	Countdown timer
stats	Number counters with labels
logo_grid	Logo/partner grid
video	Video embed section

API Key Roles

Different roles limit which tool categories are available:

Role	Categories	~Tools	Use case
admin	All	239	Full site management
designer	elementor*, gutenberg, media, site	~82	Page building
author	content, media, taxonomy	~40	Content writing
editor	content, elementor*, media, taxonomy, seo	~99	Content + design
custom	Pick your own	Variable	Specific use cases

Create restricted keys: wp_create_api_key(label, role, tool_categories[])