How to Use the Freshworks MCP in OpenAI Agents SDK

Q: What's the best way to combine Freshworks CRM and helpdesk contacts with the OpenAI Agents SDK?

Have your agent call both listcrmcontacts and listhelpdeskcontacts and then merge the results in your own code. The SDK's structured output makes it simple to process the data from both sources and find matching records.

Q: Is there a performance cost when using the OpenAI Agents SDK with Freshworks?

Not if you configure it correctly. Set cacheToolsList=True in your agent's setup. This caches the tool definitions after the first connection, so subsequent runs are faster.

Build production-ready Freshworks agents with the OpenAI Agents SDK. Connect sales and support data with built-in safety checks.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Freshworks MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Bridge Sales and Support Safely

Give a single agent a complete view of any customer. It can check for open support issues with `list_tickets` before your sales team reaches out about a renewal from `list_deals`. This stops you from pitching angry customers. This isn't just about combining data; it's about controlling it. The OpenAI SDK's built-in guardrails let you review and approve an agent's plan before it executes. You can see its intent to `get_ticket` or `list_accounts` and prevent mistakes before they happen.

Auto-Discover All 9 Tools

The OpenAI Agents SDK finds all the Freshworks tools automatically. There's no manual boilerplate to write. Your agent immediately knows how to `list_accounts`, `list_companies`, and `list_crm_contacts` the moment it connects. This saves a ton of setup time. You just point your agent at the Freshworks MCP server endpoint. It's instantly ready to query agent availability with `list_agents` or check on support group queues using `list_groups`.

Trace Every MCP Server Action

Every call your agent makes to Freshworks is logged in the OpenAI dashboard. You get a full, step-by-step trace when it uses `list_deals` to check a pipeline or `get_ticket` to pull up a specific issue. This isn't just for debugging; it's a clear audit trail. You can see exactly what data was pulled from `list_helpdesk_contacts` and understand why the agent made its next move, which is critical for building trust in your system.

Setup guide

Set up Freshworks 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 Freshworks tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Freshworks 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="Freshworks Agent",
            instructions="You have access to Freshworks 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 Freshworks. 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 Freshworks 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 Freshworks MCP in OpenAI Agents SDK

Vinkius handles it for you. You get a single endpoint token that authenticates your agent with the Freshworks MCP Server, which then manages the underlying API keys securely.

Yes. While the SDK discovers all tools by default, you can define policies and guardrails that restrict the agent to a specific subset. For instance, you could allow access to `list_tickets` but block any tools related to `list_deals`.

Have your agent call both `list_crm_contacts` and `list_helpdesk_contacts` and then merge the results in your own code. The SDK's structured output makes it simple to process the data from both sources and find matching records.

Not if you configure it correctly. Set `cacheToolsList=True` in your agent's setup. This caches the tool definitions after the first connection, so subsequent runs are faster.

Your agent only accesses the data it explicitly requests, like customer contact details or ticket contents. All communication is over a secure, authenticated channel, and the Vinkius server itself is ephemeral, leaving no stored data behind after a request is complete.

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