How to Use the DROPBOY MCP in OpenAI Agents SDK

Q: How do I configure auto-discovery for DROPBOY tools in the OpenAI Agents SDK?

Instantiate the MCPServerStreamableHttp class with your Vinkius endpoint. Pass this server object inside the mcpservers list when initializing your Agent. The SDK automatically registers all ten logistics tools via MCP.

Q: What happens if a driver profile lookup fails?

The getdriverprofile tool returns a clear error payload if a driver ID is missing. Your agent catches this error, logs it to the OpenAI dashboard, and can fallback to listfleetdrivers to verify the ID.

Deploy autonomous OpenAI Agents SDK systems that query driver logs and dispatch orders using real-time DROPBOY logistics data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect DROPBOY MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate driver dispatching with OpenAI Agents SDK guardrails

The `list_fleet_drivers` tool exposes your driver roster directly to your OpenAI Agents SDK runtime using this MCP Server. Your agent instantly pulls real-time availability and maps routes based on driver history using `get_driver_profile`. Built-in safety constraints validate every dispatch decision before execution. If an agent tries to assign an overloaded route, the SDK blocks the call, preventing driver fatigue and compliance issues.

Coordinate multi-agent handoffs for order issues

The `get_order_details` tool feeds real-time status updates directly into your multi-agent system. When a delivery delay occurs, a specialized triage agent pulls the order history using `list_latest_logistics_orders` to assess the damage. The triage agent then hands off the ticket to a resolution agent with the exact payload. No manual copy-pasting is required because the shared context stays intact across the entire OpenAI Agents SDK execution graph.

Audit fleet status using OpenAI tracing

The `quick_fleet_status_audit` tool gives your agent an instant breakdown of vehicle readiness through our MCP connection. You track these calls directly inside your OpenAI dashboard, seeing exactly how the agent parses vehicle availability. If a vehicle goes offline, the agent queries `list_fleet_vehicles` to find a replacement. Every step of this recovery loop is fully logged, giving you a clear audit trail of your automated fleet operations.

Setup guide

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

Create your Agent

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

Run the agent

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

Instantiate the `MCPServerStreamableHttp` class with your Vinkius endpoint. Pass this server object inside the `mcp_servers` list when initializing your Agent. The SDK automatically registers all ten logistics tools via MCP.

Yes, you can filter the allowed tools during server setup. This prevents the SDK from exposing administrative tools like `get_dropboy_account_metadata` to customer-facing agents. You control access at the connection layer.

The SDK relies on the underlying HTTP transport to handle standard rate limit headers. Setting `cacheToolsList=True` during initialization reduces handshake overhead. This keeps your logistics queries fast and prevents API throttling.

The `get_driver_profile` tool returns a clear error payload if a driver ID is missing. Your agent catches this error, logs it to the OpenAI dashboard, and can fallback to `list_fleet_drivers` to verify the ID.

All driver profiles and delivery coordinates are processed in an ephemeral V8 Isolate sandbox. Vinkius handles the authorization token securely, ensuring your raw logistics data never persists outside your active MCP session.

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