Search Real Images is a WordPress ability from Page Builder: Pagelayer – Drag and Drop website builder — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Search Real Images
Read-onlySearch Pexels for real licensed photos by keyword (single or batched) and return direct image URLs for use in pl_image widgets.
Requires the Pagelayer plugin on WordPress 6.9+ (or another source of wp_register_ability()) for the Abilities API — registration is skipped entirely via a function_exists() guard when it isn't available, and ability categories similarly require wp_register_ability_category(). Most abilities require the 'edit_posts' capability; update-global-styles, create-menu, and delete-menu require 'manage_options'. search-images additionally needs a Pexels API key configured on the Pagelayer AI Agents settings page, and get-library-sections/import-library-section call Pagelayer's own hosted library API. Four near-duplicate abilities (get-widget, get-widgets-summary, edit-layout, navigator) are registered in source with mcp_public:false — fully callable over the REST Abilities API but intentionally left out of the advertised MCP tool list as duplicates of get-widget-schema, list-widgets, update-page, and get-page respectively — and are excluded from this listing.
What it does
Queries the Pexels API using a site-configured API key, either for a single query string or for up to 10 queries at once via the queries array (the preferred batched form, returning {batch: {keyword: [results]}}), with optional per_page (max 20) and orientation (landscape/portrait/square) filters. Each result includes the image url, a thumb, alt text, dimensions, and photographer credit. Returns a specific error if no Pexels key is configured on the Pagelayer AI Agents settings page, instructing the caller never to fall back to placeholder or made-up image URLs.
See it in action
You ask your AI assistant
"Find me real photos for a wood-fired pizza oven and a barista pouring a latte."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| queries | array | No | PREFERRED: up to 10 specific keywords in one call. Returns {batch: {keyword: [results]}}. |
| query | string | No | Single search keyword, when only one photo is needed. |
| per_page | integer | No | Results per keyword (max 20; defaults to 3 in batch mode, 5 for a single query). |
| orientation | string | No | landscape, portrait, or square. |
Returns
For a single query: an object with query and results (array of {url, thumb, alt, width, height, photographer}). For queries: an object with batch (map of keyword to its results array or an error). Returns a WP_Error if no/invalid Pexels API key is configured.
Permission
Requires the 'edit_posts' capability.
More Page Builder: Pagelayer – Drag and Drop website builder abilities
Add Element
Insert a new element node into a page at a given parent container and index.
Begin Transaction
Snapshot a page's current layout and content as a backup before a multi-step editing sequence.
Change Element Styles
Batch-apply style property changes to page elements matched by ID, pagelayer-id, or widget tag.
Commit Transaction
Discard a page's transaction backup, finalizing the changes made since begin-transaction.
Create / Update Navigation Menu
Create a WordPress nav menu from a list of items (or rebuild an existing one of the same name), optionally with nested Mega Menu content, and assign it to a theme location.
Create Design UI Sections
Append new section nodes onto an existing page without touching what's already there.