How to Use the Kylas MCP in OpenAI Agents SDK

Q: How do I connect this MCP Server to OpenAI Agents SDK?

Initialize an MCPServerStreamableHttp instance with your Vinkius URL. Pass it in the mcpservers array when you build your agent. The SDK auto-discovers all seven tools immediately.

Q: Can OpenAI Agents SDK write new leads into Kylas?

Yes. The createlead tool accepts a JSON string payload from your agent. Set cacheToolsList=True to speed up the initial tool discovery phase.

Q: Does Kylas support agent handoffs in OpenAI Agents SDK?

It does. You can have a triage agent read records using listcontacts, then transfer control to a closing agent that updates the CRM. The tools remain available across the entire agent swarm.

Build production-ready sales agents with OpenAI Agents SDK that manage your Indian SMB pipeline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Kylas MCP to OpenAI Agents SDK

Create your Vinkius account to connect Kylas to OpenAI Agents SDK 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 Kylas with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Feed Kylas leads into your MCP Server

The `list_leads` and `get_lead` tools pull your Kylas sales pipeline directly into your OpenAI agent's context window. You pass the search parameters, and the agent retrieves the exact SMB prospect details required for the next interaction. OpenAI's built-in guardrails validate these reads before execution. Your agent checks the data, decides if the lead needs immediate attention, and logs the entire trace in your OpenAI dashboard.

Write contacts and tasks safely

The `create_contact` and `list_tasks` tools let your Python application write directly to your CRM. Your agent parses incoming WhatsApp transcripts, extracts the prospect's name, and creates the contact record. You control the handoff between agents here. A specialized triage agent handles the creation step, then passes the ID to a scheduling agent that queues up the follow-up task. No manual data entry required.

Track deals via OpenAI Agents SDK

The `list_deals` tool exposes your active sales pipeline to your Python scripts. When a sales manager asks for a status update, your agent queries the endpoint and returns the exact deal stages. This MCP Server handles the authentication layer at Vinkius. You just provide the endpoint token, and your production agent interacts with the CRM without exposing underlying API keys.

Setup guide

Set up Kylas MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Kylas tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Kylas tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Kylas tools and returns structured results. Copy the full example on the right to get started.

agent.py

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

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Kylas Agent",
            instructions="You have access to Kylas tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 Kylas. 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 Kylas 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 Kylas MCP in OpenAI Agents SDK

Initialize an `MCPServerStreamableHttp` instance with your Vinkius URL. Pass it in the `mcp_servers` array when you build your agent. The SDK auto-discovers all seven tools immediately.

Yes. The `create_lead` tool accepts a JSON string payload from your agent. Set `cacheToolsList=True` to speed up the initial tool discovery phase.

It does. You can have a triage agent read records using `list_contacts`, then transfer control to a closing agent that updates the CRM. The tools remain available across the entire agent swarm.

OpenAI's dashboard traces every tool call automatically. When your agent executes `list_tasks`, you see the exact payload sent to the Vinkius endpoint and the response returned.

Your Indian SMB sales leads and contact phone numbers stay isolated. Vinkius runs this connection inside an ephemeral V8 sandbox. Once the HTTP session ends, the environment dies completely.

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