How to Use the WordPress MCP in Windsurf

Q: What data does Windsurf handle for WordPress post updates?

It handles the updating of existing content via updatecmspost. You must provide the specific post ID and a JSON object detailing exactly which fields need changing. It won't guess what you mean.

Q: Can Windsurf list static pages from WordPress?

Yes, it uses liststaticpages to pull all the non-blog content off your site. This is useful for mapping out your core marketing materials or legal pages on WordPress.

Chain complex WordPress tasks without prompting every step using Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect WordPress MCP to Windsurf

Create your Vinkius account to connect WordPress to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup WordPress with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage content across the entire WordPress site.

Need to see what's available? You can list all posts with `list_site_posts` or pull details for one specific item using `get_post_details`. If you want to change something, just hit it with `update_cms_post`; you provide the post ID and a JSON object of fields.

Audit site users and content categories.

Before writing any code, you should know who's on the system. The agent handles calling `list_site_users` to pull every registered WordPress user. It also runs through all defined taxonomy using `list_site_categories`, giving you a full map of site structure.

Create and delete posts from WordPress.

Setting up new content is quick. Use `create_cms_post` to generate a post with a title, content, and initial status like draft or publish. When the content is garbage, you can execute permanent removal using `delete_cms_post(force=true)`.

Setup guide

Set up WordPress MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the WordPress MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my WordPress payment history." If connected, Cascade will call the WordPress tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "wordpress-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by WordPress. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect WordPress now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about WordPress MCP in Windsurf

Windsurf executes the standard WP query parameters. You just tell it what you need, and it uses `list_site_posts` to return filtered results based on criteria like per page or specific categories.

It handles the updating of existing content via `update_cms_post`. You must provide the specific post ID and a JSON object detailing exactly which fields need changing. It won't guess what you mean.

Yes, it uses `list_static_pages` to pull all the non-blog content off your site. This is useful for mapping out your core marketing materials or legal pages on WordPress.

It can list all media attachments—images and documents—from your library using `list_media_attachments`. This lets you audit what assets are available before building a component that needs them.

This server touches user account information, specifically listing all registered WordPress users via `list_site_users`. Always confirm your permissions when running these actions in a pipeline.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript