How to Use the MainWP MCP in Pydantic AI

Q: How does Pydantic AI improve managing MainWP updates?

Pydantic AI validates the data from listavailableupdates against a model you define. This guarantees your agent is always working with a predictable, typed list of updates, preventing runtime errors if the API response changes.

Q: Can I trigger a MainWP security scan with a Pydantic AI agent?

Yes, your agent can call scannetworkmalware and scannetworkvulnerabilities. Pydantic AI ensures the response matches your expected schema, adding a layer of reliability and type safety to your security automation.

Q: What's the safest way for a Pydantic AI agent to list all sites from MainWP?

Use the listchildsites tool. Pydantic AI will parse the returned list into strongly-typed objects, so you can safely access properties like site.name in your code without worrying about KeyError exceptions or None values.

Q: How do I make sure my agent has the latest data before running updates?

Have your agent call syncchildsites at the start of its workflow. This tells your MainWP instance to get fresh data from all your WordPress sites before you use tools like listavailableupdates.

Manage your WordPress network with type-safe agents. Pydantic AI validates every MainWP API response so your automations don't fail silently.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MainWP MCP to Pydantic AI

Create your Vinkius account to connect MainWP to Pydantic 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 MainWP with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get Structured, Validated Site Data

When your agent calls `list_child_sites` or `list_site_plugins`, Pydantic AI parses the response into a Pydantic model you've defined. If the MainWP API ever changes its output, your agent will raise a `ValidationError`. No more silent breaks or corrupted data. This lets you build reliable loops and conditionals. You can iterate over the list from `list_child_sites` with full confidence that `site.url` and `site.id` will always exist and be correctly typed. It's about building automation you can actually trust.

Execute Updates with Confidence

The `upgrade_site_resource` tool requires a specific JSON body to work. With Pydantic AI, you build that request as a Pydantic model, getting you static analysis and autocomplete in your IDE. You're far less likely to send a bad request. This same rigor applies when checking for work. An agent can call `get_pending_updates_count`, and Pydantic AI ensures the response is a clean integer. This stops your agent from misinterpreting a `null` or an error string as zero, which could cause it to skip critical updates.

A Reliable MainWP MCP Server Integration

This isn't just about calling an API; it's about defining a contract. The Pydantic AI framework turns the MainWP tools into functions with typed inputs and outputs. You know exactly what data to expect from `scan_network_vulnerabilities` before you even write the code to handle it. Because Pydantic AI is model-agnostic, you can swap your LLM without rewriting your MainWP integration logic. Your core automation, built around trusted Pydantic models for tools like `list_available_updates`, stays stable and correct no matter which LLM is driving the agent.

Setup guide

Set up MainWP MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "mainwp-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to MainWP tools.",
)

result = await agent.run("List recent MainWP transactions")
print(result.output)

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 MainWP. 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 MainWP 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 MainWP MCP in Pydantic AI

Pydantic AI validates the data from `list_available_updates` against a model you define. This guarantees your agent is always working with a predictable, typed list of updates, preventing runtime errors if the API response changes.

Yes, your agent can call `scan_network_malware` and `scan_network_vulnerabilities`. Pydantic AI ensures the response matches your expected schema, adding a layer of reliability and type safety to your security automation.

Use the `list_child_sites` tool. Pydantic AI will parse the returned list into strongly-typed objects, so you can safely access properties like `site.name` in your code without worrying about `KeyError` exceptions or `None` values.

Have your agent call `sync_child_sites` at the start of its workflow. This tells your MainWP instance to get fresh data from all your WordPress sites before you use tools like `list_available_updates`.

It handles the metadata needed for management: site URLs, lists of plugins and themes, and their version numbers. The server never touches site content or user databases. Your connection is secured by a Vinkius token, and Pydantic AI's validation ensures only expected data structures are ever processed by your agent.

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