How to Use the Gelato MCP in OpenAI Agents SDK

Q: Can my OpenAI Agents SDK agent verify shipping costs before placing a print job?

Yes, your agent can call getshippingquote to fetch real-time carrier pricing. It then uses OpenAI's native tool validation to confirm the price fits within your business rules before executing createprintorder.

Run production-grade print-on-demand agents with OpenAI Agents SDK and our Gelato MCP Server to prevent runaway costs.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gelato MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Secure Gelato MCP Server orders with OpenAI guardrails

Connecting print-on-demand tools like `create_print_order` directly to your OpenAI Agents SDK is simple with this Gelato MCP Server. Runaway agents can empty your bank account if they start ordering random test prints, but this setup enforces strict runtime policies. Your OpenAI Agents SDK agent checks the catalog using `list_catalog_products` and gets live pricing via `get_shipping_quote`. The SDK ensures that these print values match your budget limits before allowing the final print job to submit.

Let specialized OpenAI agents manage fulfillment

Managing catalogs becomes straightforward when this Gelato MCP Server exposes tools like `list_product_catalogs` to your OpenAI Agents SDK. You do not want one monolithic prompt handling both sales catalog navigation and shipping exceptions, so the SDK lets you hand off tasks between specialized print agents. The logistics agent uses `get_order_shipments` and `get_order_status` to track packages. If a customer wants to cancel a print job, the agent hands the task to a cancellation specialist to run `cancel_print_order` within the OpenAI dashboard.

Trace every Gelato API call in your OpenAI dashboard

Fulfillment data flows directly to your OpenAI Agents SDK when this Gelato MCP Server maps tools like `get_product_details` to your workflow. Debugging agent failures in production is a nightmare when you cannot see which print tool failed or why. If `verify_api_connection` fails during a cold start, you will spot the network bottleneck inside your OpenAI tracing logs. You get complete visibility into how your agent queries catalogs and fetches shipping quotes.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the SDK and initialize the server streamable HTTP class with your Vinkius endpoint. Register this server directly in your agent's constructor to expose print tools automatically.

Yes, your agent can call `get_shipping_quote` to fetch real-time carrier pricing. It then uses OpenAI's native tool validation to confirm the price fits within your business rules before executing `create_print_order`.

You can set up a specialized customer service agent that monitors order issues. When a cancellation request comes in, the agent invokes `cancel_print_order` directly, and you can trace the entire transaction in your OpenAI portal.

You can restrict the agent's scope by configuring its system instructions. When it calls `list_product_catalogs`, it will only process the specific catalog IDs you permit in its runtime context.

Your customer addresses and order details are transmitted securely through the Vinkius zero-trust sandbox. No personal data is stored on our servers, and all API calls to Gelato's fulfillment network are encrypted in transit.

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