MCP For Wordpress

🚀 WordPress MCP Integration

This is an optimized TypeScript SDK tailored for WordPress integration. It enables interaction with WordPress sites using the Model Context Protocol (MCP) via the WordPress REST API.

🚀 Quick Start

This SDK allows seamless interaction with WordPress sites through the MCP protocol, providing functions to create, retrieve, and update WordPress posts.

✨ Features

• Create new WordPress posts.
• Retrieve existing WordPress posts.
• Update existing WordPress posts.

📦 Installation

1. Clone this repository.
2. Install dependencies:

npm install

📚 Documentation

Configuration

There are two ways to configure the WordPress integration:

1. Environment Variables

Set the following environment variables:

• WORDPRESS_SITE_URL: Your WordPress site URL.
• WORDPRESS_USERNAME: WordPress username.
• WORDPRESS_PASSWORD: WordPress application password.

2. Request Parameters

Provide credentials directly when calling the tools.

Security Considerations

For security reasons, it is recommended to use a WordPress application password instead of the main account password. You can generate an application password in the Users → Security → Application Passwords section of the WordPress admin panel.

Available Tools

create_post

Create a new WordPress post. Parameters:

• siteUrl: (Optional if set in the environment) WordPress site URL.
• username: (Optional if set in the environment) WordPress username.
• password: (Optional if set in the environment) WordPress application password.
• title: Post title.
• content: Post content.
• status: (Optional) 'draft' | 'publish' | 'private' (Default: 'draft'). Example:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_post",
    "arguments": {
      "title": "My New Post",
      "content": "Hello, World!",
      "status": "draft"
    }
  }
}

get_posts

Retrieve WordPress posts. Parameters:

• siteUrl: (Optional if set in the environment) WordPress site URL.
• username: (Optional if set in the environment) WordPress username.
• password: (Optional if set in the environment) WordPress application password.
• perPage: (Optional) Number of posts per page (Default: 10).
• page: (Optional) Page number (Default: 1). Example:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_posts",
    "arguments": {
      "perPage": 5,
      "page": 1
    }
  }
}

update_post

Update an existing WordPress post. Parameters:

• siteUrl: (Optional if set in the environment) WordPress site URL.
• username: (Optional if set in the environment) WordPress username.
• password: (Optional if set in the environment) WordPress application password.
• postId: ID of the post to update.
• title: (Optional) New post title.
• content: (Optional) New post content.
• status: (Optional) 'draft' | 'publish' | 'private'. Example:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_post",
    "arguments": {
      "postId": 123,
      "title": "Updated Post Title",
      "status": "publish"
    }
  }
}

Running the Server

Start the WordPress MCP server:

npm run start

Notes

• Ensure that the environment variables are set correctly so that the tools can connect to the WordPress site properly.
• When calling the API, make sure to provide valid credentials to avoid permission issues.