How to Use the Gallabox MCP in OpenAI Agents SDK

Q: How do I connect Gallabox to the OpenAI Agents SDK?

Install openai-agents via pip. Create an MCPServerStreamableHttp instance pointing to your Vinkius endpoint and pass it in the mcpservers list when initializing your Agent. Set cacheToolsList=True to speed up initialization.

Q: Does this MCP Server support multiple WhatsApp channels?

The listwhatsappchannels tool returns every active number tied to your account. Your agent can specify which channel to use when dispatching replies.

Connect Gallabox to your OpenAI Agents SDK system to handle WhatsApp messaging safely in production.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gallabox MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate WhatsApp with OpenAI Agents SDK

Your agent uses `send_whatsapp_text` and `send_whatsapp_template` to push messages out to users. Instead of writing custom API wrappers, the SDK automatically discovers these endpoints. You just pass the MCP Server to the Agent constructor. You can build specialized agents for different tasks. A triage agent might pull history using `list_thread_messages` and then hand off the conversation to a specialized support agent. The OpenAI dashboard traces every single tool call.

Read thread histories and contacts

The `list_active_chats` tool pulls down current conversations so your agent knows who needs attention. It grabs metadata via `get_contact_details` to build context before deciding how to reply. Because you are running a production system, you want to limit hallucinated context. Feeding exact chat logs from `get_chat_details` directly into the context window ensures the agent responds based on facts.

Verify connections and route to teams

You can run `verify_api_connection` as a health check before executing complex multi-step workflows. If the connection drops, your code catches it early instead of failing halfway through a customer interaction. When a conversation requires human intervention, the agent pulls available groups using `list_support_teams`. It stops the automated loop and assigns the thread to a real person.

Setup guide

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

Create your Agent

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

Run the agent

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

Install `openai-agents` via pip. Create an `MCPServerStreamableHttp` instance pointing to your Vinkius endpoint and pass it in the `mcp_servers` list when initializing your Agent. Set `cacheToolsList=True` to speed up initialization.

Yes. The SDK discovers tools without manual configuration. Your agent can call `list_message_templates` to see which pre-approved WhatsApp formats are available before sending one.

The SDK's built-in guardrails catch the error. You can define fallback behaviors or hand off the task to a human agent, while tracking the exact failure in the OpenAI tracing dashboard.

The `list_whatsapp_channels` tool returns every active number tied to your account. Your agent can specify which channel to use when dispatching replies.

This server processes direct WhatsApp chat logs, phone numbers, and contact names. Vinkius runs the connection inside a zero-trust V8 Isolate Sandbox. The environment is ephemeral, meaning your customer data passes through memory and disappears the moment the API call 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