Etsy MCP. Audit listings, orders, and reviews via natural conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Etsy MCP Server manages your entire shop operation. Use your AI agent to audit listings, check customer reviews, and pull order receipts.
It gives you a single point of access to listing metadata, order status, and shop performance data without ever opening the Etsy dashboard.
Manage inventory, track sales, and optimize your listings all through natural conversation.
What your AI agents can do
Get listing
Gets specific details for one Etsy listing.
Get me
Fetches authenticated user and application information from Etsy.
Get receipt
Retrieves detailed information for a specific order receipt.
Gets the metadata for one specific listing using the get_listing tool.
Retrieves general details about the connected Etsy shop using the get_shop tool.
Retrieves a list of all active listings in the connected shop using list_shop_listings.
Lists all shop receipts to give a clear view of recent sales and fulfillment status via list_shop_receipts.
Lists all customer reviews for the shop using list_shop_reviews.
Searches for active listings across the entire Etsy marketplace using search_active_listings.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Etsy MCP Server: 10 Tools for Shop Management
Run audits, update inventory, track orders, and search the entire marketplace using these 10 tools.
019d8436get listing
Gets specific details for one Etsy listing.
019d8436get me
Fetches authenticated user and application information from Etsy.
019d8436get receipt
Retrieves detailed information for a specific order receipt.
019d8436get shop
Gets general details for the connected Etsy shop.
019d8436list shop listings
Lists all active listings currently in your shop.
019d8436list shop receipts
Lists all recent orders and receipts for your shop.
019d8436list shop reviews
Lists all customer reviews for your shop.
019d8436list shop sections
Lists the different sections (e.g., 'Best Sellers') within your shop.
019d8436search active listings
Searches for active listings across the entire Etsy platform by keyword or category.
019d8436update listing
Updates the title or description of an existing Etsy listing.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Etsy, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Your AI agent runs your whole Etsy shop. You'll get real-time data on inventory, sales, and customer feedback without ever having to open the Etsy dashboard. get_shop fetches general details about the connected shop. get_me pulls your user and application info from Etsy. list_shop_listings gives you a full list of every active listing in your shop. get_listing pulls specific metadata for one listing. search_active_listings searches for active listings all over the Etsy platform by keyword or category. list_shop_sections shows you the different sections—like 'Best Sellers'—set up in your shop. list_shop_reviews pulls all customer reviews for your shop. list_shop_receipts lists all recent orders and receipts, so you can track sales and fulfillment status. get_receipt retrieves detailed information for a specific order receipt. update_listing lets you update a listing's title or description.
list_shop_listings lets you list every active item in your shop's catalog. get_listing lets you pull detailed metadata on a single product. search_active_listings searches the entire Etsy marketplace, letting you find inspiration or check out competitors. list_shop_sections lists the shop's various sections. list_shop_reviews pulls all customer feedback for your brand. list_shop_receipts lists all your recent orders, giving you a clear view of sales and fulfillment. get_receipt gets the specific details for any single order receipt. update_listing lets you change a listing's title or description right away.
How Etsy MCP Works
- 1 Provide your Etsy API Key and Access Token to the server.
- 2 Connect your AI client (Claude, Cursor, etc.) to the Vinkius Marketplace.
- 3 Use natural language prompts (e.g., 'What were my last 5 sales?') to trigger the relevant tools.
The bottom line is, your agent handles the API calls and data parsing; you just talk to it.
Who Is Etsy MCP For?
Shop owners and artisans who spend too much time clicking through dashboards. It's for the operations manager who needs a real-time view of inventory, sales, and reviews without manual logins. If you manage a high-volume or varied catalog, this saves hours of repetitive checking.
Uses the agent to check listing statuses and update descriptions for new collections without leaving their design tool.
Runs daily audits of list_shop_receipts and list_shop_reviews to ensure fulfillment and brand reputation are on track.
Uses search_active_listings to monitor competitor trends and verify that new product descriptions are correctly published and optimized.
What Changes When You Connect
- See your entire inventory list instantly. Instead of navigating through multiple dashboard tabs, use
list_shop_listingsto get metadata, pricing, and URLs for every product in one call. - Know your sales status without logging in.
list_shop_receiptspulls all order receipts and fulfillment details, letting your agent give you a clear view of recent sales history. - Manage reputation instantly. Use
list_shop_reviewsto pull all customer feedback and see where your brand needs improvement, without manually exporting data. - Update listings with a prompt. Don't manually rewrite titles. Just tell your agent to update a listing, and
update_listinghandles the API call, keeping your catalog current. - Benchmark against competitors. Need ideas? Run
search_active_listingsto find out what's trending across the whole platform, keeping your shop relevant. - Get shop context immediately. Use
get_shopto get core details about your shop, providing necessary context before running deeper reports.
Real-World Use Cases
Checking a customer's order status
A customer asks, 'Did my vintage watch ship?' Instead of logging in, searching for the order ID, and clicking through status pages, the agent runs list_shop_receipts and get_receipt to pull the exact fulfillment status, answering the query instantly.
Refreshing product descriptions in bulk
You just released a new line of pottery. Instead of going listing by listing to update descriptions, you tell your agent, 'Update the descriptions for all 'pottery' listings to include the new glaze details.' The agent uses list_shop_listings and update_listing to manage the whole catalog.
Monitoring competitor pricing
You want to know if a competitor is listing similar items cheaper. You use search_active_listings with keywords like 'linen dress.' The agent returns top results, letting you compare prices and identify market gaps.
Reviewing a product line's performance
You need to know if your 'ceramic' line is popular. You run list_shop_listings to check inventory counts, then list_shop_reviews to see the customer sentiment attached to those specific items.
The Tradeoffs
Manual Dashboard Crawling
The developer tries to replicate the functionality by writing code that mimics clicking through the Etsy dashboard's 'Orders' tab, then 'Reviews' tab, then scraping the results. This breaks constantly when Etsy updates its UI.
→
Use the dedicated tools. For orders, use list_shop_receipts and get_receipt. For reviews, use list_shop_reviews. The agent handles the data access, not the UI.
Single Tool Reliance
Only calling get_listing when you need to know if a product is sold out. This tool only gives details, not the live, overall shop inventory status.
→
Always start with list_shop_listings first. This gives you the full, current inventory list, and then you can drill down with get_listing if needed.
Ignoring Scope
Running a search query by manually guessing the URL parameters for a competitor's shop. You miss listings that aren't indexed or are in a different section.
→
Use search_active_listings. This tool queries the entire platform, giving you comprehensive market intelligence beyond just your own shop.
When It Fits, When It Doesn't
Use this server if your workflow involves checking multiple, distinct aspects of your shop: inventory (list_shop_listings), sales history (list_shop_receipts), and customer feedback (list_shop_reviews). It's ideal for automating daily shop audits.
Don't use this if your primary need is just to write a product description—that's a pure generation task. Also, if you only need to check a single, static piece of data (like the shop name), get_shop is fine, but for any multi-step operational check, the full suite is necessary. This is a shop OS for your agent.
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Tracking shop performance shouldn't require logging into a dashboard.
Right now, to know if your shop is doing well, you have to jump through hoops: log in, check the 'Orders' tab to see sales, then switch to 'Reviews' to see feedback, and finally navigate to 'Listings' to check if prices are correct. You're wasting time copying data between tabs.
With the Etsy MCP Server, you ask your agent: 'Show me the sales and reviews for the last week.' It runs `list_shop_receipts` and `list_shop_reviews` and gives you a unified answer immediately. No manual clicks, no dashboard switching.
Etsy MCP Server: List Shop Reviews
Before, you'd manually export the reviews, paste them into a spreadsheet, and try to manually categorize the common complaints. It's slow, and you risk missing context.
Now, just ask your agent to run `list_shop_reviews`. It pulls all the data, giving you a clean, structured list that your agent can analyze for patterns and sentiment. You get actionable insight, not just raw text.
Common Questions About Etsy MCP
How do I use the `list_shop_listings` tool with Etsy MCP Server? +
You ask your agent to list all active listings. The agent runs list_shop_listings and returns a list of every product ID, title, and current price in your shop.
Can I use `search_active_listings` to check competitor products? +
Yes. This tool searches the entire Etsy platform, not just your shop. You simply give it keywords, and it returns matching active listings across the site.
What is the difference between `get_receipt` and `list_shop_receipts`? +
Use list_shop_receipts to see a list of all orders. Use get_receipt when you know the specific order ID and need the full details for just that one transaction.
Does the `update_listing` tool work on all types of listings? +
The update_listing tool allows you to update titles and descriptions for existing listings. You must provide the specific listing ID.
Can I check my shop's overall details with `get_shop`? +
Yes, get_shop pulls general metadata about your shop. This is useful for context, like finding your shop's unique identifier or name.
How do I use `list_shop_reviews` to monitor my shop's reputation? +
The list_shop_reviews tool fetches all customer feedback for your shop. This lets you quickly audit your brand reputation and identify common praise or issues across multiple reviews.
What is the difference between `get_listing` and `list_shop_listings`? +
get_listing retrieves the details for one specific listing using its ID. Conversely, list_shop_listings gives you a full list of all your shop's active listings.
How does the `update_listing` tool work for modifying my inventory? +
You use update_listing to change titles, descriptions, or prices for existing listings. Simply tell your agent what you want to change, and it handles the API call.
How do I find my Etsy API Key and Access Token? +
Register an App in the Etsy Developer Console to get your Keystring, then perform the OAuth flow to generate an Access Token. Copy and paste them below.
Can the agent list my recent sales receipts? +
Yes. Use the list_shop_receipts tool providing your Shop ID. Your agent will retrieve the most recent transactions, including payment and shipping statuses.
Is it possible to update an Etsy listing via the agent? +
Yes. The update_listing tool allows your agent to modify existing listing titles and descriptions instantly by providing the specific Listing ID.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Automate Reddit interactions via AI — search subreddits, list hot posts, and retrieve comment threads directly.
MeisterTask
Organize team tasks with visual Kanban boards, recurring workflows, and integrations that connect to your favorite tools.
OOPSpam
Block spam submissions on your forms and comments with an AI-powered filter that catches bots without annoying real users.
You might also like
Documint
Equip your AI agent to automate document generation, manage templates, and track output files via the Documint API.
Payload CMS Extended
Manage your Payload CMS instance — query collections, inspect documents, and manage content directly from your AI agent.
Forj
Manage community members, groups, and activity via AI agents with Forj (formerly Mobilize).