Claude MarketplacesSubmit

WordPress Headless

aj-ua/wp-headless-mcp

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

tools: 22
auth: Secret needed
transport: STDIO
env vars: 7
last updated: Nov 9, 2026

Tools

22 tools

Public tool metadata for what this MCP can expose to an agent.

list_post_typesContent types with published counts and taxonomies

Content types with published counts and taxonomies

No parameter schema in public metadata yet.

search_contentKeyword search; results from WordPress search plus acf_matches from ACF fields

Keyword search; results from WordPress search plus acf_matches from ACF fields

No parameter schema in public metadata yet.

list_postsList any post type; body as Markdown, ACF fields, featured image, terms

List any post type; body as Markdown, ACF fields, featured image, terms

No parameter schema in public metadata yet.

get_postRead any post type; body as Markdown, ACF fields, featured image, terms

Read any post type; body as Markdown, ACF fields, featured image, terms

No parameter schema in public metadata yet.

list_termsCategories, tags, and custom taxonomy terms

Categories, tags, and custom taxonomy terms

No parameter schema in public metadata yet.

get_acf_fieldsOne item's ACF values with labels, types, and field groups

One item's ACF values with labels, types, and field groups

No parameter schema in public metadata yet.

get_company_infoSite, organization, social profiles, and home page text

Site, organization, social profiles, and home page text

No parameter schema in public metadata yet.

get_seo_metaYoast SEO data and issues for one item or URL (Yoast only)

Yoast SEO data and issues for one item or URL (Yoast only)

No parameter schema in public metadata yet.

find_seo_issuesSite-wide SEO scan with counts per issue (Yoast only)

Site-wide SEO scan with counts per issue (Yoast only)

No parameter schema in public metadata yet.

create_draftNew draft, optionally copied from an existing item (copy_from)

New draft, optionally copied from an existing item (copy_from)

No parameter schema in public metadata yet.

update_postChange a draft or pending item; can submit it for review

Change a draft or pending item; can submit it for review

No parameter schema in public metadata yet.

update_acf_fieldsSet ACF values on a draft or pending item, checked against its field groups

Set ACF values on a draft or pending item, checked against its field groups

No parameter schema in public metadata yet.

list_draftsDrafts and pending items with edit links

Drafts and pending items with edit links

No parameter schema in public metadata yet.

upload_mediaAdd an image or PDF from a public URL, with alt text

Add an image or PDF from a public URL, with alt text

No parameter schema in public metadata yet.

content_auditMissing images, alt text, descriptions, excerpts, and stale content

Missing images, alt text, descriptions, excerpts, and stale content

No parameter schema in public metadata yet.

get_menuNavigation menus as a tree (Administrators only)

Navigation menus as a tree (Administrators only)

No parameter schema in public metadata yet.

describe_content_modelPost types, REST routes, taxonomy fields, and ACF groups per type

Post types, REST routes, taxonomy fields, and ACF groups per type

No parameter schema in public metadata yet.

get_acf_schemaFull ACF field definitions

Full ACF field definitions

No parameter schema in public metadata yet.

sample_payloadRaw REST JSON for a content route

Raw REST JSON for a content route

No parameter schema in public metadata yet.

generate_ts_typesTypeScript interfaces for a post type, in standard or light ACF format

TypeScript interfaces for a post type, in standard or light ACF format

No parameter schema in public metadata yet.

check_site_requirementsChecks the site requirements above

Checks the site requirements above

No parameter schema in public metadata yet.

site_healthWordPress version, namespaces, plugins, HTTPS, timezone, and CORS for a PWA origin

WordPress version, namespaces, plugins, HTTPS, timezone, and CORS for a PWA origin

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Configuration

WP_URL*

Base URL of the WordPress site, without a trailing slash

MCP_PROFILEdefault: public

Tool profile: public (read published content), editor (adds draft-only editing), or dev (adds developer tools)

WP_USER

WordPress user for the Application Password (editor and dev profiles)

WP_APP_PASSWORDsecret

WordPress Application Password (editor and dev profiles)

WP_CACHE_TTLdefault: 60

Seconds to cache GET requests; 0 turns caching off

ACF_JSON_PATH

Absolute path to the theme's acf-json folder, for ACF labels, schemas, and TypeScript types

MCP_CPTSdefault: auto

Custom post type tools: auto, none, or a JSON array of {postType, singular, plural}

Readme

wp-headless-mcp

An MCP server that lets AI assistants read, and safely help edit, the content of a WordPress website.

It connects a company's WordPress site (pages, posts, custom post types like projects or services, ACF fields, and Yoast SEO data) to AI clients such as Claude. Then people can ask questions about the site, or get help with its content, in plain language.

Status: feature-complete for its first version and tested against a real WordPress site, with 120 unit tests.

What is MCP?

The Model Context Protocol is an open standard for connecting AI assistants to data and tools. An MCP server describes what it can do as:

Tools: actions the AI can call, like "search the site" or "list recent projects".
Resources: content the AI can read, like a specific page or the site's content model.
Prompts: reusable task templates, like "review this page's SEO".

Any MCP-compatible client (Claude Desktop, Claude Code, the Claude API, and others) can use the same server without custom integration work.

The problem it solves

View the full README on GitHub

Details

Repository: github.com/aj-ua/wp-headless-mcp
Website: github.com/aj-ua/wp-headless-mcp#readme
Categories: Sales & Marketing, Web & Browser Automation, Data & Analytics
Package: wp-headless-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Sales & Marketing MCP servers

1

AgentFuel402 Consumable Data Factoryak10082247-max/agentfuel402Consumable B2B leads, clean Markdown, e-com pricing, and SDK metadata for AI agents via MCP.0stars

2

Amalgixamalgix-io/amalgixCross-model evidence pipeline for financial filings & contracts. x402 pay-per-call.0stars

3

Web Intelarceedev/web-intel-mcpWeb pages to clean Markdown, metadata, links, tech stack and scored SEO audits. Pay per call.0stars

4

TradeBasis Automotive Appraisal MCPca.tradebasis/automotive-appraisalTradeBasis: Canadian B2B vehicle appraisal SaaS info — product, Lite/Pro pricing, research briefs.0stars

5

Linkrescue Mcpcarsonroell-debug/linkrescue-mcpBroken link detection with affiliate tracking, revenue loss estimation, and fixes0stars

6

Indie Founder Revenue MCPcharlie-morrison/indie-founder-mcpAggregates Lemon Squeezy, Gumroad, Polar, and Stripe revenue into one Claude-queryable view.0stars