How to Use the Ecwid MCP in Google ADK

Q: How do I initialize the Ecwid MCP toolset in Google ADK?

Install the library via pip install google-adk and configure McpToolset with your Vinkius HTTP endpoint. Pass the toolset into your LlmAgent using the tools parameter to begin.

Q: Can I restrict which Ecwid tools are exposed to Google ADK?

Yes, use the toolnames filter parameter when creating your McpToolset. This lets you expose only specific tools like searchproducts while keeping administrative tools hidden.

Q: How does Google ADK handle high-volume Ecwid product updates?

Your Gemini agent uses getproduct to check stock levels, then updates them via updateinventory. This direct API communication handles large inventory updates without lagging.

Q: Can I analyze customer purchasing history with this integration?

Yes, searchcustomers retrieves buyer profiles, which your agent can compare against order histories from searchorders. This allows your agent to segment customers based on their spending habits.

Connect Gemini's million-token reasoning to your Ecwid store using the 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 Ecwid MCP to Google ADK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Enterprise inventory control with Google ADK

`update_inventory` modifies stock quantities on your Ecwid storefront directly from Google ADK workflows. Your Google ADK agent reads current Ecwid inventory levels using `get_product` before executing any updates. By combining this MCP Server with BigQuery, your Google ADK agent analyzes historical sales data to predict Ecwid stock shortages. It then modifies Ecwid counts in real time, avoiding manual inventory entry.

Large-scale order search and analysis

`search_orders` retrieves Ecwid order numbers, totals, and buyer details for processing within the Google ADK framework. Your Google ADK agent uses this data alongside `get_order` to resolve Ecwid shipping disputes. Google ADK long context window allows the agent to analyze hundreds of Ecwid order records at once. It cross-references buyer details with `search_customers` to identify Ecwid buying trends without slowing down your database.

Category and coupon audits

`list_categories` retrieves your entire Ecwid shop layout so your Google ADK agent can organize new product arrivals. The Google ADK agent uses `list_coupons` to check active Ecwid discount codes against current promotional campaigns. By reading Ecwid store settings with `get_profile` and saving state via `get_app_storage`, your Google ADK setup stays synchronized. This keeps your Ecwid catalog structure clean and prevents coupon abuse.

Setup guide

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

Install the library via `pip install google-adk` and configure `McpToolset` with your Vinkius HTTP endpoint. Pass the toolset into your `LlmAgent` using the `tools` parameter to begin.

Yes, use the `tool_names` filter parameter when creating your `McpToolset`. This lets you expose only specific tools like `search_products` while keeping administrative tools hidden.

Your Gemini agent uses `get_product` to check stock levels, then updates them via `update_inventory`. This direct API communication handles large inventory updates without lagging.

Yes, `search_customers` retrieves buyer profiles, which your agent can compare against order histories from `search_orders`. This allows your agent to segment customers based on their spending habits.

Your inventory numbers, product SKUs, and order details pass through secure, zero-trust V8 isolates. The Vinkius infrastructure never writes this transactional data to disk, ensuring your store's commercial records remain strictly confidential.

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