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 toolsPublic 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 monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
WP_URL*Base URL of the WordPress site, without a trailing slash
MCP_PROFILEdefault: publicTool profile: public (read published content), editor (adds draft-only editing), or dev (adds developer tools)
WP_USERWordPress user for the Application Password (editor and dev profiles)
WP_APP_PASSWORDsecretWordPress Application Password (editor and dev profiles)
WP_CACHE_TTLdefault: 60Seconds to cache GET requests; 0 turns caching off
ACF_JSON_PATHAbsolute path to the theme's acf-json folder, for ACF labels, schemas, and TypeScript types
MCP_CPTSdefault: autoCustom 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
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
