royal-mcp__wp_get_posts
Get WordPress posts (supports custom post types). Each item includes date (publish date, site local time), modified (last change, ISO 8601 UTC) and content_length (bytes of stored post_content) so you can size-check before fetching — on page-builder sites a short page can still carry a very large body. Sort with orderby / order; use modified_after to find posts edited recently. Content edits, Royal MCP custom-field tools, ACF field writes (acf_update_field) and Elementor writes update modified; other plugins changing only custom fields may leave it unchanged. (site: demo.royalplugins.com) Through Royally: read-only, runs straight away.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "royal-mcp__wp_get_posts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order | No | asc or desc. Default: asc (A to Z) for orderby title, desc for every other sort. | |
| search | No | Search term | |
| status | No | Post status (publish, draft, etc) | |
| include | No | Up to 100 post IDs. Returns exactly those posts (any status you can read, trashed posts included) in this order; per_page, search, orderby, order and modified_after are ignored (invalid values are still refused). | |
| orderby | No | Sort field (default date, the publish date). modified sorts by the last change. | |
| site_id | No | Site to run this tool on: 8ef2e52b-bd07-4671-a363-ebe8b480b65c (https://demo.royalplugins.com) | |
| per_page | No | Number of posts (max 100) | |
| post_type | No | Post type slug (default: post). Use wp_get_post_types to discover available types | |
| with_content | No | When true, each item adds content_text (content with shortcodes and tags removed, whitespace collapsed, at most 3000 characters) and content_truncated. | |
| modified_after | No | Only items last modified after this moment: a date (2026-11-01) or date and time (2026-11-01T09:30:00Z). No timezone means UTC. |