List WordPress Posts
wp_list_postsList blog posts from arsnovasingers.org with filters for status, author, categories, tags, and search, plus pagination and sorting controls.
Instructions
List blog posts on arsnovasingers.org with filtering, pagination, and sorting.
Returns a paginated list of posts (default 20 per page). Posts are returned newest-first by default. Use status='any' to include drafts/pending/private (requires edit_posts capability).
Args:
limit (number): Page size, 1-100. Default 20.
offset (number): Pagination offset. Default 0.
status (enum): publish | future | draft | pending | private | trash | any. Default 'publish'.
search (string): Optional keyword to search title + content.
author (number): Optional author ID filter.
categories (number[]): Optional list of category IDs to filter to.
tags (number[]): Optional list of tag IDs to filter to.
orderby (enum): date | modified | id | title | slug | author | relevance. Default 'date'.
order (enum): asc | desc. Default 'desc'.
response_format (enum): markdown | json. Default 'markdown'.
Returns: Paginated envelope with shape: { "total": number, // Total matching posts on the server "count": number, // Posts in this response "offset": number, // Pagination offset "items": [WPContentItem], // Trimmed post shape (id, title, slug, status, link, excerpt, content_preview, author_id, etc.) "has_more": boolean, "next_offset": number // Present if has_more }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Filter to posts in any of these tag IDs. | |
| limit | No | Maximum results to return (1-100). Default 20. | |
| order | No | Sort direction. | desc |
| author | No | Filter to posts by this author ID. | |
| offset | No | Number of results to skip for pagination. Default 0. | |
| search | No | Search term to match against title and content. | |
| status | No | Filter by status. 'any' returns all statuses (requires edit_posts capability). | publish |
| orderby | No | Field to sort by. | date |
| categories | No | Filter to posts in any of these category IDs. | |
| response_format | No | Output format: 'markdown' for human-readable, 'json' for machine-readable. | markdown |