MCP WordPress.com Remote

A Model Context Protocol (MCP) server for seamless WordPress.com integration

This package wraps @automattic/mcp-wordpress-remote with WordPress.com-optimized defaults, making it easy to connect AI assistants like Claude Desktop to WordPress.com sites.

Features

• WordPress.com Optimized - Pre-configured for WordPress.com public API
• Secure OAuth 2.0 Authentication - One-click setup with persistent token storage
• Zero Configuration - Works out of the box for WordPress.com sites
• Complete MCP Support - Tools, resources, prompts, and more

Quick Start

Installation

npm install @automattic/mcp-wpcom-remote

Configuration

Add to your MCP client configuration (e.g., Claude Desktop's claude_desktop_config.json):

{
  "mcpServers": {
    "wordpress.com": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wpcom-remote"]
    }
  }
}

First Run

1. Start your MCP client (Claude Desktop, etc.)
2. Browser opens automatically for WordPress.com authorization
3. Authorize the application - tokens are stored permanently
4. Start using WordPress.com features in your AI assistant

That's it! No additional configuration needed for WordPress.com.

WordPress.com Defaults

This package automatically configures:

• API Endpoint: https://public-api.wordpress.com/wpcom/v2/mcp/v1
• OAuth Client ID: 121755 (WordPress.com MCP client)
• OAuth Enabled: true by default
• Callback Port: 3000
• Config Directory: ~/.mcp-auth/wpcom-remote-{version}/

Advanced Configuration

Custom Configuration

You can override any default settings using environment variables:

{
  "mcpServers": {
    "wordpress.com": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wpcom-remote"],
      "env": {
        "OAUTH_CALLBACK_PORT": "8080",
        "LOG_FILE": "/path/to/logfile.log"
      }
    }
  }
}

JWT Token Authentication

For server-to-server authentication:

{
  "mcpServers": {
    "wordpress.com": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wpcom-remote"],
      "env": {
        "JWT_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Custom WordPress.com Endpoint

If you need to use a different WordPress.com endpoint:

{
  "mcpServers": {
    "wordpress.com": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wpcom-remote"],
      "env": {
        "WP_API_URL": "https://your-custom-endpoint.com/wpcom/v2/mcp/v1"
      }
    }
  }
}

Environment Variables

| Variable | Default | Description | | ---------------------- | -------------------------------------------------- | ----------------------------- | | WP_API_URL | https://public-api.wordpress.com/wpcom/v2/mcp/v1 | WordPress.com API endpoint | | OAUTH_ENABLED | true | Enable OAuth authentication | | OAUTH_CALLBACK_PORT | 3000 | OAuth callback port | | OAUTH_HOST | 127.0.0.1 | OAuth callback hostname | | WPCOM_CLIENT_ID | 121755 | WordPress.com OAuth client ID | | WPCOM_MCP_CONFIG_DIR | ~/.mcp-auth | Config directory override | | JWT_TOKEN | (none) | JWT token for authentication | | LOG_FILE | (none) | Log file path |

Development Mode

For development and testing, you can use the local repository:

Setup

1. Clone the repository:

   git clone https://github.a8c.com/Automattic/mcp-wpcom-remote.git
   cd mcp-wpcom-remote

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Configuration

Configure your MCP client to use the local version:

{
  "mcpServers": {
    "wordpress.com": {
      "command": "node",
      "args": ["/path/to/your/mcp-wpcom-remote/dist/proxy.js"]
    }
  }
}

Troubleshooting

OAuth Issues

Browser doesn't open:

• Check if port 3000 is available
• Try a different port with OAUTH_CALLBACK_PORT

Authorization fails:

• Verify WordPress.com account permissions
• Try clearing tokens: rm -rf ~/.mcp-auth/wpcom-remote-*/

Port Conflicts

If port 3000 is already in use:

{
  "env": {
    "OAUTH_CALLBACK_PORT": "8080"
  }
}

What's Different from mcp-wordpress-remote

This package (mcp-wpcom-remote) is a WordPress.com-optimized wrapper that:

• Pre-configures WordPress.com API endpoint
• Uses WordPress.com OAuth client ID by default
• Enables OAuth by default (vs disabled in the generic package)
• Uses wpcom-specific config directory for token isolation
• Integrates logging from the underlying package for consistent log formatting

For self-hosted WordPress sites, use @automattic/mcp-wordpress-remote directly.

Requirements

• Node.js 22+ (inherited from underlying package)
• WordPress.com account (for OAuth authentication)

License

GPL v2 or later

Contributing

Contributions welcome! This project is maintained by Automattic Inc.

Need help? Check the troubleshooting section or open an issue.