list-categories

list-categories

Retrieve and filter WordPress site categories by ID, parent, slug, or search term. Manage pagination, sorting, and visibility options programmatically for efficient category management.

Instructions

Get a list of categories with filtering options

Input Schema

Name	Required	Description	Default
`context`	No	Scope under which the request is made	view
`exclude`	No	Ensure result set excludes specific IDs
`hideEmpty`	No	Whether to hide terms not assigned to any posts
`include`	No	Limit result set to specific IDs
`order`	No	Order sort attribute ascending or descending	asc
`orderby`	No	Sort collection by term attribute	name
`page`	No	Current page of the collection
`parent`	No	Limit result set to terms assigned to a specific parent
`password`	Yes	WordPress application password
`perPage`	No	Maximum number of items to be returned
`post`	No	Limit result set to terms assigned to a specific post
`search`	No	Limit results to those matching a string
`siteUrl`	Yes	WordPress site URL
`slug`	No	Limit result set to terms with one or more specific slugs
`username`	Yes	WordPress username

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "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"
    },
    "hideEmpty": {
      "description": "Whether to hide terms not assigned to any posts",
      "type": "boolean"
    },
    "include": {
      "description": "Limit result set to specific IDs",
      "items": {
        "type": "number"
      },
      "type": "array"
    },
    "order": {
      "default": "asc",
      "description": "Order sort attribute ascending or descending",
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    },
    "orderby": {
      "default": "name",
      "description": "Sort collection by term attribute",
      "enum": [
        "id",
        "include",
        "name",
        "slug",
        "include_slugs",
        "term_group",
        "description",
        "count"
      ],
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Current page of the collection",
      "minimum": 1,
      "type": "number"
    },
    "parent": {
      "description": "Limit result set to terms assigned to a specific parent",
      "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"
    },
    "post": {
      "description": "Limit result set to terms assigned to a specific post",
      "type": "number"
    },
    "search": {
      "description": "Limit results to those matching a string",
      "type": "string"
    },
    "siteUrl": {
      "description": "WordPress site URL",
      "format": "uri",
      "type": "string"
    },
    "slug": {
      "description": "Limit result set to terms with one or more specific slugs",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "username": {
      "description": "WordPress username",
      "type": "string"
    }
  },
  "required": [
    "siteUrl",
    "username",
    "password"
  ],
  "type": "object"
}

WordPress MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from WordPress MCP Server

Related Tools