Agent Builder MCP

MCP server companion plugin for Agent Builder — connect Claude Desktop, Claude Code, VS Code, Cursor, or any MCP-compatible client directly to your WordPress AI assistants.

What It Does

This plugin vendors the wordpress/mcp-adapter and wordpress/abilities-api packages via Jetpack Autoloader. Once active, Agent Builder detects these classes and automatically creates a scoped MCP server for every installed assistant.

Each assistant gets its own endpoint:

/wp-json/agentic/{slug}/mcp

MCP clients receive a focused, scoped tool set — only the tools that assistant declares — rather than the full catalogue.

Requirements

• Agent Builder (free, WordPress.org) — must be active
• Personal or Agency license at agentic-plugin.com to access the MCP tab and CLI commands
• PHP 8.1+
• WordPress 6.4+

Installation

One-click (recommended)

Go to Agent Builder → Settings → MCP → Install Agent Builder MCP. Requires a valid license.

Manual

1. Download agent-builder-mcp.zip from agentic-plugin.com/downloads.
2. In wp-admin go to Plugins → Add New → Upload Plugin and upload the zip.
3. Activate, then visit Agent Builder → Settings → MCP.

Composer (advanced)

composer require agentic/agent-builder-mcp

Quick Setup

HTTP transport

1. Go to Users → Profile → Application Passwords and generate a password (e.g. name it Claude Desktop).
2. In Agent Builder → Settings → MCP, paste it into the Connect column for your assistant.
3. Click Copy Config and paste into your MCP client.

STDIO transport (local / SSH)

wp agent mcp-connect <assistant-slug>
# or with explicit transport:
wp agent mcp-connect <assistant-slug> --transport=http

Copy the printed JSON block into your MCP client's config file.

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "agentic-content-writer": {
      "command": "wp",
      "args": ["--path=/var/www/yoursite", "mcp-adapter", "serve", "--server=agentic-content-writer", "--user=mcp-user"],
      "env": {}
    }
  }
}

VS Code (settings.json)

{
  "mcp": {
    "servers": {
      "agentic-content-writer": {
        "type": "http",
        "url": "https://yoursite.com/wp-json/agentic/content-writer/mcp",
        "headers": {
          "Authorization": "Basic <base64(username:app-password)>"
        }
      }
    }
  }
}

Architecture

This plugin has no logic of its own beyond loading the autoloader. All MCP server registration, tool scoping, and credential management is handled by class-mcp-integration.php in Agent Builder.

agent-builder-mcp/
├── agent-builder-mcp.php   # Plugin header + autoloader bootstrap
├── composer.json           # Requires wordpress/mcp-adapter + abilities-api
├── readme.txt              # WordPress.org readme
├── README.md               # This file
└── vendor/                 # Jetpack Autoloader + vendored packages (not in git)

Vendored Packages

Package	Version	Purpose
wordpress/mcp-adapter	^0.4	MCP server protocol implementation
wordpress/abilities-api	^0.5	WordPress Abilities API bridge
automattic/jetpack-autoloader	^3.0	Conflict-safe PSR-4 autoloading

Development

# Install dependencies
composer install

# The vendor dir is gitignored — rebuild the distributable zip:
cd /tmp && cp -r /path/to/agent-builder-mcp . && rm -rf agent-builder-mcp/.git
zip -r agent-builder-mcp.zip agent-builder-mcp/

Changelog

1.0.1

• Rename plugin folder and main file to agent-builder-mcp for consistency

1.0.0

• Initial release
• Vendors wordpress/mcp-adapter ^0.4 and wordpress/abilities-api ^0.5
• agentic_mcp_client WP role created for scoped Application Password auth

License

GPL-2.0-or-later — see LICENSE.