How to Use the Click2Mail MCP in OpenAI Agents SDK

Build production agents that manage physical mail with the OpenAI Agents SDK. Get quotes, send mail, and track jobs automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Click2Mail MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Mailings from Quote to Delivery

This isn't just about sending a letter. Your agent can run the whole process. It starts by getting a price with `get_mail_job_cost`. Once approved, it uses `submit_mail_job` to send it to production. You don't have to worry about mistakes—the SDK's guardrails can require human approval before any real money is spent. After submission, your agent doesn't go dark. It can periodically check on the job's status using `get_mail_job_details`. You get a full, traceable history of every action right in your OpenAI dashboard, so you always know what your agent did and why.

Manage Your Account with Your OpenAI Agent

Keep your Click2Mail account in check without logging into another website. Your agent can use `get_mail_credit_balance` to monitor your funds and alert you when it's time to top up. No more surprise failures because you ran out of credit. For auditing, the `get_mail_account_history` tool gives your agent a full transaction log. Combine that with the OpenAI dashboard's tracing, and you have a bulletproof record of every mailing and every dollar spent. It's perfect for building financial controls directly into your agent.

Connect a Safe, Reliable MCP Server

Before your agent can build a mail job, it needs to know what it's working with. It can call `list_mail_address_lists` and `list_mail_documents` to see exactly what assets are available in your Click2Mail account. This is a core part of building a reliable system. If a required document is missing, a well-built agent can flag it instead of just failing. The tools provided by this MCP Server give your agent the context it needs to make smart decisions, not just follow a rigid script. It’s how you build agents that can handle real-world problems.

Setup guide

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

Create your Agent

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

Run the agent

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

It exposes Click2Mail's functions as tools your agent can call directly. The OpenAI Agents SDK automatically discovers these tools, so you can ask your agent to `get_mail_job_cost` or `submit_mail_job` using natural language.

Yes. The OpenAI Agents SDK has built-in guardrails. You can configure it to require human-in-the-loop approval before executing sensitive tools like `submit_mail_job`, which prevents any unintended spending.

It's straightforward. After installing the SDK, you instantiate an `MCPServerStreamableHttp` with your Vinkius endpoint URL. Pass that server instance to your Agent constructor, and the tools are ready to go.

Absolutely. The OpenAI framework is designed for handoffs between specialized agents. You could have one agent that monitors finances using `get_mail_credit_balance` and another that handles the actual mailing with `submit_mail_job`.

The server only touches data needed to perform its job: your mail job history, address lists, documents, and account balance. All connections are secured, and Vinkius runs each MCP server in an ephemeral, zero-trust sandbox for your protection.

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