Skip to main content
Glama

@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

  • readOnlyHint on all GET/list operations

  • destructiveHint on all delete operations

  • Cursor/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

etsy_listings_list

List active listings with filters

etsy_listing_get

Get a single listing

etsy_listings_get_by_ids

Batch-fetch listings by IDs

etsy_listings_list_by_shop

List all listings in a shop

etsy_listing_create

Create a new listing

etsy_listing_update

Update a listing

etsy_listing_delete

Delete a listing

etsy_listings_featured

Get featured listings

Listing Images

Tool

Description

etsy_listing_images_list

List images for a listing

etsy_listing_image_get

Get a specific image

etsy_listing_image_upload

Upload an image via URL

etsy_listing_image_delete

Delete an image

etsy_listing_images_reorder

Reorder listing images

Listing Videos

Tool

Description

etsy_listing_videos_list

List videos

etsy_listing_video_get

Get a specific video

etsy_listing_video_upload

Upload/attach a video

etsy_listing_video_delete

Remove a video

Listing Inventory

Tool

Description

etsy_listing_inventory_get

Get inventory (variations, prices, quantities)

etsy_listing_inventory_update

Update inventory

Listing Properties

Tool

Description

etsy_listing_properties_list

List properties

etsy_listing_property_get

Get a property

etsy_listing_property_update

Update a property

etsy_listing_property_delete

Delete a property

Digital Files

Tool

Description

etsy_listing_files_list

List digital download files

etsy_listing_file_get

Get a file

etsy_listing_file_upload

Upload a digital file

etsy_listing_file_delete

Delete a file

Translations

Tool

Description

etsy_listing_translations_list

List translations

etsy_listing_translation_get

Get a translation

etsy_listing_translation_create

Create translation

etsy_listing_translation_update

Update translation

Variation Images

Tool

Description

etsy_listing_variation_images_get

Get variation images

etsy_listing_variation_images_update

Update variation images

Shops

Tool

Description

etsy_shop_get

Get a shop

etsy_shop_update

Update a shop

etsy_shops_by_owner

Get shops by user

etsy_shop_find

Search shops by name

Shop Sections

Tool

Description

etsy_shop_sections_list

List sections

etsy_shop_section_get

Get a section

etsy_shop_section_create

Create a section

etsy_shop_section_update

Update a section

etsy_shop_section_delete

Delete a section

Shop About, Production Partners, Return Policies

Tool

Description

etsy_shop_about_get

Get shop About page

etsy_shop_production_partners_list

List production partners

etsy_shop_production_partner_create

Create partner

etsy_shop_production_partner_update

Update partner

etsy_shop_production_partner_delete

Delete partner

etsy_shop_return_policies_list

List return policies

etsy_shop_return_policy_get

Get a policy

etsy_shop_return_policy_create

Create policy

etsy_shop_return_policy_update

Update policy

etsy_shop_return_policy_delete

Delete policy

Shipping Profiles

Tool

Description

etsy_shop_shipping_profiles_list

List profiles

etsy_shop_shipping_profile_get

Get a profile

etsy_shop_shipping_profile_create

Create profile

etsy_shop_shipping_profile_update

Update profile

etsy_shop_shipping_profile_delete

Delete profile

etsy_shipping_profile_destinations_list

List destinations

etsy_shipping_profile_destination_create

Create destination

etsy_shipping_profile_destination_update

Update destination

etsy_shipping_profile_destination_delete

Delete destination

etsy_shipping_profile_upgrades_list

List upgrades

etsy_shipping_profile_upgrade_create

Create upgrade

etsy_shipping_profile_upgrade_update

Update upgrade

etsy_shipping_profile_upgrade_delete

Delete upgrade

etsy_shipping_carriers_list

List shipping carriers

Orders & Receipts

Tool

Description

etsy_receipts_list

List orders/receipts

etsy_receipt_get

Get a receipt

etsy_receipt_update

Update receipt (ship, note)

etsy_receipt_transactions_list

List transactions

etsy_receipt_transaction_get

Get a transaction

etsy_receipt_transactions_by_receipt

Transactions for a receipt

etsy_receipt_shipments_list

List shipments

etsy_receipt_shipment_create

Add tracking

etsy_shop_receipt_transactions_list

Receipt transactions in shop

etsy_shop_listing_transactions_list

Listing transactions

Payments & Finance

Tool

Description

etsy_payments_list

List payments

etsy_payment_get

Get a payment

etsy_payments_by_receipt

Payments for a receipt

etsy_payment_ledger_entries_list

List ledger entries

etsy_payment_ledger_entry_get

Get a ledger entry

etsy_payment_account_get

Get payment account

etsy_ledger_entries_list

List ledger entries (alt)

etsy_ledger_entry_get

Get ledger entry

etsy_ledger_entry_payment_get

Payment for ledger entry

etsy_payouts_list

List payouts

etsy_payout_get

Get a payout

Reviews

Tool

Description

etsy_shop_reviews_list

Shop reviews

etsy_listing_reviews_list

Listing reviews

Users & Addresses

Tool

Description

etsy_user_get

Get a user

etsy_user_me

Get authenticated user

etsy_user_addresses_list

List addresses

etsy_user_address_get

Get an address

etsy_user_address_delete

Delete an address

Taxonomy & Discovery

Tool

Description

etsy_taxonomy_seller_list

List seller taxonomy

etsy_taxonomy_node_get

Get a taxonomy node

etsy_taxonomy_properties_list

List taxonomy properties

etsy_taxonomy_properties_get

Get properties for node

etsy_buyer_taxonomy_list

List buyer taxonomy

etsy_buyer_taxonomy_node_get

Get buyer taxonomy node

etsy_listings_search

Global listing search

etsy_shop_listings_search

Search within a shop

etsy_shop_listings_by_section

Listings by section

Favorites

Tool

Description

etsy_user_favorite_listings_list

List favorited listings

etsy_user_favorite_listing_get

Check if listing is favorited

etsy_user_favorite_listing_add

Favorite a listing

etsy_user_favorite_listing_remove

Unfavorite a listing

etsy_user_favorite_shops_list

List favorited shops

etsy_user_favorite_shop_get

Check if shop is favorited

etsy_user_favorite_shop_add

Favorite a shop

etsy_user_favorite_shop_remove

Unfavorite a shop

Images, Media & Icons

Tool

Description

etsy_listing_image_upload_url

Upload image from URL

etsy_listing_image_set_rank

Set image display rank

etsy_listing_image_update_alt

Update image alt text

etsy_shop_icon_get

Get shop icon

etsy_shop_icon_delete

Delete shop icon

etsy_shop_banner_get

Get shop banner

etsy_shop_banner_delete

Delete shop banner

Listing Lifecycle & Content

Tool

Description

etsy_listing_drafts_list

List draft listings

etsy_listing_draft_create

Create a draft

etsy_listing_draft_publish

Publish a draft

etsy_listing_renew

Renew an expired listing

etsy_listings_expired_list

List expired listings

etsy_listings_inactive_list

List inactive listings

etsy_listing_stats_get

Get listing stats

etsy_listing_views_get

Get view count

etsy_listings_stats_bulk

Bulk listing stats

etsy_featured_listings_list

List featured listings

etsy_listing_set_featured_rank

Set featured rank

etsy_listing_feature

Feature a listing

etsy_listing_unfeature

Unfeature a listing

etsy_listing_tags_get

Get listing tags

etsy_listing_tags_update

Replace tags

etsy_listing_tags_add

Add tags

etsy_listing_materials_get

Get materials

etsy_listing_materials_update

Replace materials

etsy_listing_materials_add

Add materials

etsy_listing_occasion_get

Get occasion

etsy_listing_occasion_set

Set occasion

etsy_listing_styles_update

Update styles

Shop Analytics

Tool

Description

etsy_shop_stats_get

Shop-level stats

etsy_shop_receipt_summary

Order summary

etsy_shop_payment_summary

Payment account summary

Products & Offerings

Tool

Description

etsy_listing_offering_get

Get a product offering

etsy_listing_product_get

Get a product variant


Setup

1. Get an Etsy API Key

  1. Visit Etsy Developer Portal

  2. Click Create a New App

  3. Note your API Key (Keystring)

  4. For write operations, set up OAuth 2.0 and obtain an access token

2. Install

npm install
npm run build

3. Configure

cp .env.example .env
# Edit .env with your credentials
ETSY_API_KEY=your_etsy_api_key_here
ETSY_ACCESS_TOKEN=your_oauth_access_token_here  # Optional: for write operations

4. Run

npm start

Or with npx:

ETSY_API_KEY=<key> node dist/main.js

MCP 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.ts

Development

npm run dev     # ts-node (no build step)
npm run build   # TypeScript compile → dist/
npm run lint    # ESLint

License

MIT — see LICENSE

Available Tools

146 tools
etsy_buyer_taxonomy_listA
Read-only

List all buyer taxonomy nodes (categories for browsing/discovery)

Inputs: no named parameters.

etsy_buyer_taxonomy_node_getA
Read-only

Get a specific buyer taxonomy node by ID

Inputs: taxonomy_id (required).

etsy_ledger_entries_listC
Read-only

List all financial ledger entries for a shop

Inputs: shop_id (required), limit, offset, max_created, +1 more.

etsy_ledger_entry_getC
Read-only

Get a specific ledger entry

Inputs: shop_id (required), ledger_entry_id (required).

etsy_ledger_entry_payment_getC
Read-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_deleteC
Destructive

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_listC
Read-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_deleteB
Destructive

Delete a digital file from a listing

Inputs: shop_id (required), listing_id (required), listing_file_id (required).

etsy_listing_file_getC
Read-only

Get a specific digital file attached to a listing

Inputs: shop_id (required), listing_id (required), listing_file_id (required).

etsy_listing_files_listB
Read-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_getB
Read-only

Get a single Etsy listing by ID

Inputs: listing_id (required), includes.

etsy_listing_image_deleteB
Destructive

Delete an image from a listing

Inputs: shop_id (required), listing_id (required), listing_image_id (required).

etsy_listing_image_getC
Read-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_listB
Read-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_getA
Read-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_getB
Read-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_getC
Read-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_getC
Read-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_getB
Read-only

Get a specific product variant for a listing

Inputs: listing_id (required), product_id (required).

etsy_listing_properties_listC
Read-only

List all properties/attributes set on a listing

Inputs: shop_id (required), listing_id (required).

etsy_listing_property_deleteB
Destructive

Delete a property from a listing

Inputs: shop_id (required), listing_id (required), property_id (required).

etsy_listing_property_getC
Read-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_listC
Read-only

List reviews for a specific listing

Inputs: listing_id (required), limit, offset.

etsy_listings_expired_listC
Read-only

List all expired listings for a shop

Inputs: shop_id (required), limit, offset.

etsy_listings_get_by_idsA
Read-only

Get multiple Etsy listings by an array of listing IDs

Inputs: listing_ids (required), includes.

etsy_listings_inactive_listC
Read-only

List all inactive listings for a shop

Inputs: shop_id (required), limit, offset.

etsy_listings_listC
Read-only

List active Etsy listings with optional filters

Inputs: limit, offset, sort_on, keywords, +4 more.

etsy_listings_list_by_shopC
Read-only

List all listings belonging to a specific shop

Inputs: shop_id (required), limit, state, offset, +3 more.

etsy_listings_stats_bulkA
Read-only

Get stats for multiple listings at once

Inputs: listing_ids (required).

etsy_listing_stats_getB
Read-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_getB
Read-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_getB
Read-only

Get a translation for a listing by language

Inputs: shop_id (required), language (required), listing_id (required).

etsy_listing_translations_listB
Read-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_unfeatureC
Destructive

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_getB
Read-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_deleteB
Destructive

Remove a video from a listing

Inputs: shop_id (required), video_id (required), listing_id (required).

etsy_listing_video_getC
Read-only

Get a specific video for a listing

Inputs: video_id (required), listing_id (required).

etsy_listing_videos_listA
Read-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_getC
Read-only

Get view count for a listing

Inputs: listing_id (required).

etsy_payment_account_getB
Read-only

Get payment account info for a shop (balance, currency, etc.)

Inputs: shop_id (required).

etsy_payment_getC
Read-only

Get a specific payment by ID

Inputs: shop_id (required), payment_id (required).

etsy_payment_ledger_entries_listC
Read-only

List financial ledger entries for a shop

Inputs: shop_id (required), limit, offset, max_created, +1 more.

etsy_payment_ledger_entry_getC
Read-only

Get a specific ledger entry

Inputs: shop_id (required), ledger_entry_id (required).

etsy_payments_by_receiptA
Read-only

Get payments associated with a specific receipt

Inputs: shop_id (required), receipt_id (required).

etsy_payments_listC
Read-only

List all payments for a shop

Inputs: shop_id (required), limit, offset.

etsy_payout_getC
Read-only

Get a specific payout by ID

Inputs: shop_id (required), payout_id (required).

etsy_payouts_listC
Read-only

List all payouts for a shop

Inputs: shop_id (required), limit, offset, sort_order, +2 more.

etsy_receipt_getC
Read-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_listC
Read-only

List all shipments for a receipt

Inputs: shop_id (required), receipt_id (required).

etsy_receipts_listC
Read-only

List all receipts (orders) for a shop

Inputs: shop_id (required), limit, offset, sort_on, +9 more.

etsy_receipt_transaction_getA
Read-only

Get a single transaction by ID

Inputs: shop_id (required), transaction_id (required).

etsy_receipt_transactions_by_receiptB
Read-only

List all transactions for a specific receipt

Inputs: shop_id (required), receipt_id (required).

etsy_receipt_transactions_listC
Read-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_listB
Read-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_deleteC
Destructive

Delete a destination from a shipping profile

Inputs: shop_id (required), shipping_profile_id (required), shipping_profile_destination_id (required).

etsy_shipping_profile_destinations_listA
Read-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_deleteB
Destructive

Delete a shipping upgrade from a profile

Inputs: shop_id (required), upgrade_id (required), shipping_profile_id (required).

etsy_shipping_profile_upgrades_listC
Read-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_getB
Read-only

Get the About page information for a shop

Inputs: shop_id (required).

etsy_shop_banner_deleteB
Destructive

Delete the banner image for a shop

Inputs: shop_id (required).

etsy_shop_banner_getB
Read-only

Get banner image information for a shop

Inputs: shop_id (required).

etsy_shop_findB
Read-only

Search for shops by name keyword

Inputs: shop_name (required), limit, offset.

etsy_shop_getA
Read-only

Get a shop by ID or shop name

Inputs: shop_id (required).

etsy_shop_icon_deleteB
Destructive

Delete the icon image for a shop

Inputs: shop_id (required).

etsy_shop_icon_getC
Read-only

Get the icon image for a shop

Inputs: shop_id (required).

etsy_shop_listings_by_sectionC
Read-only

List listings within a specific shop section

Inputs: shop_id (required), shop_section_id (required), limit, offset.

etsy_shop_listing_transactions_listC
Read-only

List transactions for a specific listing

Inputs: shop_id (required), listing_id (required).

etsy_shop_payment_summaryC
Read-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_deleteA
Destructive

Delete a production partner from a shop

Inputs: shop_id (required), production_partner_id (required).

etsy_shop_production_partners_listA
Read-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_summaryB
Read-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_listB
Read-only

List all transactions for a specific receipt in a shop

Inputs: shop_id (required), receipt_id (required).

etsy_shop_return_policies_listB
Read-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_deleteB
Destructive

Delete a return policy from a shop

Inputs: shop_id (required), return_policy_id (required).

etsy_shop_return_policy_getC
Read-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_listC
Read-only

List reviews for a shop

Inputs: shop_id (required), limit, offset, max_created, +1 more.

etsy_shops_by_ownerB
Read-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_deleteC
Destructive

Delete a section from a shop

Inputs: shop_id (required), shop_section_id (required).

etsy_shop_section_getC
Read-only

Get a specific section in a shop

Inputs: shop_id (required), shop_section_id (required).

etsy_shop_sections_listA
Read-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_deleteC
Destructive

Delete a shipping profile from a shop

Inputs: shop_id (required), shipping_profile_id (required).

etsy_shop_shipping_profile_getC
Read-only

Get a specific shipping profile

Inputs: shop_id (required), shipping_profile_id (required).

etsy_shop_shipping_profiles_listC
Read-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_getC
Read-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_getC
Read-only

Get a specific taxonomy node by ID

Inputs: taxonomy_id (required).

etsy_taxonomy_properties_getB
Read-only

Get all available properties (attributes) for a specific taxonomy node

Inputs: taxonomy_id (required).

etsy_taxonomy_properties_listB
Read-only

List all properties for a taxonomy node

Inputs: taxonomy_id (required).

etsy_taxonomy_property_scalesA
Read-only

Get scales for a taxonomy property (e.g. weight units, dimension units)

Inputs: taxonomy_id (required), scale_id.

etsy_taxonomy_seller_listA
Read-only

List all seller taxonomy nodes (categories for listings)

Inputs: no named parameters.

etsy_user_address_deleteC
Destructive

Delete a user address

Inputs: user_id (required), user_address_id (required).

etsy_user_addresses_listB
Read-only

List all addresses for a user

Inputs: user_id (required), limit, offset.

etsy_user_address_getC
Read-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_getB
Read-only

Check if a specific listing is in a user's favorites

Inputs: user_id (required), listing_id (required).

etsy_user_favorite_listing_removeB
Destructive

Remove a listing from a user's favorites

Inputs: user_id (required), listing_id (required).

etsy_user_favorite_listings_listB
Read-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_getA
Read-only

Check if a specific shop is in a user's favorites

Inputs: shop_id (required), user_id (required).

etsy_user_favorite_shop_removeC
Destructive

Remove a shop from a user's favorites

Inputs: shop_id (required), user_id (required).

etsy_user_favorite_shops_listC
Read-only

List a user's favorited shops

Inputs: user_id (required), limit, offset.

etsy_user_getA
Read-only

Get a user by ID

Inputs: user_id (required).

etsy_user_meA
Read-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

    C2.8/5.0

    Scored across 146 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      8
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for interacting with the Etsy API, enabling listing management, shop information, shipping profiles, and image uploads.
      14
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for interacting with the Etsy API. Allows users to retrieve shop data, manage listings, and perform various Etsy operations through natural language.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      26
      2
      MIT