How to Use the Dwolla MCP in OpenAI Agents SDK

Q: How does the MCP Server handle HAL links?

The MCP Server translates Dwolla's complex HAL links into clean JSON schemas that your agent can easily parse. This removes the need for your python code to manually map link relations when calling initiatetransfer.

Secure automated bank transfers with OpenAI Agents SDK using Dwolla-backed actions on our managed infrastructure.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Dwolla MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run secure ACH onboarding via OpenAI Agents SDK

The `create_customer` and `initiate_kba` tools register new users and kick off identity verification directly from your python scripts. The platform handles the underlying Dwolla endpoints so your agent can verify identities and manage compliance profiles without manual intervention. If things get tricky, the agent passes the session to a human-in-the-loop or triggers `verify_kba` to resolve outstanding identity questions. You get strict runtime safety constraints that prevent unauthorized calls to your bank rails.

Execute transfers with built-in guardrails

The `initiate_transfer` tool moves money between bank accounts while OpenAI's safety guardrails prevent double-spend errors. Because Dwolla requires HAL _links in the payload, this MCP server parses the response schemas so your python agents do not break on raw JSON payloads. In case a transfer is flagged by your risk systems, the agent immediately calls `cancel_transfer` to halt the payment. You track the entire execution history directly inside your OpenAI developer dashboard for easy auditing.

Track ACH events and handle webhook retries

The `list_events` and `retry_webhook` tools track asynchronous ACH settlements and handle failed callbacks. The agent monitors the network state and automatically retries failed hooks when network drops occur. This setup means your python agents can react to real-time payment states without you writing complex polling logic. It turns raw Dwolla webhooks into actionable agent handoffs.

Setup guide

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

Create your Agent

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

Run the agent

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

Token management is fully offloaded to our managed infrastructure, meaning your OpenAI Agents SDK configuration only needs a single endpoint token. You do not have to write custom token refresh logic inside your python code because our hosting layers handle the Dwolla OAuth handshakes.

Yes, you can control tool visibility using the agent constructor parameters to prevent unauthorized financial actions. This ensures your python agents only expose safe tools like `get_transfer` instead of high-risk actions like `initiate_mass_payment`.

Your agent will catch the error, read the event details using `get_event`, and can be programmed to call `retry_webhook` if needed. The runtime trace shows you exactly which step of the ACH transfer failed inside your OpenAI dashboard.

The MCP Server translates Dwolla's complex HAL _links into clean JSON schemas that your agent can easily parse. This removes the need for your python code to manually map link relations when calling `initiate_transfer`.

Yes, all customer PII, bank account numbers, and routing details pass through our secure sandbox. We do not store your private credentials or customer financial records; they are sent directly to Dwolla's API via transient, encrypted connections.

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