etsy-seller

Agent Plugin for Etsy Open API v3 seller ops: shop info, listings, inventory, and receipts/orders.

Install

Install this plugin in Cursor (or clone and load as a local Agent Plugin).
Create an Etsy Seller App at Your Apps.
Set secrets / env:
- ETSY_KEYSTRING — app keystring
- ETSY_SHARED_SECRET — app shared secret
- ETSY_REDIRECT_URI — optional; default http://localhost:3456/callback
Register the same callback URL on the app. Use localhost, not 127.0.0.1 (Etsy rejects IP hosts).
Call etsy_auth_start, open the URL, approve scopes, then etsy_auth_wait.

Listing = { listing_id, title, state, quantity, price, url }
Inventory = { products: [{ sku, offerings: [{ price, quantity, is_enabled }] }] }
ShopReceipt = { receipt_id, status, created_timestamp, grandtotal, … }
Shop = { shop_id, shop_name, url, currency_code }

Tool	Purpose
`etsy_auth_status`	Token / shop binding
`etsy_auth_start` / `etsy_auth_wait`	OAuth PKCE
`etsy_get_shop`	Authenticated seller shop
`etsy_list_listings`	List listings by state
`etsy_get_inventory` / `etsy_update_inventory`	Read / full-replace inventory
`etsy_list_receipts`	Orders / receipts

Scopes requested: shops_r shops_w listings_r listings_w listings_d transactions_r transactions_w.

plugin.json
mcp.json
skills/etsy-seller/SKILL.md
src/server.mjs

Zero-dep Node stdio MCP (fetch via Node https).

MIT