Comment Toolswordpress_list_comments

wordpress_list_comments

List WordPress comments with optional filters (status, post ID, pagination).

wordpress_list_comments

List all comments with optional filtering.

Parameters

4 parameters, none required.

NameTypeRequiredWhat it is
statusstringnoComment status (approve, hold, spam, trash)
post_idnumbernoFilter by post ID
pagenumbernoPage number
per_pagenumbernoItems per page

Example call

No parameter is required, so the smallest valid call is empty:

{
  "name": "wordpress_list_comments",
  "arguments": {}
}

Response

{
  "success": true,
  "comments": [
    {
      "id": 9001,
      "post_id": 101,
      "author": "Jane",
      "status": "approve",
      "content": "Great post!"
    }
  ]
}

What it changes

Nothing. It only reads, so there is nothing to approve and nothing to undo.

How long it takes

A typical call takes about 1.9 seconds. 19 in 20 finish within 2.8 seconds. Measured on real sites over the last week, so it includes the site's own hosting.

Availability

Works on any WordPress site, whichever page builder it uses. Available since Respira 1.0.0.

Example Prompts

  • "List approved comments"
  • "Show comments waiting for moderation"
  • "List comments on post 101"