WordPress

You can manage multiple WordPress sites from a single MCP server and generate AI-powered content with automatically created featured images. This server lets you publish across sites, control categories and tags, and securely authenticate via WordPress API credentials while leveraging OpenAI for image generation.

How to use

You connect an MCP-compatible client to the WordPress MCP Server and use practical prompts to create and manage content across your WordPress sites. Typical workflows include creating an article on a specific site, generating an image for the post, testing connectivity to ensure your site is reachable, and listing available categories or tags to organize posts. Use simple, action-oriented commands like asking to create an article on a given site or to fetch the site’s categories, then let the MCP server handle posting, tagging, and image handling automatically.

How to install

Prerequisites you need before installing:

• Python 3.8 or higher

• Claude Desktop (or any MCP-compatible client)

• WordPress sites with REST API enabled

• OpenAI API key for image generation

1. Clone and install

git clone https://github.com/seomentor/wpmcp.git
cd wpmcp
pip install -r requirements.txt

2. Configure WordPress sites

sites:
  - id: "site1"
    name: "My WordPress Blog"
    url: "https://myblog.com"
    username: "your-username"
    password: "your-app-password"

3. Set Up OpenAI (Optional, for images)

OPENAI_API_KEY=your-api-key-here

4. Configure Claude Desktop

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/path/to/wordpress-mcp-server"
    }
  }
}

Option 2: Include OpenAI API Key in Claude Config

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/path/to/wordpress-mcp-server",
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

5. Start Using!

In Claude Desktop, send a prompt like: "Create an article about AI trends with an image on site1".

Additional sections

This MCP server supports automatic image generation via OpenAI's DALL-E 3, uploading images directly to the WordPress media library, and setting the post’s featured image automatically. You can manage multi-site publishing, control categories and tags, and publish across sites with bulk actions. Security relies on WordPress Application Passwords for API access.

Image generation and configuration notes

OPENAI_API_KEY=sk-...

OpenAI image generation works with prompts derived from the article title and content, producing SEO-friendly filenames and pushing images to WordPress as featured images.

Advanced configuration

settings:
  default_post_status: "draft"   # draft, publish, private
  default_post_format: "standard"
  max_retries: 3
  timeout: 30

Troubleshooting

If you encounter issues, run the diagnostic tool to verify your setup and identify common problems like Python version mismatches, missing dependencies, or OpenAI key conflicts.

Security notes

Use WordPress application passwords for API access and ensure your WordPress site URL uses https. Regenerate application passwords if you suspect they have been compromised.

Notes

This server is designed for content agencies, blog networks, multilingual publishing, and AI-assisted writing workflows. It supports bulk article creation across multiple WordPress sites and works with a compatible MCP client to streamline content operations.

Available tools

list_sites

Show all configured sites

create_article

Create a new post on a specific site

create_with_image

Create a post with an AI-generated image

test_connection

Verify site access

get_categories

List site categories

get_tags

List site tags