How to Use the HelpCrunch MCP in LangChain

Q: How do I connect LangChain to HelpCrunch?

Use MultiServerMCPClient in your setup script. Pass your MCP server URL and call client.gettools(). Feed those directly into createagent to start building support chains.

Q: Can LangChain read historical HelpCrunch messages?

Yes. Your agent can call listmessagesinchat to pull the entire back-and-forth history. This gives the LLM full context before it attempts to answer a new question.

Q: Can I create new users via LangChain and HelpCrunch?

The createcustomer tool handles this. The agent just needs an email and a name to generate a fresh profile in your database.

Build multi-step support chains in LangChain that read chats, find users, and resolve tickets automatically via MCP.

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 LangChain

Create your Vinkius account to connect HelpCrunch to LangChain 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 LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain customer data lookups

The `search_customers` tool finds specific user profiles right from your LangChain sequence. You pass an email or partial name into the chain, and the agent pulls back the exact record. This means your support bot knows exactly who it is talking to before generating a response. Once the profile is loaded, the chain passes that context to `get_customer_details`. LangSmith tracks exactly how many tokens this lookup costs and how fast the API responds. You get full observability into your support pipelines without writing custom logging hooks.

Automate chat resolutions with this MCP Server

The `update_conversation_status` tool lets your agent close out resolved tickets without human input. After a ReAct agent successfully answers a query, it calls this endpoint to mark the chat as closed or pending. It keeps your queue clean. Your pipeline can also trigger `send_chat_message` to post the final resolution directly to the user. Because LangChain handles the reasoning, the agent decides when a conversation actually warrants closure versus when it needs escalation to a human.

Route tickets to the right department

The `list_departments` tool pulls your entire HelpCrunch organizational structure into the current context window. Your agent looks at an incoming message, figures out if it belongs to billing or technical support, and routes it accordingly. You can combine this with `list_team_agents` to see who is actually available. The framework builds a decision tree based on live staffing data, ensuring high-priority tickets go to active agents instead of dying in an empty queue.

Setup guide

Set up HelpCrunch MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes HelpCrunch tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "helpcrunch-alternative-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent HelpCrunch transactions"
    })
    print(result["messages"][-1].content)

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 LangChain

Use `MultiServerMCPClient` in your setup script. Pass your MCP server URL and call `client.get_tools()`. Feed those directly into `create_agent` to start building support chains.

Yes. Your agent can call `list_messages_in_chat` to pull the entire back-and-forth history. This gives the LLM full context before it attempts to answer a new question.

Every tool call logs automatically. You will see exactly when the agent calls `get_conversation_details` and how long the API takes to reply.

The `create_customer` tool handles this. The agent just needs an email and a name to generate a fresh profile in your database.

Your agent processes direct chat transcripts and email addresses. Vinkius isolates this execution within a V8 sandbox, meaning the token only exists during the active request and disappears immediately after.

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