# Etsy MCP

> Etsy MCP connects your AI agent directly to your entire shop backend. You can audit inventory, process order receipts, and review customer feedback—all from a natural conversation. This lets you manage listings, track sales, and maintain brand reputation without logging into the Etsy dashboard.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** marketplace, shop-management, inventory-tracking, order-fulfillment, customer-reviews

## Description

Running a handmade or vintage shop means juggling inventory counts, fulfilling orders, and keeping up with reviews. With this MCP, your agent handles all that overhead. You tell it what needs doing—like checking if last week’s batch of earrings sold out—and it pulls the data instantly. Need to update ten listing descriptions because Etsy changed its policy? Just ask. Your agent updates them in bulk and confirms they're live. It acts like a virtual shop manager, keeping your listings optimized and your customers happy. Through Vinkius, you get access to this core set of functions alongside thousands of others, turning complex shop operations into simple commands for your AI client.

## Tools

### get_listing
Retrieves detailed information about a single, specific listing.

### get_me
Pulls your authenticated user and application details from Etsy for verification purposes.

### get_receipt
Retrieves all the detailed information for a specific order receipt or sale.

### get_shop
Fetches general details about your entire Etsy shop profile.

### list_shop_listings
Generates a list of all the active listings currently within your shop.

### list_shop_receipts
Provides a comprehensive list of past and current order receipts for your shop.

### list_shop_reviews
Compiles a report listing all customer reviews left on your Etsy shop.

### list_shop_sections
Lists the various curated sections you have set up within your shop profile.

### search_active_listings
Searches and finds active listings across all of Etsy using specific keywords or criteria.

### update_listing
Modifies the title, description, or other details of an existing product listing.

## Prompt Examples

**Prompt:** 
```
List my active listings in shop ID xxxx.
```

**Response:** 
```
I've retrieved your active inventory. You have 12 listings, including 'Handmade Vase' and 'Vintage Watch'. Would you like the pricing for any of them?
```

**Prompt:** 
```
Show me the last 5 reviews for my Etsy shop.
```

**Response:** 
```
I've found the last 5 reviews. Most customers are giving 5 stars, praising the 'fast shipping'. One customer mentioned 'beautiful packaging'. Would you like to see the full comments?
```

**Prompt:** 
```
Search for active listings with keyword 'linen dress'.
```

**Response:** 
```
I've found several matching listings for 'linen dress'. Top results include 'Handmade Linen Summer Dress' and 'Boho Linen Tunic'. Would you like the direct links to view them?
```

## Capabilities

### Audit full inventory details
The agent can list every current listing in your shop and retrieve specific data points like pricing, state, and URLs.

### Track sales and orders
You can browse historical receipts to see detailed information on recent sales and their fulfillment status.

### Monitor customer feedback
The tool lists all submitted reviews for your shop, keeping you up to date on brand reputation and specific customer praise or complaints.

### Update listing content
You can use natural language prompts to update titles and descriptions across multiple listings, ensuring your catalog stays current.

### Search the broader marketplace
The agent searches for active listings across Etsy so you can find market inspiration or monitor competitors' offerings.

## Use Cases

### The weekly inventory audit
A small business owner needs to know which items sold out last week and how many remaining. They ask their agent to list shop receipts and then use the available tools to check all active listings, getting a clear, consolidated report immediately.

### Responding to negative feedback
A seller gets five new reviews overnight, including three critical ones about packaging. They ask their agent to list shop reviews so they can pull the specific complaints and draft an apology response without reading through a massive feed.

### Optimizing product pages
After noticing a competitor listing with a better title, the seller tells the agent to search for active listings using that keyword. They then use update_listing to rewrite their own titles to match the market's best practices.

### Cross-checking product data
A marketing lead needs to confirm if a new batch of custom engraved items was published correctly. They ask the agent to list shop sections and then use get_listing on specific SKUs to verify all metadata is correct.

## Benefits

- Stop manually checking stock. Use the agent to list shop listings automatically; you'll instantly know which items are running low without opening a dashboard tab.
- Never miss an order detail again. By listing shop receipts or retrieving a specific receipt, your agent gives you immediate clarity on fulfillment status and sales totals.
- Build instant reputation reports. You can list shop reviews to track customer sentiment quickly, letting you address negative feedback before it spreads.
- Keep descriptions fresh with minimal effort. Instead of logging in to manually update listings, simply ask the agent to run an update_listing command using natural language prompts.
- Gain competitive insight. Use search_active_listings to monitor what similar products are selling for right now on Etsy, giving you a real-time edge.

## How It Works

The bottom line is you talk to your agent, and it talks to Etsy for you.

1. Subscribe to this MCP and provide your specific Etsy API Key and Access Token.
2. Connect the credentials to your preferred AI client (Claude, Cursor, etc.).
3. Tell your agent exactly what you need—for instance, 'List all receipts from last month'—and it retrieves the structured data directly.

## Frequently Asked Questions

**How do I use Etsy MCP to update my product descriptions?**
You use the update_listing tool by telling your agent what changes you want. Instead of manually editing each listing, just tell it to rewrite titles and descriptions using natural language prompts.

**Can I see all my past orders with Etsy MCP?**
Yes. You can list_shop_receipts to get a comprehensive history of your sales and order fulfillment status, making inventory tracking much easier.

**Does the Etsy MCP help me find competitor listings?**
It does. Use the search_active_listings tool to monitor what other sellers are listing on Etsy using specific keywords, giving you market intelligence.

**What is the difference between list_shop_receipts and get_listing?**
list_shop_receipts provides a summary of orders (the transaction). get_listing pulls deep metadata for one specific item, like its current price or URL.

**Is the Etsy MCP only for my shop's data?**
No. While it manages your own inventory and orders, you can also use search_active_listings to look at public listings across the entire Etsy platform.