How to Use the WordPress MCP in OpenAI Agents SDK

Q: How do I check post status using WordPress and OpenAI Agents SDK?

The agent uses getpostdetails to retrieve the current state of any specific WordPress post. This gives you visibility into whether it's a draft or if it's already live.

Q: Can I list all users for my WordPress site using OpenAI Agents SDK?

Yeah, absolutely. You just call listsiteusers. This tool connects to the MCP Server and gives you a full roster of every account registered on your WordPress installation.

Q: Does the OpenAI Agents SDK handle permanent deletion for WordPress content?

Yes, it can. When using deletecmspost, setting the force parameter to true bypasses the trash and permanently deletes the post from WordPress. Be careful with that one.

Q: What if I need to update a static page in WordPress? Can OpenAI Agents SDK handle it?

Sure thing. You'll use updatecmspost and make sure you specify the post ID, then send the JSON payload with the changes for your static pages.

Build production WordPress agents with the OpenAI Agents SDK.

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 OpenAI Agents SDK

Create your Vinkius account to connect WordPress to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Posts and Pages via MCP Server

You can create new content and set its initial status—draft, private, or published—using `create_cms_post`. This tool handles titles and content for the entire WordPress site. Need to change something later? You'll use `update_cms_post` with a specific post ID. The agent validates the fields before touching the live WordPress environment.

Audit Site Content and Users

The MCP Server lets you grab detailed lists of everything on the site. You can use `list_site_users` to check who's registered, or `list_site_categories` to see your current taxonomy structure. Want to know what kind of content is available? Simply running `list_site_posts` gives you a queryable list that respects standard WP parameters like per page counts.

Handle Media and Attachments

The agent handles all your media needs. You can run `list_media_attachments` to get a full rundown of images or documents stored in the library. This makes sure that when you're building content, you know exactly which assets are available to attach to posts or pages before writing a single line of code.

Setup guide

Set up WordPress MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all WordPress tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives WordPress tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate WordPress tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="WordPress Agent",
            instructions="You have access to WordPress tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

The agent uses `get_post_details` to retrieve the current state of any specific WordPress post. This gives you visibility into whether it's a draft or if it's already live.

Yeah, absolutely. You just call `list_site_users`. This tool connects to the MCP Server and gives you a full roster of every account registered on your WordPress installation.

Yes, it can. When using `delete_cms_post`, setting the force parameter to true bypasses the trash and permanently deletes the post from WordPress. Be careful with that one.

Sure thing. You'll use `update_cms_post` and make sure you specify the post ID, then send the JSON payload with the changes for your static pages.

Because of its built-in guardrails, the agent validates every action before it hits the MCP Server. This means you get immediate error feedback if your intended write operation fails to meet WP standards.

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