What is the difference between a Lead and a Contact in Zendesk Sell?

Leads represent potential interest but are not yet qualified. Contacts are qualified individuals or organizations that can be associated with sales deals.

Can I associate a deal with a contact via the agent?

Yes, when using the `create_sales_deal` tool, you must provide a `contact_id` to link the new opportunity to an existing person or company.

How do I update the status of an existing deal?

Use the `update_existing_deal` tool with the unique deal ID and a JSON object containing the new status (e.g., 'Won', 'Lost', or a specific pipeline stage).

Zendesk Sell MCP Server for OpenAI Agents SDK 11 tools — connect in under 2 minutes

Name: Zendesk Sell
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 11 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Zendesk Sell through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="Zendesk Sell Assistant",
            instructions=(
                "You help users interact with Zendesk Sell. "
                "You have access to 11 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from Zendesk Sell"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Zendesk Sell MCP Server

Connect your Zendesk Sell (formerly Base CRM) account to any AI agent to automate your sales pipeline and customer management. This MCP server enables your agent to interact with leads, qualified contacts, and sales deals directly from natural language interfaces.

The OpenAI Agents SDK auto-discovers all 11 tools from Zendesk Sell through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Zendesk Sell, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

What you can do

Lead Management — List, retrieve, and create sales leads to capture potential customer interest
Contact Oversight — Manage qualified people and organizations, and retrieve their complete metadata profiles
Deal Tracking — Monitor sales opportunities, update their status, and manage the entire deal lifecycle
Pipeline Automation — Create and update sales records directly from your conversation to keep your CRM accurate
CRM Cleanup — Delete unnecessary leads, contacts, or deals via simple natural language commands

The Zendesk Sell MCP Server exposes 11 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Zendesk Sell to OpenAI Agents SDK via MCP

Follow these steps to integrate the Zendesk Sell MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 11 tools from Zendesk Sell

Why Use OpenAI Agents SDK with the Zendesk Sell MCP Server

OpenAI Agents SDK provides unique advantages when paired with Zendesk Sell through the Model Context Protocol.

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

Zendesk Sell + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the Zendesk Sell MCP Server delivers measurable value.

Automated workflows: build agents that query Zendesk Sell, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents. one queries Zendesk Sell, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through Zendesk Sell tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query Zendesk Sell to resolve tickets, look up records, and update statuses without human intervention

Zendesk Sell MCP Tools for OpenAI Agents SDK (11)

These 11 tools become available when you connect Zendesk Sell to OpenAI Agents SDK via MCP:

create_new_lead

Requires last_name or organization_name. Create a new sales lead

create_sales_contact

Requires a JSON body with contact details. Create a new person or organization contact

create_sales_deal

Requires deal name and contact_id. Create a new sales opportunity (deal)

delete_sales_deal

Remove a deal from the account

get_deal_details

Get details for a specific sales deal

get_lead_details

Get details for a specific lead

get_sales_contact_details

Get details for a specific contact

list_sales_contacts

List all sales contacts (qualified prospects)

list_sales_deals

List all sales deals (opportunities)

list_sales_leads

List all sales leads

update_existing_deal

Update details for an existing deal

Example Prompts for Zendesk Sell in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Zendesk Sell immediately.

"List all active sales leads in my Zendesk Sell account."

"Create a new deal named 'Enterprise License' for contact ID '98765'."

"Update the status of deal '54321' to 'Won'."

Troubleshooting Zendesk Sell MCP Server with OpenAI Agents SDK

Common issues when connecting Zendesk Sell to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

Zendesk Sell + OpenAI Agents SDK FAQ

Common questions about integrating Zendesk Sell MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.