How to Use the GraphHopper MCP in OpenAI Agents SDK

Q: Can OpenAI Agents SDK handle asynchronous VRP polling via GraphHopper?

Yes. The agent initiates the optimization with submitvrpoptimizer and uses its built-in loop to poll pollvrpsolution until the final coordinates are ready.

Q: How does the agent handle geocoding errors?

If searchgeocode fails to find an address, the agent uses its reasoning loop to correct spelling mistakes or fallback to coordinates.

Run production-grade routing and fleet optimization directly inside OpenAI Agents SDK with this GraphHopper MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GraphHopper MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Solve Complex Fleet Routing with OpenAI Agents SDK

Your autonomous dispatcher agents can now tackle the vehicle routing problem without manual intervention. By invoking `submit_vrp_optimizer`, the agent schedules multi-stop deliveries, manages driver shift limits, and monitors the progress via `poll_vrp_solution` to ensure SLAs are met. The OpenAI dashboard lets you trace these exact tool calls in real time. If a route calculation hits a snag, the agent can gracefully fall back or hand off the task to a specialized supervisor agent.

Heavy Vehicle Routing and Isochrone Mapping

Freight logistics require precise road restrictions, not generic consumer directions. The MCP Server allows your agent to use `calculate_heavy_route` to find legal truck pathways based on height, weight, and emission zones. To map out delivery coverage, the agent triggers `calculate_distance_isochrone` to find how far a vehicle can travel within a 15-minute window. This replaces guess-work with actual spatial polygons.

Raw GPX Snapping and Geocoding

Raw GPS pings from driver phones are notoriously messy. The agent runs `snap_gpx_to_road` to snap drift-heavy coordinates back onto the OpenStreetMap network for clean mileage tracking. When translating coordinates to physical delivery drop-offs, the agent calls `reverse_geocode` to pull verified address details. This ensures the routing matrix calculations are based on actual physical locations.

Setup guide

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

Create your Agent

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

Run the agent

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

Initialize the server using MCPServerStreamableHttp and pass it into your Agent constructor. The SDK automatically discovers the routing tools.

Yes. The agent initiates the optimization with `submit_vrp_optimizer` and uses its built-in loop to poll `poll_vrp_solution` until the final coordinates are ready.

Absolutely. Your agents can pass vehicle dimensions directly to `calculate_heavy_route` to bypass low bridges and weight-restricted roads.

If `search_geocode` fails to find an address, the agent uses its reasoning loop to correct spelling mistakes or fallback to coordinates.

This MCP server processes raw GPS coordinates and delivery addresses within an ephemeral V8 sandbox. No coordinates or routing profiles are stored permanently on Vinkius servers.

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