List SureRank Content Items is a WordPress ability from SureRank — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →List SureRank Content Items
Read-onlySearch and paginate posts, pages, or taxonomy terms to find the IDs needed for other SureRank abilities.
Requires the SureRank plugin on WordPress 6.9+ for the Abilities API. Abilities are only registered when SureRank's admin 'enable_mcp' setting is turned on, and every ability requires the current user to have the 'manage_options' capability.
What it does
This ability runs a WP_Query (for posts) or get_terms() (for taxonomy terms) against a given post type or taxonomy slug, filtered by an optional search string and paginated with page/per_page inputs. It returns each item's ID, title/name, status, and slug. Because most other SureRank abilities operate on a specific post_id or term_id, an AI assistant typically calls this ability first to resolve a human-readable title into the numeric ID it needs. The ability validates that the given post type or taxonomy actually exists before querying.
See it in action
You ask your AI assistant
"Find the post ID for the page titled 'About Us' on the pages post type."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| object_type | string | No | Whether to list post objects or taxonomy terms ('post' or 'term'). Defaults to 'post'. |
| type_name | string | Yes | The post type slug or taxonomy slug to list. |
| search | string | No | Optional search query for titles or term names. |
| page | integer | No | Results page number. Defaults to 1. |
| per_page | integer | No | Results per page, 1-100. Defaults to 20. |
Returns
An object with object_type, type_name, and an items array of {id, label, status, slug} for each matching post or term.
Permission
Requires the 'manage_options' capability; the ability is only registered when SureRank's admin 'enable_mcp' setting is turned on.
More SureRank abilities
Get SureRank Global Settings
Retrieve SureRank's global SEO settings, in full or filtered to specific keys.
Get SureRank Post SEO
Read a specific post's SureRank SEO metadata alongside the global defaults it falls back to.
Get SureRank Post SEO Checks
Run SureRank's SEO checks for one or more posts and return the pass/fail results.
Get SureRank Robots.txt
Read the custom robots.txt content currently managed by SureRank.
Get SureRank Sitemap Settings
Read SureRank's XML sitemap settings, including which post types and taxonomies are excluded.
Get SureRank Term SEO
Read a taxonomy term's SureRank SEO metadata alongside the global defaults it falls back to.