Can my AI calculate the total toll costs for a road trip from New York to Boston?

Yes! Use the `calculate_toll_route` tool with origin="New York, NY" and destination="Boston, MA". You can specify your vehicle type (2AxlesAuto for regular cars, 2AxlesEV for electric vehicles, or truck types like 5AxlesTruck for commercial vehicles). The API returns detailed toll plaza names, tag and cash costs for each plaza, total toll cost, fuel cost estimate, and optional driver cost. You can also request costs in different currencies and compare payment methods (tag vs cash vs prepaid card

How do I get toll costs for a route I already have from Google Maps?

Use the `calculate_toll_from_polyline` tool with the encoded polyline from Google Maps. Set source="google" and paste the polyline string. This calculates tolls for your exact route without re-routing. You can also specify vehicle type and currency. This is perfect when you have an existing route and need toll costs for trip budgeting or fleet expense tracking.

Can I optimize a multi-stop delivery route to minimize toll costs?

Absolutely! Use the `calculate_toll_multi_stop` tool with your origin, destination, and comma-separated waypoints. Set optimize_waypoints="true" to let TollGuru find the most cost-effective waypoint order. The API returns the optimized route with total toll costs, fuel costs, and detailed plaza-by-plaza breakdown. This is essential for logistics planning, delivery route optimization, and fleet cost management.

TollGuru MCP Server for OpenAI Agents SDK 3 tools — connect in under 2 minutes

Name: TollGuru
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 3 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect TollGuru through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="TollGuru Assistant",
            instructions=(
                "You help users interact with TollGuru. "
                "You have access to 3 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from TollGuru"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About TollGuru MCP Server

Connect your TollGuru toll calculation API to any AI agent and take full control of trip cost estimation, toll plaza tracking, route optimization, and fleet expense management across 50+ countries through natural conversation.

The OpenAI Agents SDK auto-discovers all 3 tools from TollGuru through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries TollGuru, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

What you can do

Toll Calculation — Calculate toll costs for any route with detailed plaza-by-plaza breakdown including tag and cash prices
Fuel Cost Estimation — Get fuel cost estimates based on vehicle efficiency and current fuel prices along the route
Driver Cost Analysis — Calculate driver costs based on hourly wage or time value for complete trip budgeting
Multi-Stop Routes — Calculate tolls for routes with multiple waypoints and optimize waypoint order to minimize tolls
Route Optimization — Find the most cost-effective route between origin and destination with toll-aware routing
Polyline Toll Calculation — Calculate tolls for existing routes from Google Maps, Here Maps, or Mapbox polylines
Vehicle-Specific Pricing — Get accurate toll costs for any vehicle type from 2-axle cars to 9-axle commercial trucks
Multi-Currency Support — View costs in USD, CAD, MXN, EUR, GBP, INR, AUD, and 12+ other currencies
Payment Method Breakdown — Compare toll costs by payment method (tag, cash, prepaid card, license plate)
Global Coverage — Calculate tolls across US, Canada, Mexico, Europe, Australia, India, and 50+ countries

The TollGuru MCP Server exposes 3 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect TollGuru to OpenAI Agents SDK via MCP

Follow these steps to integrate the TollGuru MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 3 tools from TollGuru

Why Use OpenAI Agents SDK with the TollGuru MCP Server

OpenAI Agents SDK provides unique advantages when paired with TollGuru through the Model Context Protocol.

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

TollGuru + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the TollGuru MCP Server delivers measurable value.

Automated workflows: build agents that query TollGuru, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents. one queries TollGuru, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through TollGuru tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query TollGuru to resolve tickets, look up records, and update statuses without human intervention

TollGuru MCP Tools for OpenAI Agents SDK (3)

These 3 tools become available when you connect TollGuru to OpenAI Agents SDK via MCP:

calculate_toll_from_polyline

This is useful when you already have a route from a mapping service and need toll calculations without re-routing. Returns the same detailed toll, fuel, and cost information as the route calculation. Supports all vehicle types, currencies, and payment methods. Essential for integrating with existing mapping applications, post-trip toll reconciliation, and GPS track-based toll analysis. AI agents should use this when users have an existing route polyline from Google Maps, Here Maps, or another service and need toll costs for that specific route. Calculate tolls for a route defined by an encoded polyline from any mapping service

calculate_toll_multi_stop

Returns detailed breakdown of tolls at each plaza along the complete route, fuel costs, and optional driver costs. Supports waypoint optimization to minimize total toll costs. Essential for delivery route planning, multi-stop trip budgeting, and logistics optimization. AI agents should use this when users need toll calculations for routes with multiple stops, such as "calculate tolls from Chicago to Detroit with stops in Toledo and Ann Arbor" or "what are the toll costs for my delivery route with 5 waypoints". Calculate tolls for a multi-stop route with multiple waypoints

calculate_toll_route

Returns detailed toll plaza information including plaza names, tag and cash costs, payment methods accepted, and route optimization suggestions. Also calculates fuel costs based on vehicle efficiency and current fuel prices, and optional driver costs based on time value. Supports all vehicle types including 2-axle cars, EVs, motorcycles, and commercial trucks (2-9+ axles). You can request route optimization to minimize toll costs, specify currency output (USD, CAD, MXN, EUR, GBP, INR, AUD, etc.), and choose mapping service (Here Maps, Google Maps, or TollGuru internal). Essential for fleet management, trip cost estimation, route planning, toll reconciliation, and travel budgeting. AI agents should use this when users ask "what are the tolls from New York to Boston", "calculate toll costs for my truck from LA to San Francisco", or need comprehensive trip cost breakdowns including tolls, fuel, and driver time. Calculate tolls and total trip costs for a route with origin, destination, and optional waypoints

Example Prompts for TollGuru in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with TollGuru immediately.

"Calculate toll costs for a car trip from San Francisco to Los Angeles."

"What are the toll costs for a 5-axle truck from Chicago to Detroit?"

"Optimize a delivery route with stops in Philadelphia, Baltimore, and Washington DC starting from New York."

Troubleshooting TollGuru MCP Server with OpenAI Agents SDK

Common issues when connecting TollGuru to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

TollGuru + OpenAI Agents SDK FAQ

Common questions about integrating TollGuru MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.