Provides Etsy seller operations via the Etsy OpenAPI v3, including listing CRUD, bulk inventory/price/quantity updates by SKU, shop and listing grading, profit calculation, tag and taxonomy suggestions, photo upload, shipping profiles, conversations, receipts, fulfillment tracking, and review syncing.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ai.studio/etsy-gold audit my entire shop and show worst listings first"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Etsy seller ops via Etsy OpenAPI v3 — 18 tools: listings CRUD, variant bulk by SKU, receipts, A-F grade + worst-first whole-shop audit, photo upload, taxonomy/tag gap, shipping, conversations, fulfillment, profit calc. + gold_setup_check =19 total. BYOK, fail-closed.
Binary: etsy-gold · Package: etsy-gold · MCP name: ai.studio/etsy-gold
Disclosure: This project is an independent Gold wrapper around the public Etsy OpenAPI v3 (
https://developers.etsy.com/documentation/openapi). We are not affiliated with Etsy, Inc. Etsy is a trademark of Etsy, Inc. This wrapper's original code is © 2026 Studio AI underGOLD MCP — COMMERCIAL LICENSE v1.0. Upstream docs remain under their own licenses.THIRD_PARTY_NOTICES.md+upstream/ORIGINAL_LICENSEpreserve attribution.
BYOK + fail-closed before price: Bring your own keys —
ETSY_ACCESS_TOKEN+ETSY_SHOP_IDstay on your machine, fail-closed without them (config_error, no fake shop). Works only on your own shop — BYOK, no shared backend. No keys in this repo, no backend submit while staged. Price $29 once (no subscription) — all 18gold_*tools +gold_setup_check=19 requireGOLD_LICENSE_KEY, fail-closed without it (offline 7-day grace). Seesrc/moat.ts+src/shared/gold-license.ts.
Buy Pro — PAID ONLY $29 once via Keygen CE (no free tier): https://gumroad.com/l/etsy-gold — staged, no live checkout.
npx -y etsy-gold
# or local
npm install
npm run build
node dist/index.jsClaude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"etsy-gold": {
"command": "npx",
"args": ["-y", "etsy-gold"],
"env": {
"ETSY_ACCESS_TOKEN": "YOUR_OAUTH_TOKEN",
"ETSY_SHOP_ID": "12345678",
"GOLD_LICENSE_KEY": "gold_pro_..."
}
}
}
}Related MCP server: Etsy MCP Server
Var | Purpose |
| Etsy OAuth token (BYOK, from your Etsy app) |
| Your Etsy shop ID (numeric) |
| Gold license — PAID ONLY PRO $29 once (no free tier) via Keygen CE. Or |
| Keygen CE account id for online validation (offline 7-day grace) |
Without ETSY_ACCESS_TOKEN + ETSY_SHOP_ID every tool returns config_error (no invented shop). Without GOLD_LICENSE_KEY every tool throws requires PRO license — fail-closed.
Tool | What it does |
| Create listing — title/description/price/quantity/tags/materials |
| Update listing fields by listing_id |
| Get single listing with details |
| List active listings with pagination |
| Get listing inventory — variations with price/qty/SKU |
| Bulk price/qty update by SKU up to 50 (variant bulk) |
| Grade whole shop A-F worst-first — the moat (eRank never built) |
| A-F grade single listing vs 20-point checklist |
| True profit after Etsy fees (6.5% + payments + shipping) |
| Tag gap — long-tail tag suggestions from top competitors |
| Taxonomy category finder (Etsy taxonomy) |
| Upload listing photo |
| List shipping profiles |
| Assign shipping profile to listing |
| List Etsy conversations (read-only) |
| List receipts/orders with status |
| Add tracking/fulfillment to receipt |
| List reviews for shop (sync) |
| Preflight — verifies ETSY_ACCESS_TOKEN + ETSY_SHOP_ID + ETSY_KEYSTRING + GOLD_LICENSE_KEY fail-closed |
All 18 gold tools + gold_setup_check =19 total are gold_* prefixed — PAID ONLY PRO $29 once, BYOK fail-closed without ETSY keys and GOLD_LICENSE_KEY (offline 7-day grace). See src/moat.ts 18 tools.
Derivative shape from Etsy OpenAPI v3 docs + eRank/Star seller patterns (no code copied, API only). Original code © 2026 Studio AI under GOLD MCP — COMMERCIAL LICENSE v1.0 (2026-08-19) — see LICENSE — LICENSE TIERS: PRO $29 once (PAID ONLY, no free tier) | TEAM $99/mo via Keygen CE. Etsy API docs: https://developers.etsy.com/documentation/reference
Etsy official dev-mcp is docs-only (no ops) — window OPEN but closing. Monthly wayback diff on dev-mcp tool count. Registry-listed via smithery.yaml + mcp.json (Glama / Pulsemcp / mcp.so / mcp-registry).
LICENSE — PRO $29 once, TEAM $99/mo. Etsy trademark remains Etsy's. No affiliation.
Master plan: docs/MCP-GOLD-MASTER-PLAN-2026-08-19.md
Third-party notices: THIRD_PARTY_NOTICES.md
Etsy docs: https://developers.etsy.com/documentation/reference
Set one listing's shipping profile in one call (fix 'this listing has no shipping' errors at scale). BYOK. PAID ONLY PRO $29.
Inputs: listing_id (required), shipping_profile_id (required), confirm.
POWER TOOL: A-F grade your ENTIRE active shop (up to 100 listings, one call), ranked worst-first with per-listing fix lists + shop average. The audit eRank charges monthly for — here it is one call. BYOK. PAID ONLY PRO $29.
Inputs: limit.
Read your shop's buyer conversations (unread-first previews). Sending stays manual by design — pair with Claude to draft the reply. BYOK. PAID ONLY PRO $29.
Inputs: limit.
Create a draft Etsy listing (title/description/price/quantity/who_made/when_made/category). BYOK. PAID ONLY PRO $29.
Inputs: price (required), title (required), quantity (required), who_made (required), +6 more.
Search Etsy's full seller taxonomy by keyword -> category_id you can paste into create_listing. No more guessing numbers. BYOK. PAID ONLY PRO $29.
Inputs: query (required), limit.
Mark an order shipped: upload tracking code + carrier to a receipt (real fulfillment, not a mock). BYOK. PAID ONLY PRO $29.
Inputs: receipt_id (required), tracking_code (required), confirm, carrier_name, +1 more.
Get listing inventory — variations (size/color) with price/qty/SKU. Steals eRank's gap: bulk variant view. BYOK. PAID ONLY PRO $29.
Inputs: listing_id (required).
Get one Etsy listing full detail incl images + tags. BYOK. PAID ONLY PRO $29.
Inputs: listing_id (required).
A-F SEO grade of one listing — 13 tags / keyword-first title / desc depth / photos≥8 / materials (steals eRank audits + Marmalead grading, pure logic). Includes fix list. BYOK. PAID ONLY PRO $29.
Inputs: listing_id (required).
List your active Etsy listings (title/price/qty/tags count). BYOK ETSY_ACCESS_TOKEN + ETSY_SHOP_ID. PAID ONLY PRO $29.
Inputs: limit, state.
POWER: real net profit per listing - pulls price/shipping from Etsy, applies 6.5% transaction + $0.20 listing + payment fees + your COGS/ad cost -> margin % and the price you NEED. BYOK. PAID ONLY PRO $29.
Inputs: cogs (required), listing_id (required), ad_spend_per_sale, target_margin_pct, +1 more.
Sync recent reviews of a listing (rating + text) — feed AI reply drafts or spot problems early. BYOK. PAID ONLY PRO $29.
Inputs: listing_id (required), limit.
List your shop's shipping profiles (id + title + destinations) so listings can be created/updated with the right one. BYOK. PAID ONLY PRO $29.
Inputs: no named parameters.
Real orders (receipts) for your shop — what eRank only estimates. Filter min made_out/paid date. BYOK. PAID ONLY PRO $29.
Inputs: limit, was_paid.
PURE LOGIC POWER: audit one listing's 13 tags vs its title/attributes -> unused long-tail combos buyers actually type (multi-word, no duplicates of title words). No AI key needed. BYOK. PAID ONLY PRO $29.
Inputs: listing_id (required).
Update an Etsy listing (title/description/price/quantity/state). BYOK. PAID ONLY PRO $29.
Inputs: listing_id (required), price, state, title, +3 more.
Bulk-update variation offerings (price/qty per product offering) on one listing — the variant bulk edit eRank never built. BYOK. PAID ONLY PRO $29.
Inputs: products (required), listing_id (required), confirm.
Upload a photo to a listing from your local disk (first image = main; set rank 1-10). Closes the biggest gap vs dashboard tools. BYOK. PAID ONLY PRO $29.
Inputs: image_path (required), listing_id (required), rank, confirm.
SETUP CHECK for Etsy Gold — run this FIRST. Shows license tier, which API keys are set vs missing (names only, never values), and the exact next step.
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 19 tools
Each tool targets a distinct Etsy resource or action—listings, inventory, receipts, reviews, shipping, categories—and descriptions clearly state scope. A few adjacent tools like grade_listing vs bulk_grade_shop could be confused, but their single-vs-shop scope is explicit.
Names mostly follow a gold_etsy_ + verb_noun pattern and consistently use snake_case. However, there are deviations: gold_setup_check lacks the etsy segment, and several tools use noun-only or reversed noun_verb forms like shop_receipts, shipping_profiles, and conversations_list.
19 tools is on the heavier side but still reasonable for a broad Etsy seller management and SEO suite. Nearly every tool covers a distinct capability, so the count does not feel padded.
The suite covers the main Etsy lifecycle: listing create/read/update, inventory, images, shipping, orders, fulfillment, reviews, and SEO diagnostics. Notable gaps include no delete_listing, no variation creation, and no outbound messaging, but these are partially workaroundable or intentionally omitted.
Etsy research and shop tools for AI: products, shops, keywords, trends, your listings and orders.
Run storefronts, listings, orders, content, fulfillment, and analytics through AI.
Run an eBay seller account from your AI assistant: orders, listings, stock, fees and payouts.
Research Etsy and manage an authorized shop; MakeBox Pro or Studio required.
