← Back to Tools Reference

wp_list_comments

Read-only

Description

Use this tool to retrieve a list of comments on your site, with filters for post ID, comment status (approved, pending, spam, trash), and author. This is the starting point for moderation tasks — your AI can find comments that need approval and act on them using the update or delete tools.

See it in action

Claude Desktop — MCP Connection
👤
Show me all pending comments waiting for moderation.
🤖
Calling Tool: wp_list_comments
Done! I've used wp_list_comments to complete that for you.
{"status": "success"}

Example Use Cases & Sample Prompts

  1. Moderation queue
    • Prompt: “List all pending comments so I can review and approve them.”
  2. Spam review
    • Prompt: “Show me all comments currently marked as spam — I want to see if any were incorrectly filtered.”
  3. Comment audit for a post
    • Prompt: “List all approved comments on the post ‘WordPress Plugin Guide’ so I can read the feedback.”
  4. Recent comments overview
    • Prompt: “Show me the last 20 comments across the whole site.”
  5. Finding comments to delete
    • Prompt: “List comments from more than 2 years ago that have zero replies — I want to clean up old conversations.”

Access this tool today

Install the Easy MCP AI plugin to securely expose wp_list_comments to Claude, ChatGPT, and more.

Download Plugin