How to Use the Zesty.io MCP in Pydantic AI

Q: What tools can I use to list available content models with Pydantic AI?

You call listcontentmodels. This function returns the specific Model ZUIDs, and your agent validates that these IDs are correctly formatted before proceeding.

Q: Can Pydantic AI validate data retrieved from Zesty.io content items?

Yes. When you execute getcontentitem, the resulting JSON is validated against a schema. If fields are missing or typed incorrectly, your agent immediately flags it.

Q: Which tool should I use to view all Zesty.io instances with Pydantic AI?

Use listzestyinstances. This function gives you the current account's context and is validated by your agent before it attempts any subsequent operations.

Guarantee data correctness when managing content items using Pydantic AI with Zesty.io.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Zesty.io MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Model and Instance Discovery

When you need to know what models are available, call `list_content_models`. This guarantees that your agent uses the correct type identifier for content creation. Similarly, `list_zesty_instances` lets it verify all existing Zesty.io accounts. These methods ensure the data structure is known before any operation runs.

Content Item Creation and Modification

To write new content, use `create_content_item`, passing in structured fields that Pydantic can validate at runtime. If the API returns garbage data, your agent fails loudly instead of silently corrupting the record. Similarly, when running `update_content_item`, validation catches unexpected changes immediately.

Viewing and Deleting Content Records

Need to see what's there? Use `list_content_items` to get a list of items for a model. If an item is trash, the `delete_content_item` tool removes it safely. By wrapping these API calls in Pydantic validation, you ensure the data received matches your expected schema.

Setup guide

Set up Zesty.io 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": {
        "zestyio-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent Zesty.io 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 Zesty.io. 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 Zesty.io 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 Zesty.io MCP in Pydantic AI

The MCP Server provides raw Zesty API calls, and Pydantic handles the validation layer on top of that. Your agent's output is guaranteed to match a schema because every response passes through runtime type checks.

You call `list_content_models`. This function returns the specific Model ZUIDs, and your agent validates that these IDs are correctly formatted before proceeding.

Yes. When you execute `get_content_item`, the resulting JSON is validated against a schema. If fields are missing or typed incorrectly, your agent immediately flags it.

Use `list_zesty_instances`. This function gives you the current account's context and is validated by your agent before it attempts any subsequent operations.

This server touches Content Models, Content Items, and Instances. Pydantic ensures that whatever fields are returned for these resources conform precisely to the expected structure.

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