How to Use the WordPress MCP in Mastra AI

Q: How does Mastra AI handle listing posts in WordPress?

You define a reliable step that calls listsiteposts. If the initial query fails, the workflow engine will automatically retry the call with an exponential backoff, ensuring you eventually get the list of post IDs.

Q: Can I list site users in WordPress with Mastra AI?

Yes, you can build a workflow step that calls listsiteusers. This is useful for auditing who has access. If the call fails due to an API glitch, Mastra automatically retries it.

Q: Does Mastra AI support listing media attachments from WordPress?

The workflow can incorporate a step using listmediaattachments. This is crucial for inventory management. If the list fails, you'll get notified and the job will retry.

Build complex WordPress data workflows that automatically retry with Mastra AI, handling failure gracefully.

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 Mastra AI

Create your Vinkius account to connect WordPress to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Reliable Post Updates

You can set up multi-step jobs that update content reliably. For instance, if an attempt to write a draft post via `update_cms_post` fails due to rate limiting, Mastra handles the automatic retry. The workflow executes until success or until it hits maximum retries, giving you confidence in your publishing pipeline.

Managing Site Structure Changes

Build a process that ensures site integrity. If a new post is created using `create_cms_post`, the workflow can automatically trigger subsequent actions like listing categories via `list_site_categories` to ensure the taxonomy is updated. This kind of conditional branching makes your operations fail-safe, even if the underlying WordPress system struggles temporarily.

Auditing Content Deletion

Design a job that permanently cleans up old content. You can trigger `delete_cms_post` with `force: true`. If this action requires multiple confirmations or steps, Mastra handles the necessary retries. The workflow guarantees execution of destructive operations like permanent deletion.

Setup guide

Set up WordPress MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All WordPress tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "wordpress-mcp-client",
  servers: {
    "wordpress-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "WordPress Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to WordPress tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent WordPress transactions"
);
console.log(result.text);

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 Mastra AI

You define a reliable step that calls `list_site_posts`. If the initial query fails, the workflow engine will automatically retry the call with an exponential backoff, ensuring you eventually get the list of post IDs.

Mastra's built-in workflow engine ensures that failed updates using `update_cms_post` don't stop your entire process. It handles automatic retries until the operation succeeds or a human needs to step in.

Yes, you can build a workflow step that calls `list_site_users`. This is useful for auditing who has access. If the call fails due to an API glitch, Mastra automatically retries it.

The workflow can incorporate a step using `list_media_attachments`. This is crucial for inventory management. If the list fails, you'll get notified and the job will retry.

This server interacts with post IDs, content fields (titles/bodies), category lists, and user roles from the `list_site_users` tool.

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