WordPress MCP Server

list-posts

Retrieve and filter WordPress posts by criteria like date, author, status, or keywords to manage content programmatically using REST API.

Instructions

Get a list of posts with comprehensive filtering options

Input Schema

NameRequiredDescriptionDefault
afterNoLimit response to posts published after a given ISO8601 compliant date
authorNoLimit result set to posts assigned to specific authors
authorExcludeNoEnsure result set excludes posts assigned to specific authors
beforeNoLimit response to posts published before a given ISO8601 compliant date
categoriesNoLimit result set to items with specific terms assigned in the categories taxonomy
categoriesExcludeNoLimit result set to items except those with specific terms assigned in the categories taxonomy
contextNoScope under which the request is madeview
excludeNoEnsure result set excludes specific IDs
includeNoLimit result set to specific IDs
modifiedAfterNoLimit response to posts modified after a given ISO8601 compliant date
modifiedBeforeNoLimit response to posts modified before a given ISO8601 compliant date
offsetNoOffset the result set by a specific number of items
orderNoOrder sort attribute ascending or descendingdesc
orderbyNoSort collection by post attributedate
pageNoCurrent page of the collection
passwordYesWordPress application password
perPageNoMaximum number of items to be returned
searchNoLimit results to those matching a string
searchColumnsNoArray of column names to be searched
siteUrlYesWordPress site URL
slugNoLimit result set to posts with one or more specific slugs
statusNoLimit result set to posts assigned one or more statuses
stickyNoLimit result set to items that are sticky
tagsNoLimit result set to items with specific terms assigned in the tags taxonomy
tagsExcludeNoLimit result set to items except those with specific terms assigned in the tags taxonomy
taxRelationNoLimit result set based on relationship between multiple taxonomies
usernameYesWordPress username

Input Schema (JSON Schema)

{ "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "after": { "description": "Limit response to posts published after a given ISO8601 compliant date", "type": "string" }, "author": { "description": "Limit result set to posts assigned to specific authors", "items": { "type": "number" }, "type": "array" }, "authorExclude": { "description": "Ensure result set excludes posts assigned to specific authors", "items": { "type": "number" }, "type": "array" }, "before": { "description": "Limit response to posts published before a given ISO8601 compliant date", "type": "string" }, "categories": { "description": "Limit result set to items with specific terms assigned in the categories taxonomy", "items": { "type": "number" }, "type": "array" }, "categoriesExclude": { "description": "Limit result set to items except those with specific terms assigned in the categories taxonomy", "items": { "type": "number" }, "type": "array" }, "context": { "default": "view", "description": "Scope under which the request is made", "enum": [ "view", "embed", "edit" ], "type": "string" }, "exclude": { "description": "Ensure result set excludes specific IDs", "items": { "type": "number" }, "type": "array" }, "include": { "description": "Limit result set to specific IDs", "items": { "type": "number" }, "type": "array" }, "modifiedAfter": { "description": "Limit response to posts modified after a given ISO8601 compliant date", "type": "string" }, "modifiedBefore": { "description": "Limit response to posts modified before a given ISO8601 compliant date", "type": "string" }, "offset": { "description": "Offset the result set by a specific number of items", "type": "number" }, "order": { "default": "desc", "description": "Order sort attribute ascending or descending", "enum": [ "asc", "desc" ], "type": "string" }, "orderby": { "default": "date", "description": "Sort collection by post attribute", "enum": [ "author", "date", "id", "include", "modified", "parent", "relevance", "slug", "include_slugs", "title" ], "type": "string" }, "page": { "default": 1, "description": "Current page of the collection", "minimum": 1, "type": "number" }, "password": { "description": "WordPress application password", "type": "string" }, "perPage": { "default": 10, "description": "Maximum number of items to be returned", "maximum": 100, "minimum": 1, "type": "number" }, "search": { "description": "Limit results to those matching a string", "type": "string" }, "searchColumns": { "description": "Array of column names to be searched", "items": { "type": "string" }, "type": "array" }, "siteUrl": { "description": "WordPress site URL", "format": "uri", "type": "string" }, "slug": { "description": "Limit result set to posts with one or more specific slugs", "items": { "type": "string" }, "type": "array" }, "status": { "default": [ "publish" ], "description": "Limit result set to posts assigned one or more statuses", "items": { "enum": [ "publish", "future", "draft", "pending", "private" ], "type": "string" }, "type": "array" }, "sticky": { "description": "Limit result set to items that are sticky", "type": "boolean" }, "tags": { "description": "Limit result set to items with specific terms assigned in the tags taxonomy", "items": { "type": "number" }, "type": "array" }, "tagsExclude": { "description": "Limit result set to items except those with specific terms assigned in the tags taxonomy", "items": { "type": "number" }, "type": "array" }, "taxRelation": { "description": "Limit result set based on relationship between multiple taxonomies", "enum": [ "AND", "OR" ], "type": "string" }, "username": { "description": "WordPress username", "type": "string" } }, "required": [ "siteUrl", "username", "password" ], "type": "object" }
ID: 4g84e42ylk