How to Use the Mambu MCP in OpenAI Agents SDK

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

Install openai-agents and initialize MCPServerStreamableHttp with your Mambu MCP endpoint. Pass that server object in the mcpservers list when constructing your agent.

Q: Does the OpenAI Agents SDK allow Mambu account creation?

No. The available tools only read data, like getloanaccount and listdepositaccounts. You cannot write new accounts or modify balances through this MCP connection.

Connect this MCP Server to your production agents using the OpenAI Agents SDK for secure, traceable banking operations.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mambu MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Core banking operations via OpenAI Agents SDK

The `get_client` and `list_clients` tools let your OpenAI agents pull direct customer profiles from Mambu. You pass the client ID, and the agent retrieves the exact demographic and status data needed for underwriting or support routing. You can also manage operational workflows using `get_task` and `list_tasks`. Because you are using OpenAI's framework, you can set strict guardrails that validate task assignment logic before the agent executes anything in production.

Read loan and deposit states

The `get_loan_account` and `get_deposit_account` tools expose specific account balances and accrued interest directly to your agent. When a customer asks for their payoff amount, the agent pulls the real-time state from Mambu instead of guessing. For broader portfolio analysis, `list_loan_accounts` and `list_deposit_accounts` return paginated sets of active accounts. You can configure handoffs between specialized agents—one agent pulls the loan list, and another analyzes the risk profile.

Audit trails and transaction histories

The `list_transactions` tool fetches the raw ledger entries for any account. Your agent reads the exact posting dates, amounts, and transaction types directly from the core banking system. To see customer interactions, `list_activities` and `list_communications` pull the historical log. The OpenAI dashboard traces every single API call your agent makes to these MCP endpoints, giving you full visibility into what data was touched.

Setup guide

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

Create your Agent

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

Run the agent

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

Install `openai-agents` and initialize `MCPServerStreamableHttp` with your Mambu MCP endpoint. Pass that server object in the `mcp_servers` list when constructing your agent.

No. The available tools only read data, like `get_loan_account` and `list_deposit_accounts`. You cannot write new accounts or modify balances through this MCP connection.

Tools are auto-discovered. When you connect the server, the SDK automatically registers `list_transactions` and the other endpoints. Set `cacheToolsList=True` to speed up initialization.

The agent paginates through the results. If a customer has thousands of records, the agent calls `list_transactions` repeatedly until it hits the required timeframe.

The server processes highly sensitive client profiles, loan balances, and transaction histories. The V8 Isolate Sandbox destroys the execution environment immediately after the request finishes, leaving zero residual data behind.

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