How to Use the Flexport MCP in Google ADK

Q: Can I filter which Flexport tools are exposed to Google ADK?

Yes, you can use the toolnames filter in the McpToolset configuration. This lets you restrict access to sensitive operations like createpurchaseorder while still allowing read-only tools.

Q: How does Google ADK protect my Flexport purchase order data?

All purchase orders created via createpurchaseorder or read via getpurchaseorder are processed through the MCP server inside your secure project boundary. The ADK uses transient execution blocks, meaning no PO data is stored on Vinkius.

Connect Flexport logistics to Gemini models and BigQuery using the enterprise-ready Google ADK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Flexport MCP to Google ADK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run long-context logistics audits

The `list_documents` tool gathers your entire logistics history for Gemini's massive 1M-token context window. By using the Google ADK, your agent can ingest months of shipping records, customs declarations, and bills of lading in a single prompt. Once ingested, the agent matches physical files with metadata using `get_document`. This allows you to spot missing customs declarations or shipping delays without writing complex database queries or manual search scripts.

Link BigQuery with the Flexport MCP Server

The `get_shipment` tool bridges your warehouse data in Google Cloud with live freight status. Your agent queries BigQuery to find inventory gaps, then calls the MCP server to check if incoming containers are delayed. By combining `list_shipments` with your cloud data, the agent can predict stockouts before they happen. If a container is delayed at the port, the agent triggers an alert in your Google Cloud monitoring pipeline.

Automate accounts payable in Google Cloud

The `list_invoices` tool feeds freight billing data directly into your enterprise financial pipelines. Your Google ADK agent pulls billing records and matches them against purchase history without human intervention. To resolve discrepancies, the agent calls `get_invoice` and `list_shipment_invoices` to verify specific line items. This automated matching saves hours of manual spreadsheet work for your finance team.

Setup guide

Set up Flexport 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 Flexport 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="Flexport_agent",
    model="gemini-2.0-flash",
    instruction="You have access to Flexport 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 Flexport. 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 Flexport 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 Flexport MCP in Google ADK

Use McpToolset with StreamableHttpServerParameters pointing to your Vinkius endpoint. Pass this toolset into your LlmAgent initialization to expose the logistics tools to Gemini.

Yes, you can use the tool_names filter in the McpToolset configuration. This lets you restrict access to sensitive operations like create_purchase_order while still allowing read-only tools.

Gemini can hold massive amounts of text, meaning your Google ADK agent can read multiple files retrieved via download_document simultaneously. This makes it easy to find discrepancies across dozens of shipping files.

Yes, the framework supports both Stdio and HTTP transports for this MCP server. For cloud deployments on Vertex AI, the HTTP transport is recommended to connect securely to your hosted Vinkius endpoint.

All purchase orders created via create_purchase_order or read via get_purchase_order are processed through the MCP server inside your secure project boundary. The ADK uses transient execution blocks, meaning no PO data is stored on Vinkius.

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