WordPress Headless

Local install

io.github.aj-ua/wp-headless-mcpv1.0.0 GitHub verified

Read WordPress content, ACF fields, and Yoast SEO data, and safely edit drafts.

News & Media Marketing & SEO

Watch Source Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-09T11:09:41.921245Z",
      "publishedAt": "2026-11-09T11:09:41.921245Z",
      "statusChangedAt": "2026-11-09T11:09:41.921245Z"
    }
  },
  "server": {
    "name": "io.github.aj-ua/wp-headless-mcp",
    "title": "WordPress Headless",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "1.0.0",
    "packages": [
      {
        "version": "1.0.0",
        "transport": {
          "type": "stdio"
        },
        "identifier": "wp-headless-mcp",
        "runtimeHint": "npx",
        "registryType": "npm",
        "environmentVariables": [
          {
            "name": "WP_URL",
            "format": "string",
            "isRequired": true,
            "description": "Base URL of the WordPress site, without a trailing slash"
          },
          {
            "name": "MCP_PROFILE",
            "format": "string",
            "choices": [
              "public",
              "editor",
              "dev"
            ],
            "default": "public",
            "description": "Tool profile: public (read published content), editor (adds draft-only editing), or dev (adds developer tools)"
          },
          {
            "name": "WP_USER",
            "format": "string",
            "description": "WordPress user for the Application Password (editor and dev profiles)"
          },
          {
            "name": "WP_APP_PASSWORD",
            "format": "string",
            "isSecret": true,
            "description": "WordPress Application Password (editor and dev profiles)"
          },
          {
            "name": "WP_CACHE_TTL",
            "format": "number",
            "default": "60",
            "description": "Seconds to cache GET requests; 0 turns caching off"
          },
          {
            "name": "ACF_JSON_PATH",
            "format": "filepath",
            "description": "Absolute path to the theme's acf-json folder, for ACF labels, schemas, and TypeScript types"
          },
          {
            "name": "MCP_CPTS",
            "format": "string",
            "default": "auto",
            "description": "Custom post type tools: auto, none, or a JSON array of {postType, singular, plural}"
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/aj-ua/wp-headless-mcp",
      "source": "github"
    },
    "websiteUrl": "https://github.com/aj-ua/wp-headless-mcp#readme",
    "description": "Read WordPress content, ACF fields, and Yoast SEO data, and safely edit drafts."
  }
}

Maintain this server? Claim it

Try it

This server only runs locally, from a package. Install it with the instructions on this page to try it.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM StudioThen replace the YOUR_ values and {placeholders} with your own.

Run in a terminal

claude mcp add wp-headless-mcp \
  -e WP_URL=YOUR_WP_URL \
  -- npx -y [email protected]

Environment

WP_URL (required): Base URL of the WordPress site, without a trailing slash
MCP_PROFILE (optional, not in the config above): Tool profile: public (read published content), editor (adds draft-only editing), or dev (adds developer tools)
WP_USER (optional, not in the config above): WordPress user for the Application Password (editor and dev profiles)
WP_APP_PASSWORD (optional, not in the config above): WordPress Application Password (editor and dev profiles)
WP_CACHE_TTL (optional, not in the config above): Seconds to cache GET requests; 0 turns caching off
ACF_JSON_PATH (optional, not in the config above): Absolute path to the theme's acf-json folder, for ACF labels, schemas, and TypeScript types
MCP_CPTS (optional, not in the config above): Custom post type tools: auto, none, or a JSON array of {postType, singular, plural}

Tools

We don't run packages, so we can't list this server's tools.