How to Use the Etsy MCP in Google ADK

Q: Can I restrict which Etsy tools the MCP Server exposes to Google ADK?

You use the toolnames filter when configuring your toolset. This lets you expose listshoplistings for reading data while blocking destructive actions entirely.

Q: How do I verify my connection?

Call getme as a test during your agent's initialization sequence. If it returns your shop profile, the authentication is working correctly.

Q: Is my Etsy order data kept private from Google Cloud?

Tools like listshopreceipts expose transaction histories and buyer details. Vinkius secures this pipeline using a strict zero-trust architecture, meaning your credentials and raw payloads are never logged or stored on our disks.

Feed Etsy shop data directly into Google ADK via this MCP Server. Build enterprise agents backed by Gemini.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Etsy MCP to Google ADK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cross-reference BigQuery with Etsy

Enterprise sellers already have historical sales data sitting in Google Cloud. Now your Gemini agents can pull live platform data using `list_shop_receipts` and compare it against your internal BigQuery tables. The agent fetches granular order information via `get_receipt`. It spots discrepancies between Etsy's current state and your warehouse records instantly, allowing you to fix fulfillment errors before shipping.

Process massive catalogs with Google ADK

Gemini's massive token context window changes how you handle inventory. You can dump thousands of items from `list_shop_listings` straight into the prompt without chunking or losing context. The agent reads your entire store hierarchy using `list_shop_sections`. It analyzes the full catalog at once to recommend bulk tag optimizations, then pushes changes back via `update_listing`.

Market research at scale

Stop guessing what buyers want. This MCP Server lets your agent run broad market queries using `search_active_listings` to see exactly what competitors are doing right now. Pair that external data with your own customer feedback pulled from `list_shop_reviews`. The agent synthesizes external trends and internal sentiment to tell you exactly what products you need to build next.

Setup guide

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

Install the google-adk package. Wrap your endpoint URL in StreamableHttpServerParameters and pass it to McpToolset. Assign that toolset to your LlmAgent.

You use the tool_names filter when configuring your toolset. This lets you expose list_shop_listings for reading data while blocking destructive actions entirely.

You need to implement your own throttling logic. The agent can call get_shop rapidly, so build pauses into your Gemini reasoning loops to avoid API bans.

Call get_me as a test during your agent's initialization sequence. If it returns your shop profile, the authentication is working correctly.

Tools like list_shop_receipts expose transaction histories and buyer details. Vinkius secures this pipeline using a strict zero-trust architecture, meaning your credentials and raw payloads are never logged or stored on our disks.

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