wp_list_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_list_posts
Read-onlyDescription
Think of this as your AI's content dashboard — filter by status, category, tag, author, or keyword and get back a paginated list without touching the WordPress admin. Easy MCP AI bridges Claude Desktop, ChatGPT, Cursor, or any MCP-compatible AI assistant directly to your site's posts endpoint, so discovering the right post ID before an edit or deletion is a single conversational step. It's a read-only call that pairs naturally with every other post tool in Easy MCP AI's 162-tool library.
See it in action
wp_list_posts {
"total": 5,
"posts": [
{ "post_id": 42, "title": "Productivity Tips", "status": "publish" },
{ "post_id": 38, "title": "Getting Started", "status": "publish" },
{ "post_id": 31, "title": "Our Story", "status": "draft" }
]
} Found 5 published posts matching your query. Here's the list.
Example Use Cases & Sample Prompts
- Finding draft posts
- Prompt: “Show me all my current draft posts so I can decide which ones to publish.”
- Content audit by category
- Prompt: “List all posts in the ‘Tutorials’ category and tell me how many there are.”
- Checking scheduled posts
- Prompt: “What posts do I have scheduled to go live this week?”
- Finding posts to update
- Prompt: “List all posts from more than a year ago that are still published — I want to review if they need refreshing.”
- Browsing by author
- Prompt: “Show me all published posts written by the user ‘editor_jane’ from the last 3 months.”
Frequently Asked Questions
What does wp_list_posts do?
Think of this as your AI's content dashboard — filter by status, category, tag, author, or keyword and get back a paginated list without touching the WordPress admin. Easy MCP AI bridges Claude Desktop, ChatGPT, Cursor, or any MCP-compatible AI assistant directly to your site's posts endpoint, so discovering the right post ID before an edit or deletion is a single conversational step. It's a read-only call that pairs naturally with every other post tool in Easy MCP AI's 162-tool library.
How do I use wp_list_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: "Show me all my current draft posts so I can decide which ones to publish."
Do I need Easy MCP AI to use wp_list_posts?
Yes. wp_list_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
Search posts by keyword or phrase across all statuses
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_list_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.