How to Use the 1msg.io MCP in LangChain

Q: How do I build a LangChain agent that uses 1msg.io?

You'll use the langchain-mcp-adapters library to connect. Once the client is configured with your Vinkius endpoint, you call client.gettools() and pass the resulting list directly into your agent definition. The agent will then know how to call the 1msg.io tools.

Q: What's the best way for a LangChain agent to send files with 1msg.io?

Your agent should use the sendfile tool. It can be chained with other tools that find or generate the file. For instance, one part of your chain could create a PDF invoice, and the next step would pass that file to sendfile for delivery on WhatsApp.

Q: How should my LangChain app handle templates from 1msg.io?

A good pattern is to have the agent use listtemplates to see what's available and pre-approved. Then, based on the user's request, it can choose the correct template and populate it using the sendtemplate tool.

Build autonomous WhatsApp agents with LangChain. Chain 1msg.io tools to send messages, check status, and manage templates automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect 1msg.io MCP to LangChain

Create your Vinkius account to connect 1msg.io 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 1msg.io with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Agents That Reason

This isn't just about calling an API. Your LangChain agent can now make decisions about how to use WhatsApp. It can check available templates with `list_templates`, decide if a standard `send_message` is enough, or escalate to sending a file with `send_file`. This MCP server gives your agent the building blocks for complex logic. For example, an agent can try to send a message, check the channel status with `get_status` if it fails, and then notify a human operator. That's a complete, automated workflow, not just a single API call.

Automate Customer Interactions

Hook this up to a customer service chain. When a user asks a question, your agent can first search a knowledge base, then use `send_message` to reply on WhatsApp. If the user asks for a receipt, the agent can find the PDF and send it using `send_file`. You can build chains that manage entire conversations. The agent can pull recent chat history with `list_messages` to get context before responding. It's about giving the agent the same tools a human support person would have on their screen.

Connect LangChain to WhatsApp Business

This MCP server connects your LangChain app to the official WhatsApp Business API. You get all the tools needed for real automation, packaged for agent use. The setup is straightforward: get your tools and pass them to your agent executor. Because it's an MCP server, you don't mess with OAuth or complex auth flows. You get one endpoint and a token. LangSmith will show you every call to the 1msg.io tools, including latency and the exact data sent, so you can debug your chains quickly.

Setup guide

Set up 1msg.io 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 1msg.io 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({
    "1msgio-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 1msg.io 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 1msg.io. 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 1msg.io 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 1msg.io MCP in LangChain

You'll use the `langchain-mcp-adapters` library to connect. Once the client is configured with your Vinkius endpoint, you call `client.get_tools()` and pass the resulting list directly into your agent definition. The agent will then know how to call the 1msg.io tools.

Yes. Every tool call your agent makes to the 1msg.io MCP server shows up in LangSmith. You'll see the inputs, outputs, and latency for each operation, which makes debugging your agent's reasoning much easier.

Your agent should use the `send_file` tool. It can be chained with other tools that find or generate the file. For instance, one part of your chain could create a PDF invoice, and the next step would pass that file to `send_file` for delivery on WhatsApp.

A good pattern is to have the agent use `list_templates` to see what's available and pre-approved. Then, based on the user's request, it can choose the correct template and populate it using the `send_template` tool.

The server only handles the data required for a specific tool, like message content and phone numbers. Vinkius runs each MCP server in an ephemeral sandbox. Your data is processed for the transaction and then gone; it's never stored on the server.

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