# WordPress MCP

> WordPress MCP lets you manage your entire website's content—posts, pages, media, users, categories—directly through natural conversation. Skip the admin dashboard login; interact with every piece of site data from any compatible AI client.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** blogging, web-publishing, post-management, cms, website-management, content-workflow

## Description

Need to make changes on a WordPress site but don't want to log into the WP-Admin dashboard? This MCP connects your favorite AI agent straight to your content backend, letting you treat your entire website like a database you can chat with. You can ask it to list all published blog articles or check if a specific user still needs access. It handles everything from drafting and setting post statuses to listing every uploaded image's URL for social media campaigns. Accessing this level of control is usually buried in menus, but here, your agent makes it conversational. Through Vinkius, you get one entry point that lets any MCP-compatible client take over the manual labor of content management, letting you focus on writing and strategy instead of clicking through tabs.

## Tools

### delete_cms_post
Permanently deletes a specific WordPress article, either sending it to trash or forcing immediate removal.

### create_cms_post
Generates a brand new post with content and title, setting its initial status as draft, private, or published.

### get_post_details
Pulls all the specific information for one WordPress article by ID.

### list_site_categories
Retrieves a complete list of every category defined across your entire site.

### list_media_attachments
Lists all image and document files stored in the WordPress media library.

### list_static_pages
Shows a list of pages that are not blog posts, like 'About Us' or 'Contact'.

### list_site_posts
Lists multiple articles from the site, supporting filters by category or pagination.

### list_site_tags
Retrieves a full list of all tags used across your entire website content.

### list_site_users
Lists every user account registered on the WordPress site, including their numeric ID.

### update_cms_post
Changes specific fields of an existing post after you provide the post's unique ID.

## Prompt Examples

**Prompt:** 
```
List the last 5 posts on my WordPress site.
```

**Response:** 
```
I found your 5 most recent posts: 1. 'Welcome to 2026' (ID: 101, Status: publish), 2. 'New Product Features' (ID: 102, Status: draft), 3. 'Our Vision' (ID: 103, Status: publish), and 2 others. Which one would you like to see the details for?
```

**Prompt:** 
```
Create a new draft post titled 'AI in Marketing' with content '<p>AI is changing everything...</p>'.
```

**Response:** 
```
Success! I've created a new draft post titled 'AI in Marketing' (ID: 155). It is currently saved as a draft. Would you like me to add any tags or categories to it?
```

**Prompt:** 
```
List all categories on my WordPress site.
```

**Response:** 
```
I found 4 categories: 'News' (ID: 1), 'Tutorials' (ID: 2), 'Product Updates' (ID: 3), and 'Case Studies' (ID: 4). Would you like to see how many posts are assigned to each?
```

## Capabilities

### Manage all core site content
You can create new posts, update existing ones, or change their publication status (draft, private, published) using a simple chat command.

### Audit and organize content structure
The MCP lists all site categories, tags, users, and static pages so you can see exactly how your content is organized.

### Handle media assets
It retrieves a complete list of uploaded images and documents, giving you their direct public URLs for immediate use in external campaigns or reports.

### Maintain content history
You can retrieve full details about any post, checking its status, featured media, and underlying technical data.

### Clean up old site data
The system allows you to safely trash or permanently delete obsolete posts through chat commands, maintaining your content's integrity.

## Use Cases

### The Campaign Launch
A marketing manager needs to gather images for a new product launch email. Instead of browsing the Media Library, they ask their agent to use `list_media_attachments`. The agent returns a list of all relevant image URLs instantly, allowing them to build the campaign without leaving the chat window.

### The Draft Push
A content writer finishes an article and needs it live. They instruct their agent to use `create_cms_post`, specifying the title, body, and 'publish' status. The post goes live instantly without ever opening the WordPress editor.

### The Site Cleanup
A CMS administrator notices outdated content. They ask their agent to `list_site_posts` filtered by a specific date range, review the list for obsolete articles, and then use `delete_cms_post` on any items that need permanent removal.

### The Feature Validation
A developer needs to check if the 'Contact Us' page content is structured correctly. They ask the agent to `list_static_pages`, verify the title, and then use `get_post_details` on that specific page ID to confirm its metadata.

## Benefits

- Publish and revise content instantly. Instead of manually navigating to the editor, you can use `create_cms_post` or `update_cms_post` to draft articles and set their status (draft/publish) in a single chat turn.
- Never lose track of media assets again. You just ask for it, and the MCP uses `list_media_attachments` to provide all direct public URLs needed for social posting or external embedding.
- Audit your site structure with confidence. Use tools like `list_site_categories`, `list_site_tags`, and `list_site_users` to quickly verify consistency and find orphaned content without manual clicking.
- Check the status of any piece of content. The `get_post_details` tool lets you instantly retrieve full technical details for a specific post, checking its featured media or publication date when needed.
- Maintain data integrity with safety. Need to clean up old articles? You can safely use `delete_cms_post` through your agent instead of manually finding and deleting them in the trash bin.

## How It Works

The bottom line is that you never have to manually navigate the WordPress backend again; you just ask your agent what you need.

1. Subscribe to this MCP and provide your WordPress Base URL, Username, and Application Password credentials.
2. Connect your preferred AI client (like Claude or Cursor) to the Vinkius catalog using the authorized credentials.
3. Start by asking a question like, 'List all draft posts for me,' and let your agent perform the actions conversationally.

## Frequently Asked Questions

**How does the WordPress MCP handle media attachments?**
The MCP uses `list_media_attachments` to list all image and document files. You receive their direct public URLs, which you can immediately use for external campaigns or embeds.

**Can I write a new draft post using the WordPress MCP?**
Yes. Use `create_cms_post` to define the title and content, setting its initial status as 'draft' so it saves without being published immediately.

**What if I need to delete a lot of old posts?**
You can first use `list_site_posts` to filter and review the articles you want gone. Once confirmed, you use `delete_cms_post` to remove them safely.

**Does WordPress MCP help with site categories?**
Yes, it uses `list_site_categories` to list all defined categories and tags. This is great for auditing your content structure.

**How do I update an existing blog article's status?**
You use the `update_cms_post` tool, providing the post ID and specifying a JSON object containing the field you need to change (like setting the status from draft to published).