@mcpengine/etsy
Provides comprehensive tools for the Etsy API v3, enabling management of listings, shops, orders, payments, reviews, taxonomy, and more.
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., "@@mcpengine/etsy list my active listings"
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.
@mcpengine/etsy — The Most Comprehensive Etsy MCP Server
The most complete Model Context Protocol (MCP) server for the Etsy API v3, featuring 50+ tool modules covering virtually the entire Etsy API surface.
Features
50+ tools across every Etsy API domain
Full Etsy API v3 coverage
Zod-validated input schemas on every tool
readOnlyHinton all GET/list operationsdestructiveHinton all delete operationsCursor/offset pagination on all list tools
Axios-based client with OAuth bearer token support
TypeScript with 0 compilation errors
Related MCP server: Etsy MCP Server
Tools Index
Listings (Core)
Tool | Description |
| List active listings with filters |
| Get a single listing |
| Batch-fetch listings by IDs |
| List all listings in a shop |
| Create a new listing |
| Update a listing |
| Delete a listing |
| Get featured listings |
Listing Images
Tool | Description |
| List images for a listing |
| Get a specific image |
| Upload an image via URL |
| Delete an image |
| Reorder listing images |
Listing Videos
Tool | Description |
| List videos |
| Get a specific video |
| Upload/attach a video |
| Remove a video |
Listing Inventory
Tool | Description |
| Get inventory (variations, prices, quantities) |
| Update inventory |
Listing Properties
Tool | Description |
| List properties |
| Get a property |
| Update a property |
| Delete a property |
Digital Files
Tool | Description |
| List digital download files |
| Get a file |
| Upload a digital file |
| Delete a file |
Translations
Tool | Description |
| List translations |
| Get a translation |
| Create translation |
| Update translation |
Variation Images
Tool | Description |
| Get variation images |
| Update variation images |
Shops
Tool | Description |
| Get a shop |
| Update a shop |
| Get shops by user |
| Search shops by name |
Shop Sections
Tool | Description |
| List sections |
| Get a section |
| Create a section |
| Update a section |
| Delete a section |
Shop About, Production Partners, Return Policies
Tool | Description |
| Get shop About page |
| List production partners |
| Create partner |
| Update partner |
| Delete partner |
| List return policies |
| Get a policy |
| Create policy |
| Update policy |
| Delete policy |
Shipping Profiles
Tool | Description |
| List profiles |
| Get a profile |
| Create profile |
| Update profile |
| Delete profile |
| List destinations |
| Create destination |
| Update destination |
| Delete destination |
| List upgrades |
| Create upgrade |
| Update upgrade |
| Delete upgrade |
| List shipping carriers |
Orders & Receipts
Tool | Description |
| List orders/receipts |
| Get a receipt |
| Update receipt (ship, note) |
| List transactions |
| Get a transaction |
| Transactions for a receipt |
| List shipments |
| Add tracking |
| Receipt transactions in shop |
| Listing transactions |
Payments & Finance
Tool | Description |
| List payments |
| Get a payment |
| Payments for a receipt |
| List ledger entries |
| Get a ledger entry |
| Get payment account |
| List ledger entries (alt) |
| Get ledger entry |
| Payment for ledger entry |
| List payouts |
| Get a payout |
Reviews
Tool | Description |
| Shop reviews |
| Listing reviews |
Users & Addresses
Tool | Description |
| Get a user |
| Get authenticated user |
| List addresses |
| Get an address |
| Delete an address |
Taxonomy & Discovery
Tool | Description |
| List seller taxonomy |
| Get a taxonomy node |
| List taxonomy properties |
| Get properties for node |
| List buyer taxonomy |
| Get buyer taxonomy node |
| Global listing search |
| Search within a shop |
| Listings by section |
Favorites
Tool | Description |
| List favorited listings |
| Check if listing is favorited |
| Favorite a listing |
| Unfavorite a listing |
| List favorited shops |
| Check if shop is favorited |
| Favorite a shop |
| Unfavorite a shop |
Images, Media & Icons
Tool | Description |
| Upload image from URL |
| Set image display rank |
| Update image alt text |
| Get shop icon |
| Delete shop icon |
| Get shop banner |
| Delete shop banner |
Listing Lifecycle & Content
Tool | Description |
| List draft listings |
| Create a draft |
| Publish a draft |
| Renew an expired listing |
| List expired listings |
| List inactive listings |
| Get listing stats |
| Get view count |
| Bulk listing stats |
| List featured listings |
| Set featured rank |
| Feature a listing |
| Unfeature a listing |
| Get listing tags |
| Replace tags |
| Add tags |
| Get materials |
| Replace materials |
| Add materials |
| Get occasion |
| Set occasion |
| Update styles |
Shop Analytics
Tool | Description |
| Shop-level stats |
| Order summary |
| Payment account summary |
Products & Offerings
Tool | Description |
| Get a product offering |
| Get a product variant |
Setup
1. Get an Etsy API Key
Visit Etsy Developer Portal
Click Create a New App
Note your API Key (Keystring)
For write operations, set up OAuth 2.0 and obtain an access token
2. Install
npm install
npm run build3. Configure
cp .env.example .env
# Edit .env with your credentialsETSY_API_KEY=your_etsy_api_key_here
ETSY_ACCESS_TOKEN=your_oauth_access_token_here # Optional: for write operations4. Run
npm startOr with npx:
ETSY_API_KEY=<key> node dist/main.jsMCP Client Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"etsy": {
"command": "node",
"args": ["/path/to/etsy-mcp/dist/main.js"],
"env": {
"ETSY_API_KEY": "your_api_key_here",
"ETSY_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}Cursor
Add to .cursor/mcp.json in your project:
{
"mcpServers": {
"etsy": {
"command": "node",
"args": ["./dist/main.js"],
"env": {
"ETSY_API_KEY": "your_api_key_here"
}
}
}
}Authentication
The Etsy API uses two forms of authentication:
Operation | Auth Required |
Public listing search | API Key only |
Read shop data | API Key only |
Write/update operations | OAuth 2.0 Access Token |
Financial data | OAuth 2.0 Access Token |
API Key: Pass as ETSY_API_KEY env var
OAuth Token: Pass as ETSY_ACCESS_TOKEN env var
For OAuth setup, see Etsy's OAuth 2.0 Guide.
Architecture
src/
├── main.ts # Entry point, env validation
├── server.ts # MCP server class, tool loader
├── client.ts # Axios-based Etsy API v3 client
├── types.ts # TypeScript interfaces
└── tools/ # One file per API domain (47 modules)
├── listings.ts
├── listing_images.ts
├── ...
└── listing_occasion.tsDevelopment
npm run dev # ts-node (no build step)
npm run build # TypeScript compile → dist/
npm run lint # ESLintLicense
MIT — see LICENSE
Available Tools
146 toolsetsy_buyer_taxonomy_listARead-only
List all buyer taxonomy nodes (categories for browsing/discovery)
Inputs: no named parameters.
etsy_buyer_taxonomy_node_getARead-only
Get a specific buyer taxonomy node by ID
Inputs: taxonomy_id (required).
etsy_featured_listings_listBRead-only
List featured listings for a shop
Inputs: shop_id (required), limit, offset.
etsy_ledger_entries_listCRead-only
List all financial ledger entries for a shop
Inputs: shop_id (required), limit, offset, max_created, +1 more.
etsy_ledger_entry_getCRead-only
Get a specific ledger entry
Inputs: shop_id (required), ledger_entry_id (required).
etsy_ledger_entry_payment_getCRead-only
Get the payment associated with a ledger entry
Inputs: shop_id (required), ledger_entry_id (required).
etsy_listing_createC
Create a new listing in a shop
Inputs: price (required), title (required), shop_id (required), quantity (required), +29 more.
etsy_listing_deleteCDestructive
Delete a listing from a shop
Inputs: shop_id (required), listing_id (required).
etsy_listing_draft_createC
Create a new draft listing (state=draft)
Inputs: price (required), title (required), shop_id (required), quantity (required), +9 more.
etsy_listing_draft_publishB
Publish a draft listing by setting its state to active
Inputs: shop_id (required), listing_id (required).
etsy_listing_drafts_listCRead-only
List all draft listings for a shop
Inputs: shop_id (required), limit, offset.
etsy_listing_featureC
Feature a listing at a specific rank in the shop
Inputs: shop_id (required), listing_id (required), rank.
etsy_listing_file_deleteBDestructive
Delete a digital file from a listing
Inputs: shop_id (required), listing_id (required), listing_file_id (required).
etsy_listing_file_getCRead-only
Get a specific digital file attached to a listing
Inputs: shop_id (required), listing_id (required), listing_file_id (required).
etsy_listing_files_listBRead-only
List all digital download files attached to a listing
Inputs: shop_id (required), listing_id (required).
etsy_listing_file_uploadB
Upload a digital download file to a listing
Inputs: shop_id (required), listing_id (required), name, rank, +1 more.
etsy_listing_getBRead-only
Get a single Etsy listing by ID
Inputs: listing_id (required), includes.
etsy_listing_image_deleteBDestructive
Delete an image from a listing
Inputs: shop_id (required), listing_id (required), listing_image_id (required).
etsy_listing_image_getCRead-only
Get a specific image for a listing
Inputs: shop_id (required), listing_id (required), listing_image_id (required).
etsy_listing_image_set_rankC
Change the rank (display order) of an existing listing image
Inputs: rank (required), shop_id (required), listing_id (required), listing_image_id (required).
etsy_listing_images_listBRead-only
List all images for a listing
Inputs: shop_id (required), listing_id (required).
etsy_listing_images_reorderC
Reorder images for a listing by providing an ordered array of listing_image_ids
Inputs: shop_id (required), listing_id (required), listing_image_ids (required).
etsy_listing_image_update_altC
Update the alt text for a listing image
Inputs: shop_id (required), alt_text (required), listing_id (required), listing_image_id (required).
etsy_listing_image_uploadC
Upload an image to a listing via URL or base64. Rank 1 is the primary image.
Inputs: shop_id (required), listing_id (required), rank, alt_text, +3 more.
etsy_listing_image_upload_urlC
Upload a listing image from a public URL with rank and alt text management
Inputs: shop_id (required), image_url (required), listing_id (required), rank, +3 more.
etsy_listing_inventory_getARead-only
Get the inventory/products for a listing (variations, prices, quantities, SKUs)
Inputs: listing_id (required), shows_scaling.
etsy_listing_inventory_updateB
Update the inventory for a listing — set products, prices, quantities and SKUs
Inputs: products (required), listing_id (required), sku_on_property, price_on_property, +1 more.
etsy_listing_materials_addA
Add materials to a listing (merges with existing)
Inputs: shop_id (required), listing_id (required), new_materials (required).
etsy_listing_materials_getBRead-only
Get all materials listed on a listing
Inputs: shop_id (required), listing_id (required).
etsy_listing_materials_updateB
Replace all materials on a listing (max 13)
Inputs: shop_id (required), materials (required), listing_id (required).
etsy_listing_occasion_getCRead-only
Get the occasion attribute for a listing
Inputs: shop_id (required), listing_id (required).
etsy_listing_occasion_setC
Set the occasion attribute for a listing
Inputs: shop_id (required), occasion (required), listing_id (required).
etsy_listing_offering_getCRead-only
Get a specific offering (price/quantity for a variation) on a listing
Inputs: listing_id (required), product_id (required), product_offering_id (required).
etsy_listing_product_getBRead-only
Get a specific product variant for a listing
Inputs: listing_id (required), product_id (required).
etsy_listing_properties_listCRead-only
List all properties/attributes set on a listing
Inputs: shop_id (required), listing_id (required).
etsy_listing_property_deleteBDestructive
Delete a property from a listing
Inputs: shop_id (required), listing_id (required), property_id (required).
etsy_listing_property_getCRead-only
Get a specific property for a listing
Inputs: shop_id (required), listing_id (required), property_id (required).
etsy_listing_property_updateC
Update a property/attribute on a listing
Inputs: values (required), shop_id (required), value_ids (required), listing_id (required), +2 more.
etsy_listing_renewC
Renew an expired or sold-out listing
Inputs: shop_id (required), listing_id (required).
etsy_listing_reviews_listCRead-only
List reviews for a specific listing
Inputs: listing_id (required), limit, offset.
etsy_listing_set_featured_rankB
Set the featured rank for a listing (0 removes from featured)
Inputs: shop_id (required), listing_id (required), featured_rank (required).
etsy_listings_expired_listCRead-only
List all expired listings for a shop
Inputs: shop_id (required), limit, offset.
etsy_listings_featuredCRead-only
List featured listings for a shop
Inputs: shop_id (required), limit, offset.
etsy_listings_get_by_idsARead-only
Get multiple Etsy listings by an array of listing IDs
Inputs: listing_ids (required), includes.
etsy_listings_inactive_listCRead-only
List all inactive listings for a shop
Inputs: shop_id (required), limit, offset.
etsy_listings_listCRead-only
List active Etsy listings with optional filters
Inputs: limit, offset, sort_on, keywords, +4 more.
etsy_listings_list_by_shopCRead-only
List all listings belonging to a specific shop
Inputs: shop_id (required), limit, state, offset, +3 more.
etsy_listings_searchCRead-only
Search all Etsy listings with full filter support
Inputs: color, limit, offset, sort_on, +10 more.
etsy_listings_stats_bulkARead-only
Get stats for multiple listings at once
Inputs: listing_ids (required).
etsy_listing_stats_getBRead-only
Get stats (views, favorites) for a specific listing
Inputs: shop_id (required), listing_id (required).
etsy_listing_styles_updateC
Update the style attributes on a listing
Inputs: styles (required), shop_id (required), listing_id (required).
etsy_listing_tags_addA
Add tags to a listing (fetches current tags, merges, updates)
Inputs: shop_id (required), new_tags (required), listing_id (required).
etsy_listing_tags_getBRead-only
Get all tags for a listing
Inputs: shop_id (required), listing_id (required).
etsy_listing_tags_updateA
Replace all tags on a listing (max 13 tags, each max 20 chars)
Inputs: tags (required), shop_id (required), listing_id (required).
etsy_listing_translation_createC
Create a translation for a listing
Inputs: shop_id (required), language (required), listing_id (required), tags, +2 more.
etsy_listing_translation_getBRead-only
Get a translation for a listing by language
Inputs: shop_id (required), language (required), listing_id (required).
etsy_listing_translations_listBRead-only
List all translations for a listing
Inputs: shop_id (required), listing_id (required).
etsy_listing_translation_updateC
Update a translation for a listing
Inputs: shop_id (required), language (required), listing_id (required), tags, +2 more.
etsy_listing_unfeatureCDestructive
Remove a listing from the shop's featured listings
Inputs: shop_id (required), listing_id (required).
etsy_listing_updateC
Update an existing listing
Inputs: shop_id (required), listing_id (required), tags, price, +18 more.
etsy_listing_variation_images_getBRead-only
Get variation images (images linked to specific product variations) for a listing
Inputs: shop_id (required), listing_id (required).
etsy_listing_variation_images_updateC
Update (associate) variation images for a listing
Inputs: shop_id (required), listing_id (required), variation_images (required).
etsy_listing_video_deleteBDestructive
Remove a video from a listing
Inputs: shop_id (required), video_id (required), listing_id (required).
etsy_listing_video_getCRead-only
Get a specific video for a listing
Inputs: video_id (required), listing_id (required).
etsy_listing_videos_listARead-only
List all videos for a listing
Inputs: shop_id (required), listing_id (required).
etsy_listing_video_uploadC
Upload a video to a listing
Inputs: shop_id (required), listing_id (required), name, video_id.
etsy_listing_views_getCRead-only
Get view count for a listing
Inputs: listing_id (required).
etsy_payment_account_getBRead-only
Get payment account info for a shop (balance, currency, etc.)
Inputs: shop_id (required).
etsy_payment_getCRead-only
Get a specific payment by ID
Inputs: shop_id (required), payment_id (required).
etsy_payment_ledger_entries_listCRead-only
List financial ledger entries for a shop
Inputs: shop_id (required), limit, offset, max_created, +1 more.
etsy_payment_ledger_entry_getCRead-only
Get a specific ledger entry
Inputs: shop_id (required), ledger_entry_id (required).
etsy_payments_by_receiptARead-only
Get payments associated with a specific receipt
Inputs: shop_id (required), receipt_id (required).
etsy_payments_listCRead-only
List all payments for a shop
Inputs: shop_id (required), limit, offset.
etsy_payout_getCRead-only
Get a specific payout by ID
Inputs: shop_id (required), payout_id (required).
etsy_payouts_listCRead-only
List all payouts for a shop
Inputs: shop_id (required), limit, offset, sort_order, +2 more.
etsy_receipt_getCRead-only
Get a single receipt by ID
Inputs: shop_id (required), receipt_id (required).
etsy_receipt_shipment_createB
Create a shipment / add tracking to a receipt
Inputs: shop_id (required), receipt_id (required), send_bcc, carrier_name, +2 more.
etsy_receipt_shipments_listCRead-only
List all shipments for a receipt
Inputs: shop_id (required), receipt_id (required).
etsy_receipts_listCRead-only
List all receipts (orders) for a shop
Inputs: shop_id (required), limit, offset, sort_on, +9 more.
etsy_receipt_transaction_getARead-only
Get a single transaction by ID
Inputs: shop_id (required), transaction_id (required).
etsy_receipt_transactions_by_receiptBRead-only
List all transactions for a specific receipt
Inputs: shop_id (required), receipt_id (required).
etsy_receipt_transactions_listCRead-only
List all transactions for a shop
Inputs: shop_id (required), limit, offset.
etsy_receipt_updateC
Update a receipt — mark as shipped, add a seller note, etc.
Inputs: shop_id (required), receipt_id (required), was_paid, was_shipped, +1 more.
etsy_shipping_carriers_listBRead-only
List available shipping carriers for a given origin country
Inputs: origin_country_iso (required).
etsy_shipping_profile_destination_createC
Create a destination entry for a shipping profile
Inputs: shop_id (required), primary_cost (required), secondary_cost (required), shipping_profile_id (required), +6 more.
etsy_shipping_profile_destination_deleteCDestructive
Delete a destination from a shipping profile
Inputs: shop_id (required), shipping_profile_id (required), shipping_profile_destination_id (required).
etsy_shipping_profile_destinations_listARead-only
List all destinations for a shipping profile
Inputs: shop_id (required), shipping_profile_id (required).
etsy_shipping_profile_destination_updateC
Update a destination for a shipping profile
Inputs: shop_id (required), shipping_profile_id (required), shipping_profile_destination_id (required), mail_class, +7 more.
etsy_shipping_profile_upgrade_createC
Create a shipping upgrade for a profile
Inputs: name (required), type (required), price (required), shop_id (required), +6 more.
etsy_shipping_profile_upgrade_deleteBDestructive
Delete a shipping upgrade from a profile
Inputs: shop_id (required), upgrade_id (required), shipping_profile_id (required).
etsy_shipping_profile_upgrades_listCRead-only
List all upgrades for a shipping profile
Inputs: shop_id (required), shipping_profile_id (required).
etsy_shipping_profile_upgrade_updateC
Update a shipping upgrade
Inputs: shop_id (required), upgrade_id (required), shipping_profile_id (required), name, +6 more.
etsy_shop_about_getBRead-only
Get the About page information for a shop
Inputs: shop_id (required).
etsy_shop_banner_deleteBDestructive
Delete the banner image for a shop
Inputs: shop_id (required).
etsy_shop_banner_getBRead-only
Get banner image information for a shop
Inputs: shop_id (required).
etsy_shop_findBRead-only
Search for shops by name keyword
Inputs: shop_name (required), limit, offset.
etsy_shop_getARead-only
Get a shop by ID or shop name
Inputs: shop_id (required).
etsy_shop_icon_deleteBDestructive
Delete the icon image for a shop
Inputs: shop_id (required).
etsy_shop_icon_getCRead-only
Get the icon image for a shop
Inputs: shop_id (required).
etsy_shop_listings_by_sectionCRead-only
List listings within a specific shop section
Inputs: shop_id (required), shop_section_id (required), limit, offset.
etsy_shop_listings_searchCRead-only
Search listings within a specific shop
Inputs: shop_id (required), limit, offset, sort_on, +5 more.
etsy_shop_listing_transactions_listCRead-only
List transactions for a specific listing
Inputs: shop_id (required), listing_id (required).
etsy_shop_payment_summaryCRead-only
Get payment account balance and summary for a shop
Inputs: shop_id (required).
etsy_shop_production_partner_createB
Create a new production partner for a shop
Inputs: shop_id (required), location (required), partner_name (required), is_unlisted.
etsy_shop_production_partner_deleteADestructive
Delete a production partner from a shop
Inputs: shop_id (required), production_partner_id (required).
etsy_shop_production_partners_listARead-only
List all production partners for a shop
Inputs: shop_id (required).
etsy_shop_production_partner_updateC
Update a production partner for a shop
Inputs: shop_id (required), production_partner_id (required), location, is_unlisted, +1 more.
etsy_shop_receipt_summaryBRead-only
Get a summary of order/receipt counts by status for a shop
Inputs: shop_id (required), max_created, min_created.
etsy_shop_receipt_transactions_listBRead-only
List all transactions for a specific receipt in a shop
Inputs: shop_id (required), receipt_id (required).
etsy_shop_return_policies_listBRead-only
List all return policies for a shop
Inputs: shop_id (required).
etsy_shop_return_policy_createC
Create a new return policy for a shop
Inputs: shop_id (required), accepts_returns (required), accepts_exchanges (required), return_deadline.
etsy_shop_return_policy_deleteBDestructive
Delete a return policy from a shop
Inputs: shop_id (required), return_policy_id (required).
etsy_shop_return_policy_getCRead-only
Get a specific return policy for a shop
Inputs: shop_id (required), return_policy_id (required).
etsy_shop_return_policy_updateC
Update a return policy for a shop
Inputs: shop_id (required), return_policy_id (required), accepts_returns, return_deadline, +1 more.
etsy_shop_reviews_listCRead-only
List reviews for a shop
Inputs: shop_id (required), limit, offset, max_created, +1 more.
etsy_shops_by_ownerBRead-only
Get all shops owned by a specific user
Inputs: user_id (required), limit, offset.
etsy_shop_section_createC
Create a new section in a shop
Inputs: title (required), shop_id (required).
etsy_shop_section_deleteCDestructive
Delete a section from a shop
Inputs: shop_id (required), shop_section_id (required).
etsy_shop_section_getCRead-only
Get a specific section in a shop
Inputs: shop_id (required), shop_section_id (required).
etsy_shop_sections_listARead-only
List all sections in a shop
Inputs: shop_id (required).
etsy_shop_section_updateC
Update a shop section
Inputs: shop_id (required), shop_section_id (required), title.
etsy_shop_shipping_profile_createC
Create a shipping profile for a shop
Inputs: title (required), shop_id (required), primary_cost (required), secondary_cost (required), +11 more.
etsy_shop_shipping_profile_deleteCDestructive
Delete a shipping profile from a shop
Inputs: shop_id (required), shipping_profile_id (required).
etsy_shop_shipping_profile_getCRead-only
Get a specific shipping profile
Inputs: shop_id (required), shipping_profile_id (required).
etsy_shop_shipping_profiles_listCRead-only
List all shipping profiles for a shop
Inputs: shop_id (required).
etsy_shop_shipping_profile_updateC
Update a shipping profile
Inputs: shop_id (required), shipping_profile_id (required), title, primary_cost, +7 more.
etsy_shop_stats_getCRead-only
Get high-level stats for a shop (listing count, transaction count, review summary)
Inputs: shop_id (required).
etsy_shop_updateC
Update a shop's profile information
Inputs: shop_id (required), title, announcement, sale_message, +9 more.
etsy_taxonomy_node_getCRead-only
Get a specific taxonomy node by ID
Inputs: taxonomy_id (required).
etsy_taxonomy_properties_getBRead-only
Get all available properties (attributes) for a specific taxonomy node
Inputs: taxonomy_id (required).
etsy_taxonomy_properties_listBRead-only
List all properties for a taxonomy node
Inputs: taxonomy_id (required).
etsy_taxonomy_property_scalesARead-only
Get scales for a taxonomy property (e.g. weight units, dimension units)
Inputs: taxonomy_id (required), scale_id.
etsy_taxonomy_seller_listARead-only
List all seller taxonomy nodes (categories for listings)
Inputs: no named parameters.
etsy_user_address_deleteCDestructive
Delete a user address
Inputs: user_id (required), user_address_id (required).
etsy_user_addresses_listBRead-only
List all addresses for a user
Inputs: user_id (required), limit, offset.
etsy_user_address_getCRead-only
Get a specific address for a user
Inputs: user_id (required), user_address_id (required).
etsy_user_favorite_listing_addB
Add a listing to a user's favorites
Inputs: user_id (required), listing_id (required).
etsy_user_favorite_listing_getBRead-only
Check if a specific listing is in a user's favorites
Inputs: user_id (required), listing_id (required).
etsy_user_favorite_listing_removeBDestructive
Remove a listing from a user's favorites
Inputs: user_id (required), listing_id (required).
etsy_user_favorite_listings_listBRead-only
List a user's favorited listings
Inputs: user_id (required), limit, offset.
etsy_user_favorite_shop_addC
Add a shop to a user's favorites
Inputs: shop_id (required), user_id (required).
etsy_user_favorite_shop_getARead-only
Check if a specific shop is in a user's favorites
Inputs: shop_id (required), user_id (required).
etsy_user_favorite_shop_removeCDestructive
Remove a shop from a user's favorites
Inputs: shop_id (required), user_id (required).
etsy_user_favorite_shops_listCRead-only
List a user's favorited shops
Inputs: user_id (required), limit, offset.
etsy_user_getARead-only
Get a user by ID
Inputs: user_id (required).
etsy_user_meARead-only
Get the currently authenticated user
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 146 tools
Many tools target similar resources (e.g., multiple listing tools like feature, unfeature, set_featured_rank) which could cause confusion. However, tool names and descriptions generally clarify distinctions, so some overlap remains but is manageable.
The naming follows a consistent etsy_{resource}_{action} pattern using snake_case, with few exceptions like 'featured_listings_list' vs 'listings_featured'. The pattern is clear and predictable overall.
146 tools is far beyond the typical MCP server scope (3-15). This volume is overwhelming and likely to cause cognitive overload and navigation difficulty for agents.
The tool set covers nearly all aspects of the Etsy API: listing management (CRUD, media, variations, translations, stats), shops, payment/ledger, receipts, shipping, taxonomy, users, and favorites. Few obvious gaps exist.
Related MCP Connectors
Hosted MCP server for 3Dsellers, the multichannel selling platform. Connect Claude, ChatGPT, Cursor, VS Code or any MCP client and manage your eBay, Amazon, Walmart, Etsy, Shopify, WooCommerce and TikTok Shop stores in plain language: search and update products, publish listings, sync inventory, tag and track orders, run bulk actions and CSV imports, and reply to customer messages. 120+ tools. Sign in with OAuth or a personal token. No eBay developer account and nothing to install. Setup guides and config examples for every client: https://github.com/3dsellers/ebay-mcp-server
Etsy MCP — public listing search via Etsy Open API v3 (api_key auth only)
Live Etsy data, read-only: listing and shop checks, shop sales count, top shops, tags and fees.
Etsy search + Etsy shop sales: live listing rows and sales counters via Apify MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceA production-grade MCP server that enables AI assistants like Claude to read Etsy shop data—listings, orders, inventory, and stats—through eight read-only tools, using OAuth and automatic pagination.8MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for interacting with the Etsy API, enabling listing management, shop information, shipping profiles, and image uploads.14ISC
- AlicenseNot gradedqualityDmaintenanceMCP server for interacting with the Etsy API. Allows users to retrieve shop data, manage listings, and perform various Etsy operations through natural language.MIT
- AlicenseAqualityDmaintenanceA full-featured MCP server for the Etsy Open API v3 that enables managing an Etsy shop, including listings, inventory, images, digital files, and orders, through Claude or any MCP-compatible client.262MIT