wp_search_posts is one of 162 MCP tools included in Easy MCP AI — the WordPress plugin that connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →wp_search_posts
Read-onlyDescription
Searching posts across every status — drafts, published, and archived — gives your AI a complete picture of what's already been written on any topic, not just what's live on the site. Easy MCP AI passes the query directly from your AI client to WordPress with no intermediary proxy, so results are fast and scoped precisely to posts. Use it before writing new content to catch duplication, or to surface all posts referencing an old URL or product name that need updating.
See it in action
wp_search_posts {
"total": 3,
"results": [
{ "post_id": 55, "title": "Membership Pricing Guide", "type": "post" },
{ "post_id": 23, "title": "Pricing FAQ", "type": "page" },
{ "post_id": 19, "title": "Compare Plans", "type": "page" }
]
} Found 3 posts matching 'membership pricing' across your site.
Example Use Cases & Sample Prompts
- Finding a specific article
- Prompt: “Search for posts mentioning ‘WooCommerce checkout’ so I can find the one we wrote last month.”
- Content duplication check
- Prompt: “Search for any posts that mention ‘free shipping’ — I want to see if the topic has been covered before writing a new post.”
- Locating posts for an update
- Prompt: “Find posts containing the word ‘Instagram’ — I need to update them since we’ve changed our social strategy.”
- Identifying broken references
- Prompt: “Search for any posts mentioning our old website URL so we can update them to the new domain.”
- Topic research
- Prompt: “Search for all posts on ‘email marketing’ and give me a summary of what angles have already been covered.”
Frequently Asked Questions
What does wp_search_posts do?
Searching posts across every status — drafts, published, and archived — gives your AI a complete picture of what's already been written on any topic, not just what's live on the site. Easy MCP AI passes the query directly from your AI client to WordPress with no intermediary proxy, so results are fast and scoped precisely to posts. Use it before writing new content to catch duplication, or to surface all posts referencing an old URL or product name that need updating.
How do I use wp_search_posts with my AI assistant?
Install the Easy MCP AI WordPress plugin, generate an API token in your dashboard, and connect your AI client (Claude, ChatGPT, Cursor, or any MCP-compatible assistant). Then simply describe what you want in natural language — for example: "Search for all posts that mention 'WooCommerce' and List them with their status."
Do I need Easy MCP AI to use wp_search_posts?
Yes. wp_search_posts is one of 162 MCP tools bundled inside the Easy MCP AI WordPress plugin. Install the free plugin from WordPress.org, connect your AI client, and this tool becomes available immediately — no coding required.
Related Tools
PostsHave your AI write, categorize, tag, and publish a new blog post — all in one step
Trash or permanently delete a specific post by ID
Fetch the full content and metadata of a specific post by ID
Ask your AI to browse posts by status, category, tag, author, or keyword with pagination
Update a post's title, content, status, categories, tags, or featured image by ID
Search across all WordPress content types with type and subtype filtering
Step 1
Get the Plugin
Install Easy MCP AI on your WordPress site to unlock wp_search_posts and all 74 tools instantly.
Step 2
Connect Your AI Client
Already have the plugin? Step-by-step setup guides for Claude, ChatGPT, Cursor, Windsurf, and 10+ more.