How to Use the Zendesk Sell MCP in Pydantic AI

Q: How do I check my current opportunities with Zendesk Sell and Pydantic AI?

Call listsalesdeals through your agent. This gives you a list of all open deals, and because the response is validated by Pydantic models, you can trust every field you see.

Q: Can I pull a list of all qualified prospects with Zendesk Sell and Pydantic AI?

You use listsalescontacts. This returns the roster of contacts, ensuring that every field—like name and email—conforms to the expected data structure.

Q: If I need details on a specific contact with Zendesk Sell and Pydantic AI?

Use getsalescontactdetails and provide the ID. The agent validates this response against your defined models, so you never get bad data.

Q: When I create a new deal with Zendesk Sell and Pydantic AI, what must I include?

You must specify both the deal name and a valid contactid. The tool requires this pairing to ensure the opportunity is correctly associated with an existing person or organization.

Run reliable sales actions in Zendesk Sell using Pydantic AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Zendesk Sell MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get and Update Deals with Zendesk Sell MCP Server

The agent manages deals by first retrieving them with `get_deal_details`. This provides the current state of an opportunity. If details change, you call `update_existing_deal` to commit those changes back into the system. Because Pydantic validates everything, if the API sends unexpected data, your agent fails loud and clear. You'll know immediately if the deal update didn't stick.

Create New Leads using Zendesk Sell MCP Server

Need to log a new prospect? Use `create_new_lead`. The tool requires you provide either an organization name or a last name. This guarantees that the basic lead record gets created correctly. The strict typing means your agent won't submit incomplete or malformed data, keeping your CRM clean.

List All Contacts and Deals via MCP Server

You can check out all existing contacts using `list_sales_contacts`, getting a list of qualified prospects. Similarly, `list_sales_deals` pulls every open opportunity. These listing tools give you the necessary data sets to build out complex workflows while maintaining strict type safety.

Setup guide

Set up Zendesk Sell 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": {
        "zendesk-sell-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

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

Call `list_sales_deals` through your agent. This gives you a list of all open deals, and because the response is validated by Pydantic models, you can trust every field you see.

It manages leads, contacts, and deals. The server exposes methods to create new records (`create_sales_deal`) as well as read/write existing ones.

You use `list_sales_contacts`. This returns the roster of contacts, ensuring that every field—like name and email—conforms to the expected data structure.

Use `get_sales_contact_details` and provide the ID. The agent validates this response against your defined models, so you never get bad data.

You must specify both the deal name and a valid `contact_id`. The tool requires this pairing to ensure the opportunity is correctly associated with an existing person or organization.

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