How to Use the Filemail MCP in OpenAI Agents SDK

Q: How do I authenticate Filemail in the OpenAI Agents SDK?

You run the login tool first to establish an active session. The SDK handles the session tokens under the hood, allowing subsequent tools like getconfiguration to execute without re-authenticating.

Q: Can an agent track Filemail download status using OpenAI Agents SDK?

Yes, your agent calls gettransferdetails to check if the recipient has accessed the files. This returns exact download counts and timestamps directly to your agent's execution context.

Q: How does OpenAI Agents SDK handle large Filemail uploads?

The agent initiates the process using initializetransfer and finishes it with completetransfer. This two-step process ensures large files upload reliably before the transfer is marked as active.

Q: Can I clean up expired transfers programmatically?

Yes, you can use deletetransfer to remove files from the server. Your agent can run this on a schedule or after a successful download confirmation.

Send terabyte-scale files safely through the OpenAI Agents SDK using verified transfer tools and built-in execution guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Filemail MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Send terabytes via this Filemail MCP Server

The `initialize_transfer` tool starts a secure upload pipeline directly from your OpenAI Agents SDK workflow. This MCP server lets your agent log in with `login` and prepare the Filemail payload. This setup lets your Python scripts handle massive Filemail datasets without manual intervention. You get real-time tracking numbers and status updates back in your OpenAI dashboard.

Track and manage incoming deliveries

The `list_received_transfers` tool pulls your Filemail inbox queue so your OpenAI agent can process incoming payloads. It uses `get_transfer_details` to inspect file sizes and sender details before downloading. If a payload fails validation, this MCP toolset cleans up your Filemail storage immediately. Your OpenAI agent handles the entire lifecycle without leaving its execution loop.

Verify accounts and retrieve configurations

The `get_configuration` tool exposes your custom Filemail branding, upload limits, and active account settings to the OpenAI agent. It relies on `get_user` to verify permissions and active sessions before initiating high-bandwidth operations. You can also query `list_contacts` to find recipient emails on the fly within the OpenAI Agents SDK environment. This prevents typos and ensures sensitive files only go to approved addresses in your Filemail address book.

Setup guide

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

Create your Agent

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

Run the agent

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

You run the `login` tool first to establish an active session. The SDK handles the session tokens under the hood, allowing subsequent tools like `get_configuration` to execute without re-authenticating.

Yes, your agent calls `get_transfer_details` to check if the recipient has accessed the files. This returns exact download counts and timestamps directly to your agent's execution context.

The agent initiates the process using `initialize_transfer` and finishes it with `complete_transfer`. This two-step process ensures large files upload reliably before the transfer is marked as active.

Yes, you can use `delete_transfer` to remove files from the server. Your agent can run this on a schedule or after a successful download confirmation.

Your login credentials and transfer metadata are processed inside an ephemeral V8 sandbox. No data is stored on Vinkius servers, and session tokens are cleared immediately after the execution stream ends.

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