How to Use the Navisphere MCP in Google ADK

Q: How do I add the Navisphere MCP Server to my Google ADK agent?

Initialize McpToolset with the Vinkius HTTP URL in Python. Pass that toolset to your LlmAgent instance, and your Gemini models will immediately know how to use tools like searchavailableloads.

Q: How does the Navisphere MCP Server handle high-frequency tracking in Google ADK?

Your agent uses gettrackingevents to pull granular location data. Because Google ADK integrates with your existing cloud pipelines, you can feed these events directly into Pub/Sub for real-time dashboard updates.

Q: What tools does my agent use to accept freight offers?

The agent calls acceptoffer to claim a load once it passes your margin criteria. If you need to restrict this action, you can use the ADK's toolnames filter to keep this specific tool restricted to authorized workflows.

Q: Where does my shipment tracking and status data go during processing?

Your location updates from gettrackingevents and status changes from updateshipmentstatus travel through secure, ephemeral V8 isolates. No tracking data or customer shipment details are cached on Vinkius, ensuring your operational privacy remains intact.

Run enterprise logistics inside Google ADK by connecting Gemini directly to live freight boards and tracking data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Navisphere MCP to Google ADK

Create your Vinkius account to connect Navisphere to Google ADK 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 Navisphere with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

High-Volume Freight Search via Gemini

The `search_available_loads` tool searches the active Navisphere freight market for matching shipments based on equipment type and origin. Because Google ADK supports Gemini's 1M+ token context window, your agent can analyze thousands of Navisphere loads at once to find the most profitable lanes. Once the agent identifies a target, it uses `get_load_details` to pull specific load parameters. This allows your enterprise system to cross-reference Navisphere freight options with your historical shipping data stored in BigQuery.

Automated Rate Estimation with MCP Server

Getting pricing feedback is instant when your agent calls the `get_rate_estimate` tool to evaluate Navisphere market-rate averages. Running this MCP Server within Google ADK lets your Gemini models combine real-time Navisphere rates with Vertex AI predictive models. After confirming the target margin, the agent executes `submit_bid` to lock in your offer on the Navisphere load board. You completely bypass manual dispatching by running these bids directly through Google ADK's cloud infrastructure.

Webhook-Driven Freight Tracking

Real-time visibility triggers automatically when your agent runs `subscribe_webhooks` to listen for immediate Navisphere status updates. Google ADK routes these events directly to your cloud infrastructure, updating your internal BigQuery databases as soon as a driver rolls out. For shipments in transit, `get_tracking_events` pulls high-frequency milestones from Navisphere directly into your monitoring dashboard. This replaces manual phone calls, feeding Navisphere milestones straight into your Google Cloud monitoring pipeline.

Setup guide

Set up Navisphere MCP in Google ADK

Prerequisites

Python 3.10+ installed
google-adk package (pip install google-adk)
Active Vinkius subscription with a valid endpoint token

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with Navisphere tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="Navisphere_agent",
    model="gemini-2.0-flash",
    instruction="You have access to Navisphere tools via MCP.",
    tools=mcp_tools,
)

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 Navisphere. 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 Navisphere 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 Navisphere MCP in Google ADK

Initialize `McpToolset` with the Vinkius HTTP URL in Python. Pass that toolset to your `LlmAgent` instance, and your Gemini models will immediately know how to use tools like `search_available_loads`.

Yes, your agent can pull historical lane pricing from BigQuery and immediately use `get_rate_estimate` to compare live rates. This lets you build data-driven bidding loops that run completely on Google Cloud.

Your agent uses `get_tracking_events` to pull granular location data. Because Google ADK integrates with your existing cloud pipelines, you can feed these events directly into Pub/Sub for real-time dashboard updates.

The agent calls `accept_offer` to claim a load once it passes your margin criteria. If you need to restrict this action, you can use the ADK's `tool_names` filter to keep this specific tool restricted to authorized workflows.

Your location updates from `get_tracking_events` and status changes from `update_shipment_status` travel through secure, ephemeral V8 isolates. No tracking data or customer shipment details are cached on Vinkius, ensuring your operational privacy remains intact.

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