How to Use the TollGuru MCP in OpenAI Agents SDK

Q: How does TollGuru work with OpenAI Agents SDK?

The MCP Server provides three core tools: calculatetollfrompolyline, calculatetollmultistop, and calculatetollroute. Your agent automatically discovers these operations, letting you build complex trip cost logic without writing extra wrapper code.

Q: Does TollGuru handle optimization for multi-stop routes using OpenAI Agents SDK?

Yes, calculatetollmultistop helps minimize total toll costs. You give it a list of waypoints, and the tool calculates the optimized sequence to keep your trip budget tight.

Get accurate trip costs for your production agents using OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect TollGuru MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Calculate tolls with the MCP Server

Need to calculate tolls when you already have a route polyline? Use `calculate_toll_from_polyline` to get detailed toll, fuel, and cost info. This works whether your agent is integrating with existing mapping apps or running post-trip reconciliation. It supports every vehicle type and currency, so it handles the logistics for GPS track analysis right out of the gate.

Multi-stop route budgeting

`calculate_toll_multi_stop` breaks down tolls at every plaza along a full route. You get detailed figures on fuel costs and even optional driver labor time. It’s perfect for delivery planning or multi-stage trips. The tool also helps optimize your waypoints to keep the total toll cost as low as possible.

Full trip cost estimation

`calculate_toll_route` gets you a full breakdown of costs from an origin to a destination, including optional waypoints. It shows plaza names, tag vs. cash costs, and what payment methods are accepted. Beyond tolls, it calculates fuel based on vehicle efficiency and current prices. You can even ask your agent to optimize the route to cut down overall expenses.

Setup guide

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

Create your Agent

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

Run the agent

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

The MCP Server provides three core tools: `calculate_toll_from_polyline`, `calculate_toll_multi_stop`, and `calculate_toll_route`. Your agent automatically discovers these operations, letting you build complex trip cost logic without writing extra wrapper code.

The server handles all major vehicles. That means 2-axle cars, motorcycles, EVs, and massive commercial trucks (up to 9+ axles). It accounts for specific needs like fuel efficiency across different types.

Yeah, it can. The server supports route calculations across over 50 countries. You specify the currency you want (like CAD or GBP), and the MCP Server returns costs in that local format.

Yes, `calculate_toll_multi_stop` helps minimize total toll costs. You give it a list of waypoints, and the tool calculates the optimized sequence to keep your trip budget tight.

The server deals with payment methods for tolls. It gives details on whether plazas accept tags or cash, which is crucial for reconciling costs post-trip.

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