How to Use the Route4Me MCP in OpenAI Agents SDK

Q: How do I connect the Route4Me MCP Server to the OpenAI Agents SDK?

Install the SDK, then initialize MCPServerStreamableHttp pointing to your Vinkius endpoint. Pass this server instance in the mcpservers list when instantiating your agent.

Q: Can OpenAI Agents SDK automatically update Route4Me address entries?

Yes, the agent uses updateaddress to modify coordinates or contact names. The SDK's built-in guardrails ensure the agent validates the address format before calling the tool.

Q: How does Route4Me handle MCP tool discovery in OpenAI Agents SDK?

The SDK auto-discovers all ten tools like getoptimizations and getvehicles at runtime. Enable cacheToolsList=True to speed up subsequent agent initializations.

Q: Can I limit which drivers my agent can see?

The getusers tool returns all associated users in your account. You must write system instructions in your OpenAI agent to filter specific driver profiles.

Deploy production-grade logistics agents with OpenAI Agents SDK and the Route4Me MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Route4Me MCP to OpenAI Agents SDK

Create your Vinkius account to connect Route4Me to OpenAI Agents SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Route4Me with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Sync Address Books Safely

`get_addresses` pulls your entire delivery database into your agent's context window. Your agent runs these locations against your active orders, then uses `create_address` or `update_address` to fix typos or outdated drop-off coordinates before dispatch. The OpenAI Agents SDK handles these actions with built-in validation guardrails. You define the exact schema constraints, and the SDK stops bad coordinates from ever hitting the Route4Me API.

Auto-Discover Routes with OpenAI Agents SDK

`get_routes` exposes your active fleet paths directly to your agent system. The agent inspects driver schedules, retrieves live coordinates, and uses `get_route` to isolate delays on specific streets. Because OpenAI Agents SDK uses auto-discovery, you do not write manual tool schemas. Just stream the connection, and the agent instantly knows how to query optimization histories using `get_optimizations`.

Coordinate Drivers and Vehicles via MCP Server

`get_vehicles` and `get_users` map your active drivers to their registered trucks. Your agent reads this fleet list to assign incoming emergency pickups to the closest vehicle. Handoffs between specialized agents keep this process clean. One agent monitors the fleet, while another updates the database with `update_address` when a customer changes their delivery window.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the SDK, then initialize `MCPServerStreamableHttp` pointing to your Vinkius endpoint. Pass this server instance in the `mcp_servers` list when instantiating your agent.

Yes, the agent uses `update_address` to modify coordinates or contact names. The SDK's built-in guardrails ensure the agent validates the address format before calling the tool.

The SDK auto-discovers all ten tools like `get_optimizations` and `get_vehicles` at runtime. Enable `cacheToolsList=True` to speed up subsequent agent initializations.

The `get_users` tool returns all associated users in your account. You must write system instructions in your OpenAI agent to filter specific driver profiles.

Your coordinate payloads, route paths, and vehicle IDs pass through the Vinkius V8 sandbox directly to Route4Me. OpenAI Agents SDK traces these tool calls on your private dashboard, keeping your operational data isolated from public training sets.

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