mcp-easy-ai__wp_list_comments
Lists WordPress comments. Optional: post_id (filter by post — omit for all posts) or post_ids (several posts), post_exclude, status (approve/hold/spam/trash/all/any/post-trashed — default "approve" for published comments; use "hold" to list the pending moderation queue; "all" is approved plus pending, "any" is every status) or statuses (several), type (default "comment"; "all" lists every type except block editor notes, as the Comments screen does; also pingback, trackback, pings, note or a custom type), search, author (filter to a registered author user ID), author_exclude (array of author user IDs to exclude), author_email, author_url, include / exclude (comment IDs), parent / parent_exclude (parent comment IDs; [0] = top-level only), after/before (ISO 8601 date-time bounds), post_type, post_status, post_author, post_parent, post_name (filters on the comment's post), karma, meta_key with optional meta_value and meta_compare (protected meta keys, those sta… Through Royally: its server marks it read-only, so it runs straight away.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| type | No | Comment type. Default "comment" (WordPress's REST default). "all" lists every type except block editor notes, which is what the Comments screen shows; "pings" is pingbacks and trackbacks; "note" lists block editor notes; any other value is matched as a custom comment type. | |
| after | No | Only comments posted on or after this ISO 8601 date-time (e.g. "2026-01-01T00:00:00"). | |
| karma | No | Only comments with exactly this karma value. | |
| order | No | Sort direction. Default "desc". | |
| author | No | Filter to comments by this registered (logged-in) author user ID. | |
| before | No | Only comments posted on or before this ISO 8601 date-time (e.g. "2026-12-31T23:59:59"). | |
| offset | No | Skip this many matching comments before the first one returned. When greater than 0 it overrides page. | |
| parent | No | Only replies to these parent comment IDs; [0] lists top-level comments only. | |
| search | No | Search query to filter comments. | |
| status | No | Filter comments by status. "all" is approved plus pending; "any" is every status, spam, trash and post-trashed included; "post-trashed" is a comment whose post is in the Trash. | |
| exclude | No | Exclude these comment IDs. | |
| include | No | Only these comment IDs. | |
| orderby | No | Sort by this attribute. Default "date_gmt". "include" keeps the order of the include list. | |
| post_id | No | Filter comments by post ID. | |
| site_id | No | Site to run this tool on: 8ef2e52b-bd07-4671-a363-ebe8b480b65c (https://demo.royalplugins.com) | |
| meta_key | No | Only comments that have this comment meta key. A protected key (starting with an underscore) needs the manage_options capability. | |
| per_page | No | Number of comments per page (1-100). | |
| post_ids | No | Filter to comments on any of these post IDs (0 = comments attached to no post). Use instead of post_id, not together with it. | |
| statuses | No | Filter to comments in any of these statuses (same values as status). Use instead of status, not together with it. | |
| post_name | No | Only comments on the post with this slug. | |
| post_type | No | Only comments on posts of this post type, or a comma-separated list of post types. | |
| author_url | No | Only comments whose author URL is exactly this value. | |
| meta_value | No | With meta_key: only comments whose value for that key matches (see meta_compare). Requires meta_key. | |
| post_author | No | Only comments on posts written by this user ID. | |
| post_parent | No | Only comments on child posts of this post ID. | |
| post_status | No | Only comments on posts with this post status, or a comma-separated list of statuses. | |
| author_email | No | Only comments whose author email is exactly this address. | |
| meta_compare | No | With meta_key: how meta_value is compared. Default "=". IN, NOT IN, BETWEEN and NOT BETWEEN take a comma-separated meta_value. | |
| post_exclude | No | Exclude comments on these post IDs. | |
| author_exclude | No | Array of author user IDs to EXCLUDE from results. | |
| parent_exclude | No | Exclude replies to these parent comment IDs; [0] excludes top-level comments. | |
| include_details | No | Also return, for each comment: author (user ID, 0 for a guest), author_url, author_ip, author_user_agent, date_gmt, type, karma, comment_approved (raw stored value), content_raw (unrendered content) and link. |