How to Use the HelpCrunch MCP in OpenAI Agents SDK

Q: Can the OpenAI Agents SDK read old HelpCrunch chats?

Yes. The agent calls listmessagesinchat to pull the entire transcript. This gives the model full historical context before generating a reply.

Wire HelpCrunch into your OpenAI Agents SDK deployments for automated, production-grade customer support routing.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HelpCrunch MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

OpenAI Agents SDK routing

The `search_customers` and `get_customer_details` tools give your agent immediate context before it says a single word. You don't want a bot asking for an email address it already has. By calling these endpoints, the agent builds a complete profile of the user based on historical chat data. Once the context is set, the SDK's built-in guardrails take over. Your agent can safely use `send_chat_message` to reply directly, knowing the output was validated against your strict system prompts. If things get too complex, it simply triggers a handoff to a human queue.

Manage chat states

The `update_conversation_status` tool lets your agent close, open, or pause tickets without human intervention. Support queues get messy fast when bots leave resolved chats open. This endpoint forces the agent to clean up after itself. You can also track the exact volume being handled. Using `list_conversations`, the agent pulls the current queue state to determine its own workload. Tracing through the OpenAI dashboard then shows exactly which chats were resolved autonomously versus those requiring escalation.

MCP Server team visibility

The `list_team_agents` and `list_departments` tools map out your human workforce for the AI client. When an angry customer needs a real person, the agent needs to know who is actually available. It queries the active roster and routes the issue accordingly. This prevents dead-end handoffs. Instead of dropping a frustrated buyer into an empty queue, the agent verifies department capacity first. The integration keeps the automated layer tightly synced with the human floor.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the openai-agents package via pip. Initialize MCPServerStreamableHttp with your Vinkius endpoint and pass it to the mcp_servers array in your Agent constructor.

Yes. The agent calls list_messages_in_chat to pull the entire transcript. This gives the model full historical context before generating a reply.

You handle the handoff logic in the SDK itself. One specialized agent can pull data using get_conversation_details, and then hand the context to a routing agent that assigns it to a human.

Rely on the SDK's built-in guardrails. You define strict execution rules for send_chat_message so the agent only fires a response when confidence is high.

The server pulls exact email addresses and chat transcripts through get_customer_details. We run the connection in an ephemeral V8 isolate sandbox, destroying the memory state immediately after the request finishes.

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