WordPress Plugin Directory MCP Server
Allows searching, downloading, extracting, and comparing WordPress.org plugins with local plugins, including detailed diffs and file analysis.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WordPress Plugin Directory MCP Server Search for form builder plugins"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WordPress Plugin Directory MCP Server
A Model Context Protocol (MCP) server that enables Claude Code to analyze, download, and compare WordPress.org plugins with your local plugins.
🔗 Repository: https://github.com/juanma-wp/wordpress-org-mcp
Features
Search plugins on WordPress.org by keyword
Download plugins directly from WordPress.org
Extract and analyze plugin files
Compare local plugins with WordPress.org versions
Generate detailed diffs between plugin versions
Browse plugin file structures
Related MCP server: WordPress MCP Server
Installation & Setup
# Register with Claude CLI
claude mcp add wordpress-org npx wordpress-org-mcp-server
# Verify registration
claude mcp listAvailable Tools
search_plugins
Search for WordPress.org plugins by keyword.
Parameters:
query(string): Search querylimit(number, optional): Maximum results (default: 10)
Example:
Search for "jwt authentication" pluginsget_plugin_info
Get detailed information about a specific plugin.
Parameters:
slug(string): Plugin slug
Example:
Get info for plugin "jwt-authentication-for-wp-rest-api"download_plugin
Download a plugin from WordPress.org.
Parameters:
slug(string): Plugin slugversion(string, optional): Version (default: "latest")
extract_plugin
Extract a downloaded plugin ZIP file.
Parameters:
slug(string): Plugin slugzip_path(string, optional): Path to ZIP file
list_plugin_files
List files in an extracted plugin.
Parameters:
slug(string): Plugin slugextension(string, optional): Filter by extension (.php, .js, etc.)
read_plugin_file
Read contents of a specific plugin file.
Parameters:
slug(string): Plugin slugfile_path(string): Relative path to file
compare_plugins
Compare local plugin with WordPress.org version.
Parameters:
local_path(string): Path to local plugin directorywp_org_slug(string): WordPress.org plugin slugformat(string, optional): "summary" or "detailed" (default: "summary")
Example:
Compare my local plugin with WordPress.org version:
- local_path: "/absolute/path/to/rest-auth-jwt"
- wp_org_slug: "jwt-authentication-for-wp-rest-api"get_file_diff
Get detailed diff for a specific file.
Parameters:
local_path(string): Path to local pluginwp_org_slug(string): WordPress.org plugin slugfile_path(string): Relative path to file
Example Workflow
Search for similar plugins:
Search for JWT authentication plugins to see what's availableGet plugin details:
Get detailed info for "jwt-authentication-for-wp-rest-api"Compare with your local plugin:
Compare my local plugin at "/path/to/my/plugin" with "jwt-authentication-for-wp-rest-api"Examine specific differences:
Show me the diff for "includes/class-auth.php" between my plugin and "jwt-authentication-for-wp-rest-api"
Plugin Storage Locations
The server stores downloaded and extracted plugins in system directories to avoid cluttering your project workspace:
Default Locations
macOS:
Cache (downloads):
~/Library/Caches/wordpress-org-mcp/Extractions:
/tmp/wordpress-org-mcp-extractions/
Linux:
Cache (downloads):
~/.cache/wordpress-org-mcp/(or$XDG_CACHE_HOME/wordpress-org-mcp/)Extractions:
/tmp/wordpress-org-mcp-extractions/
Windows:
Cache (downloads):
%LOCALAPPDATA%\wordpress-org-mcp\Cache\Extractions:
%TEMP%\wordpress-org-mcp-extractions\
Customizing Storage Locations
Set these environment variables before registering the MCP server:
# Set custom paths
export WP_MCP_CACHE_DIR="/path/to/custom/cache"
export WP_MCP_EXTRACT_DIR="/path/to/custom/extractions"
# Register the MCP server (will use custom paths)
claude mcp add wordpress-org npx wordpress-org-mcp-server
**Persistent Setup:**
Add the environment variables to your shell profile (`.bashrc`, `.zshrc`, `.bash_profile`, etc.):
```bash
echo 'export WP_MCP_CACHE_DIR="/path/to/custom/cache"' >> ~/.zshrc
echo 'export WP_MCP_EXTRACT_DIR="/path/to/custom/extractions"' >> ~/.zshrc
source ~/.zshrcEnvironment Variables:
WP_MCP_CACHE_DIR: Custom directory for downloaded ZIP filesWP_MCP_EXTRACT_DIR: Custom directory for extracted plugin files
Why System Directories?
No Git conflicts: Downloaded plugins won't appear in your project's version control
Cross-platform compatibility: Uses appropriate directories for each operating system
Easy cleanup: Temporary extractions are automatically cleaned up on system restart
Development
# Watch mode for development
npm run dev
# Build for production
npm run build
# Start the server
npm startTroubleshooting
"Plugin not found" errors: Verify the plugin slug is correct on WordPress.org
Download failures: Check internet connection and WordPress.org availability
Extraction errors: Ensure sufficient disk space and file permissions
Supported File Types
PHP files (.php)
JavaScript files (.js)
CSS files (.css)
Text files (.txt, .md)
Configuration files (.json, .xml, .yml)
Binary files are compared by size only.
Available Tools
8 toolscompare_pluginsB
Compare a local plugin with a WordPress.org plugin
Inputs: local_path (required), wp_org_slug (required), format.
download_pluginC
Download a plugin from WordPress.org
Inputs: slug (required), version.
extract_pluginC
Extract a downloaded plugin ZIP file
Inputs: slug (required), zip_path.
get_file_diffB
Get detailed diff for a specific file between local and WordPress.org plugin
Inputs: local_path (required), wp_org_slug (required), file_path (required).
get_plugin_infoC
Get detailed information about a specific plugin
Inputs: slug (required).
list_plugin_filesC
List files in an extracted plugin
Inputs: slug (required), extension.
read_plugin_fileB
Read the contents of a specific file from an extracted plugin
Inputs: slug (required), file_path (required).
search_pluginsA
Search for WordPress.org plugins by keyword
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct operation: search, get info, download, extract, list files, read file, compare, and diff. No two tools overlap in purpose; agents can easily distinguish them.
All tool names follow the verb_noun snake_case pattern consistently (e.g., search_plugins, get_plugin_info, list_plugin_files). No deviations or mixed conventions.
With 8 tools, the set is well-scoped for a plugin directory server. It covers the essential workflow (search, get info, download, extract, browse files) without being bloated or sparse.
The tools cover the full lifecycle of interacting with WordPress.org plugins: searching, retrieving info, downloading, extracting, inspecting files, and comparing with local plugins. No obvious gaps for the intended domain.
Maintenance
Related MCP Connectors
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
Manage your WordPress site from ChatGPT or Claude: posts, WooCommerce, SEO, images and upkeep.
Sync Lightroom, Figma, Dropbox & Canva assets to WordPress and Shopify via natural language.
Sync Lightroom, Figma, Dropbox & Canva assets to WordPress and Shopify via natural language.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to manage WordPress sites through natural conversation, supporting post creation, content updates, site queries, and draft-to-publish workflows via the WordPress REST API.9MIT
- AlicenseCqualityDmaintenanceEnables AI assistants to manage WordPress content, design, SEO, WooCommerce, and more through natural language commands.10018 npm3MIT
- AlicenseNot gradedqualityBmaintenanceEnables interaction with WordPress sites through the WordPress REST API via natural language, supporting single and multi-site management, content and taxonomy operations, media uploads, and more.159 npm100GPL 3.0
- AlicenseNot gradedqualityDmaintenanceEnables creating, customizing, managing, and sharing local WordPress sites through natural language, leveraging WP-CLI and AI integration.68MIT