Post Search is a WordPress ability from The Plus Addons for Elementor — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.

Install Free Plugin →

Post Search

Write

Adds the The Plus "Post Search" widget (tp-post-search) to an Elementor container.

Requires the The Plus Addons for Elementor plugin (which registers under the 'tpae' ability category) on WordPress 6.9+, with Elementor active. Every ability requires the current user to have the 'edit_posts' capability (and 'edit_post' for the specific post being modified); abilities that create or edit content also verify Elementor and, where relevant, the target The Plus widget are available. A subset of abilities (theme templates, template conditions, dynamic tags, popups, and some custom-code abilities) only register when Elementor Pro is active, and many widget abilities load only in the free plugin when the Pro add-on is inactive.

What it does

The execute_callback tpae_mcp_add_theplus_post_search_ability requires Elementor to be active and the tp-post-search widget to be registered, then loads the target post's Elementor page data. It builds a new widget element of type tp-post-search with a form style, search input placeholder text, button label, and icon alignment within the button, plus any raw settings supplied, then inserts it into the specified parent container at the given position and saves the page data. It validates that post_id and parent_id are provided, that the post exists, and that the parent container is found before saving.

See it in action

You ask your AI assistant

"Add a search box widget to the sidebar with the placeholder text "Search articles..."."

Inputs

Name Type Required Description
post_id integer Yes Elementor page/post ID
parent_id string Yes Target Elementor container ID
position integer No Insert position. Use -1 to append.
form_style string No Search form style (enum: style-1, style-2)
search_field_placeholder string No Search input placeholder text
button_text string No Search button label
icon_align string No Icon position in button (enum: left, right)
settings object No Raw Elementor/The Plus control settings to merge into the widget at creation time. Use control keys from sprout/get-theplus-widget-schema.

Returns

Returns element_id (string), widget_type (string), and post_id (integer) of the created widget.

Permission

tpae_mcp_add_theplus_post_search_permission requires the current user to have the edit_posts capability, and if a post_id is supplied and greater than 0, also requires edit_post capability for that specific post.

Newsletter

The AI + WordPress space moves fast. Keep up.

New tools, workflow ideas, and product updates — be the first to know what's next.

No spam, unsubscribe anytime.