How to Use the WordPress Media Uploader MCP in Mastra AI

Q: How do I use the WordPress Media Uploader with Mastra AI?

You define a step in your workflow that calls uploadwordpressmedia. Your agent passes it the source URL, filename, and alt text. The tool handles the download and upload to WordPress.

Deploy media assets to WordPress using Mastra AI's robust workflow engine.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect WordPress Media Uploader MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Managed Media Asset Deployment

The `upload_wordpress_media` tool downloads an image from a public URL and uploads it right into your WordPress library. This makes it simple to build multi-step workflows that require asset deployment. Your Mastra AI agent can use this in conjunction with other tools, ensuring images are uploaded only after a payment succeeds or a required piece of data is gathered.

Reliable Image Handling

The tool requires three key inputs: the public source URL, a descriptive filename, and an optional alt text. If any step fails—say, the image link expires—your workflow can automatically retry using exponential backoff. This gives you high reliability when deploying blog cover images that absolutely must get into WordPress.

Workflow-Driven Uploads

You don't just run a single upload command. You build complex, stateful workflows where the `upload_wordpress_media` tool is called only when certain conditions are met or after human review. This control means you can guarantee that every image asset deployment into WordPress follows your business logic.

Setup guide

Set up WordPress Media Uploader 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 Media Uploader 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-media-uploader-mcp-client",
  servers: {
    "wordpress-media-uploader-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent WordPress Media Uploader 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 Media Uploader 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 Media Uploader MCP in Mastra AI

You define a step in your workflow that calls `upload_wordpress_media`. Your agent passes it the source URL, filename, and alt text. The tool handles the download and upload to WordPress.

It's excellent. Because Mastra AI supports conditional branching, you can check if an image exists before attempting the `upload_wordpress_media` call, preventing unnecessary retries.

The server handles public source URLs, descriptive filenames, and alt text. It updates media assets within WordPress based on these parameters.

Absolutely. You can configure automatic retries with exponential backoff if the `upload_wordpress_media` tool encounters a temporary network issue or API error.

Yes, because it's built into Mastra AI's framework. You can deploy the entire media management process reliably to any cloud environment with one command.

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