How to Use the Etsy MCP in Mastra AI

Q: How do I configure Mastra AI to manage my Etsy shop?

Install @mastra/mcp and initialize a new MCPClient passing your Vinkius URL in the servers object. Call listTools() to expose the endpoints and spread them directly into your agent's tool array.

Q: Can Mastra AI handle Etsy API rate limits automatically?

Yes. If a bulk call to searchactivelistings triggers a 429 response, the built-in workflow engine catches the error. It applies exponential backoff and retries the request without crashing your application.

Q: How does this MCP Server protect my buyer information?

Buyer names and physical addresses retrieved via listshopreceipts are processed in a zero-trust environment. Vinkius provisions an isolated runtime for the specific tool execution, routes the data back to your workflow, and tears down the sandbox completely. Nothing is logged to disk.

Automate complex Etsy shop workflows with automatic retries using this Mastra AI 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 Etsy MCP to Mastra AI

Create your Vinkius account to connect Etsy to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Resilient Mastra AI Workflows

`list_shop_listings` acts as the trigger for automated inventory audits inside your workflow engine. If the Etsy API drops the connection or hits a rate limit, the framework automatically catches the failure and retries the request with exponential backoff. You never write custom retry logic. Once the data arrives, you route it through conditional branches based on stock levels. The agent evaluates the results from the MCP server and decides whether to alert the shop owner or trigger a secondary tool to pause the listing.

Chain Shop Reviews to Support Actions

`list_shop_reviews` feeds directly into a multi-step customer retention sequence. When a three-star review comes in, the agent detects the sentiment and automatically branches into a resolution workflow. It then calls `get_receipt` to pull the exact transaction details—shipping dates, item costs, and buyer history. By chaining these tools, you build a support system that gathers all context before it ever asks a human to draft an apology message.

Gate Inventory Updates with Approvals

`update_listing` modifies live product prices and titles, which carries significant operational risk. You wrap this tool in a `requireToolApproval` flag to enforce a human-in-the-loop checkpoint before any changes hit the live storefront. The agent drafts the proposed SEO changes using `get_listing` data, stages the update, and pauses execution. A shop manager reviews the pending action, clicks approve, and the workflow resumes to push the final payload.

Setup guide

Set up Etsy MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Etsy tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "etsy-mcp-client",
  servers: {
    "etsy-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Etsy Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Etsy tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Etsy transactions"
);
console.log(result.text);

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 Mastra AI

Install `@mastra/mcp` and initialize a new `MCPClient` passing your Vinkius URL in the servers object. Call `listTools()` to expose the endpoints and spread them directly into your agent's tool array.

Yes. If a bulk call to `search_active_listings` triggers a 429 response, the built-in workflow engine catches the error. It applies exponential backoff and retries the request without crashing your application.

Use the built-in tool approval system. Tag destructive tools like `update_listing` with `requireToolApproval`, forcing the agent to wait for manual confirmation from an admin before executing the API call.

The client automatically detects the transport layer. You pass the endpoint URL, and it negotiates Streamable HTTP or SSE directly with the server, keeping your connection stable during long-running data fetches.

Buyer names and physical addresses retrieved via `list_shop_receipts` are processed in a zero-trust environment. Vinkius provisions an isolated runtime for the specific tool execution, routes the data back to your workflow, and tears down the sandbox completely. Nothing is logged to disk.

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