MCP Adapter Implementation Example

A WordPress plugin demonstrating MCP Adapter integration and implementation patterns.

Abilities API MCP Adapter

Purpose

This plugin serves as an implementation example to demonstrate:

• WordPress Abilities API functionality
• MCP Adapter integration
• REST transport layer for MCP communication
• Best practices for MCP server implementation in WordPress

Features

The plugin implements a comprehensive set of MCP abilities that demonstrate WordPress content management through the Model Context Protocol:

Posts Management (CRUD Operations)

• Create Post (wpmcp-example/create-post) - Create posts for any public post type with HTML content and WordPress block support
• Get Post (wpmcp-example/get-post) - Retrieve individual posts with full content and metadata
• List Posts (wpmcp-example/list-posts) - Query and filter posts across different post types
• Update Post (wpmcp-example/update-post) - Modify existing posts including content, metadata, and status
• Delete Post (wpmcp-example/delete-post) - Remove posts from the system

Post Metadata Management

• List Post Meta Keys (wpmcp-example/list-post-meta-keys) - Discover available metadata fields
• Get Post Meta (wpmcp-example/get-post-meta) - Retrieve specific metadata values
• Update Post Meta (wpmcp-example/update-post-meta) - Modify post metadata
• Delete Post Meta (wpmcp-example/delete-post-meta) - Remove metadata entries

Gutenberg Blocks Integration

• List Block Types (wpmcp-example/list-block-types) - Discover available Gutenberg blocks with descriptions, categories, and attribute schemas for proper block comment generation

Taxonomy & Terms Management

• List Taxonomies (wpmcp-example/list-taxonomies) - Explore available taxonomies and their configurations
• Get Terms (wpmcp-example/get-terms) - Retrieve terms from specific taxonomies
• Create Term (wpmcp-example/create-term) - Add new terms to taxonomies
• Update Term (wpmcp-example/update-term) - Modify existing terms
• Delete Term (wpmcp-example/delete-term) - Remove terms from taxonomies

Post-Term Relationships

• Attach Post Terms (wpmcp-example/attach-post-terms) - Associate posts with taxonomy terms
• Detach Post Terms (wpmcp-example/detach-post-terms) - Remove term associations from posts

Technical Stack:

• PHP 8.1+
• WordPress Abilities API
• MCP Adapter with REST transport
• Jetpack Autoloader

Code Quality:

• WordPress Coding Standards (PHPCS)
• PHPStan Level 8 static analysis
• Automated code formatting

Dependencies

Abilities API: Currently hardcoded in this implementation. As soon as it becomes available as a Composer package, it will be loaded as a standard dependency.

Installation

Prerequisites

• WordPress 6.0+ (recommended)
• PHP 8.1 or higher
• Composer installed on your system
• WordPress Application Passwords enabled (for MCP client authentication)

Steps

1. Clone or download this plugin to your WordPress plugins directory:

   cd wp-content/plugins/
   git clone [repository-url] mcp-adapter-implementation-example
   # OR extract the plugin files to wp-content/plugins/mcp-adapter-implementation-example/
   

2. Install dependencies by running Composer in the plugin directory:

   cd wp-content/plugins/mcp-adapter-implementation-example/
   composer install
   

3. Activate the plugin through the WordPress admin dashboard:

   • Go to Plugins → Installed Plugins
   • Find "MCP Adapter Implementation Example"
   • Click "Activate"

4. Verify installation:

   • The plugin will automatically register MCP abilities
   • An MCP server endpoint will be created at: /wp-json/mcp-adapter-example/mcp
   • Check WordPress admin for any error messages

Post-Installation

• Configure your MCP client using the server configuration provided in the next section
• Generate Application Passwords for secure API access
• Test the connection using an MCP-compatible tool or client

Usage

This is an educational/example plugin demonstrating MCP Adapter implementation patterns. Once activated, it exposes WordPress content management capabilities through the Model Context Protocol for AI agent interaction.

The plugin creates an MCP server at the mcp-adapter-example endpoint with tools prefixed as wpmcp-example/ to demonstrate proper tool naming conventions.

Development

Code Quality Commands

# Check coding standards
composer lint:php

# Fix coding standards automatically
composer lint:php:fix

# Run static analysis
composer lint:php:stan

# Format code (alias for lint:php:fix)
composer format

Documentation

• Coding Standards - Detailed setup and usage guide

MCP Server Configuration

{
  "mcpServers": {
    "wordpress-mcp.test-mcp-tools": {
      "command": "npx", // or full path to npx
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"      ],
      "env": {
        "WP_API_URL": "http://your-wordpress-site.com/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "your wordpress username",
        "WP_API_PASSWORD": "your wordpress application password", // https://make.wordpress.org/core/2020/11/05/application-passwords-integration-guide/
        "LOG_FILE": "optional full path to logs file"
      }
    }
  }
}