Etsy MCP server for your AI

Publish drafts, retune inventory and pricing, mark receipts shipped with tracking, edit shipping profiles, and read the payment ledger for the shop you authorize.

PopMCPEtsy

Show last month's paid receipts and what actually landed in my payout ledger

Contact support Connect

Supported Etsy tools

Every listing, order, fulfillment, policy, payment and review operation the Open API v3 exposes, plus the shop events PopMCP can watch.

etsy_create_draft_listing

Creates a physical draft listing product in a shop on the Etsy channel.

etsy_delete_listing

Open API V3 endpoint to delete a ShopListing.

etsy_find_all_active_listings_by_shop

Retrieves a list of all active listings on Etsy in a specific shop, paginated by listing creation date.

etsy_find_all_listings_active

A list of all active listings on Etsy paginated by their creation date.

etsy_get_listing

Retrieves a listing record by listing ID.

etsy_get_listings_by_listing_ids

Allows to query multiple listing ids at once.

etsy_get_listings_by_shop

Endpoint to list Listings that belong to a Shop.

etsy_update_listing

Updates a listing, identified by a listing ID, for a specific shop identified by a shop ID.

etsy_create_shop_shipping_profile

Creates a new ShippingProfile.

etsy_get_shop_shipping_profiles

Retrieves a list of shipping profiles available in the specific Etsy shop identified by its shop ID.

etsy_get_shop_return_policies

Returns a shop's list of existing Return Policies

etsy_create_shop_section

Creates a new section in a specific shop.

etsy_get_shop_sections

Retrieves the list of shop sections in a specific shop identified by shop ID.

etsy_create_receipt_shipment

Submits tracking information for a Shop Receipt, which creates a Shop Receipt Shipment entry for the given receiptid.

etsy_find_shops

Open API V3 endpoint for searching shops by name.

etsy_get_shop

Retrieves the shop identified by a specific shop ID.

etsy_get_shop_by_owner_user_id

Retrieves the shop identified by the shop owner's user ID.

etsy_get_shop_receipt

Retrieves a receipt, identified by a receipt id, from an Etsy shop.

etsy_get_shop_receipt_transactions_by_shop

Retrieves the list of transactions associated with a shop.

etsy_get_shop_receipts

Requests the Shop Receipts from a specific Shop, unfiltered or filtered by receipt id range or offset, date, paid, and/or shipped purchases.

etsy_update_shop_receipt

Updates the status of a receipt, identified by a receipt id, from an Etsy shop.

etsy_get_listing_images

Retrieves all listing image resources for a listing with a specific listing ID.

etsy_get_payments

Retrieves a list of payments from a shop identified by shopid.

etsy_get_listing_inventory

Retrieves the inventory record for a listing.

etsy_get_me

Returns basic info for the user making the request.

etsy_get_properties_by_taxonomy_id

Retrieves a list of product properties, with applicable scales and values, supported for a specific seller taxonomy ID.

etsy_get_reviews_by_shop

Open API V3 to retrieve the reviews from a shop given its ID.

etsy_get_seller_taxonomy_nodes

Retrieves the full hierarchy tree of seller taxonomy nodes.

etsy_get_shop_payment_account_ledger_entries

Get a Shop Payment Account Ledger's Entries

etsy_update_listing_inventory

Updates the inventory for a listing identified by a listing ID.

etsy_delete_listing_property

Deletes a property for a Listing.

etsy_get_featured_listings_by_shop

Retrieves Listings associated to a Shop that are featured.

etsy_get_listing_properties

Get a listing's properties

etsy_get_listing_property

[Feedback only] Retrieves a listing's property

etsy_get_listings_by_shop_receipt

Gets all listings associated with a receipt.

etsy_get_listings_by_shop_return_policy

Gets all listings associated with a Return Policy.

etsy_get_listings_by_shop_section_id

Retrieves all the listings from the section of a specific shop.

etsy_update_listing_property

Updates or populates the properties list defining product offerings for a listing.

etsy_create_shop_shipping_profile_destination

Creates a new shipping destination, which sets the shipping cost, carrier, and class for a destination in a shipping profile.

etsy_create_shop_shipping_profile_upgrade

Creates a new shipping profile upgrade, which can establish a price for a shipping option, such as an alternate carrier or faster delivery.

etsy_delete_shop_shipping_profile

Deletes a ShippingProfile by given id.

etsy_delete_shop_shipping_profile_destination

Deletes a shipping destination and removes the destination option from every listing that uses the associated shipping profile.

etsy_delete_shop_shipping_profile_upgrade

Deletes a shipping profile upgrade and removes the upgrade option from every listing that uses the associated shipping profile.

etsy_get_shipping_carriers

Retrieves a list of available shipping carriers and the mail classes associated with them for a given country

etsy_get_shop_shipping_profile

Retrieves a Shipping Profile referenced by shipping profile ID.

etsy_get_shop_shipping_profile_destinations_by_shipping_profile

Retrieves a list of shipping destination objects associated with a shipping profile.

etsy_get_shop_shipping_profile_upgrades

Retrieves the list of shipping profile upgrades assigned to a specific shipping profile.

etsy_update_shop_shipping_profile

Changes the settings in a shipping profile.

etsy_update_shop_shipping_profile_destination

Updates an existing shipping destination, which can set or reassign the shipping cost, carrier, and class for a destination.

etsy_update_shop_shipping_profile_upgrade

Updates a shipping profile upgrade and updates any listings that use the shipping profile.

etsy_consolidate_shop_return_policies

Consolidates Return Policies by moving all listings from a source return policy to a destination return policy, and deleting the source return policy.

etsy_create_shop_return_policy

Creates a new Return Policy.

etsy_delete_shop_return_policy

Deletes an existing Return Policy.

etsy_get_shop_return_policy

Retrieves an existing Return Policy.

etsy_update_shop_return_policy

Updates an existing Return Policy.

etsy_create_shop_readiness_state_definition

Creates a new ReadinessStateDefinition.

etsy_delete_shop_readiness_state_definition

Deletes a ReadinessStateDefinition by given readiness state definition ID.

etsy_delete_shop_section

Deletes a section in a specific shop given a valid shopsectionid.

etsy_get_shop_readiness_state_definition

Retrieves a ProcessingProfile referenced by readiness state definition ID.

etsy_get_shop_readiness_state_definitions

Retrieves a list of ProcessingProfiles available in the specific Etsy shop identified by its shop ID.

etsy_get_shop_section

Retrieves a shop section, referenced by section ID and shop ID.

etsy_update_shop_readiness_state_definition

Updates an existing ReadinessStateDefinition.

etsy_update_shop_section

Updates a section in a specific shop given a valid shopsectionid.

etsy_get_shop_receipt_transaction

Retrieves a transaction by transaction ID.

etsy_get_shop_receipt_transactions_by_listing

Retrieves the list of transactions associated with a listing.

etsy_get_shop_receipt_transactions_by_receipt

Retrieves the list of transactions associated with a specific receipt.

etsy_update_shop

Updates a shop.

etsy_create_listing_translation

Creates a ListingTranslation by listingid and language

etsy_delete_listing_file

Deletes a file from a specific listing.

etsy_delete_listing_image

Open API V3 endpoint to delete a listing image.

etsy_delete_listing_personalization

Deletes personalization for a listing.

etsy_delete_listing_video

Open API V3 endpoint to delete a listing video.

etsy_delete_user_address

Open API V3 endpoint to delete a UserAddress for a User.

etsy_get_all_listing_files

Retrieves all the files associated with the given digital listing.

etsy_get_listing_file

Retrieves a single file associated with the given digital listing.

etsy_get_listing_image

Retrieves the references and metadata for a listing image with a specific image ID.

etsy_get_listing_personalization

Retrieves a listing's personalization questions by listing ID.

etsy_get_listing_translation

Get a Translation for a Listing in the given language

etsy_get_listing_video

Retrieves a single video associated with the given listing.

etsy_get_listing_videos

Retrieves all listing video resources for a listing with a specific listing ID.

etsy_get_payment_account_ledger_entry_payments

Get a Payment from a PaymentAccount Ledger Entry ID, if applicable

etsy_get_shop_payment_by_receipt_id

Retrieves a payment from a specific receipt, identified by receiptid, from a specific shop, identified by shopid

etsy_get_user_address

Open API V3 endpoint to retrieve a UserAddress for a User.

etsy_get_user_addresses

Open API V3 endpoint to retrieve UserAddresses for a User.

etsy_update_listing_personalization

Creates or updates personalization settings for a listing, allowing the seller to collect personalization from the buyer.

etsy_update_listing_translation

Updates a ListingTranslation by listingid and language

etsy_get_buyer_taxonomy_nodes

Retrieves the full hierarchy tree of buyer taxonomy nodes.

etsy_get_holiday_preferences

Retrieves a list of holidays that are available to a shop to set a preference for.

etsy_get_listing_variation_images

Gets all variation images on a listing.

etsy_get_properties_by_buyer_taxonomy_id

Retrieves a list of product properties, with applicable scales and values, supported for a specific buyer taxonomy ID.

etsy_get_reviews_by_listing

Open API V3 to retrieve the reviews for a listing given its ID.

etsy_get_shop_payment_account_ledger_entry

Get a single Shop Payment Account Ledger's Entry

etsy_get_user

Retrieves an user profile based on an unique user ID.

etsy_ping

Check to confirm connectivity to the Etsy API with an application

etsy_token_scopes

Check the scopes of the provided token

etsy_update_holiday_preferences

Updates the preference for whether the seller will process orders or not on the holiday.

etsy_update_variation_images

Creates variation images on a listing.

etsy_get_listing_offering

Get an Offering for a Listing

etsy_get_listing_product

Open API V3 endpoint to retrieve a ListingProduct by ID.

etsy_get_shop_production_partners

Retrieves a list of production partners available in the specific Etsy shop identified by its shop ID.

Connect Etsy to your AI

Authorize once, then an endpoint your client signs into. Nothing to deploy, and nothing to install on the Etsy side.

Bring your own Etsy app: enter its API Key (keystring) and Shared Secret, then authorize in the browser. Etsy handles login and shop selection, no password is shared, and the connection is locked to that one shop.

Auth typeyour-etsy-value

API Key (keystring)abc123def456ghi789jkl012

Shared Secret••••••••••••3f7a

Authorize PopMCP on EtsyAuthorize

Drop the PopMCP URL into Claude, ChatGPT, Codex or any other supported client. It signs in through PopMCP with OAuth, so your Etsy credential never leaves the server.

app.popmcp.com/mcp/…

Claude wants to connectApprove

Ask for something harmless before you turn writes on. Once it comes back clean, widen the tool set or switch the connection to full access.

Show last month's paid receipts and what actually landed in my payout ledger

etsy_get_shop_receiptsok

Then just ask for the work

“Show last month's paid receipts and what actually landed in my payout ledger”
- get_shop_receipts
- get_payments
- get_shop_payment_account_ledger_entries
“Mark every paid order from this week as shipped and attach the tracking numbers”
- get_shop_receipts
- create_receipt_shipment
- update_shop_receipt
“Draft a linen apron listing using my standard shipping profile and stock levels”
- get_shop_shipping_profiles
- create_draft_listing
- update_listing_inventory
“Which reviews under 4 stars mention listings in my Ceramics section”
- get_reviews_by_shop
- get_shop_sections
- get_listings_by_shop_section_id
- get_listing

Contact support View docs

Use Etsy from the assistant you already open

One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.

Claude DesktopCustom connector

Add the PopMCP URL under Settings → Connectors and the tools appear in every chat.

Claude WebCustom connector

The same endpoint, registered in the browser. Nothing to install on the machine you are working from.

ChatGPTCustom connector

CodexDesktop & CLI

Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.

OpenCodeCoding agent

ZCodeDesktop app

Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.

Contact support View docs

FAQ

Etsy MCP server questions

What teams ask before putting Etsy behind an AI client.

What does the connect form ask for?

You connect with your own Etsy app, so the form asks for its API Key (keystring) and its Shared Secret, alongside an optional Auth type display field. From there the flow is an OAuth redirect: you authorize PopMCP in your browser and Etsy handles the login itself, so no password is shared with us. There is no long-lived key to paste anywhere else.

Which shop can the agent act on?

The one you pick during the browser authorization. Etsy handles shop selection at that moment and the MCP server is then locked to that single shop, so writes such as update_listing or create_receipt_shipment can only ever land there. If you are unsure which identity the connection resolved to, get_me and get_shop_by_owner_user_id will tell you.

How much of the Etsy Open API v3 does the connection cover?

100 operations across 27 API modules, split 61 read to 39 write. That spans listings and their inventory, images, properties, translations and personalization, shop sections, shipping and return policies, processing and readiness profiles, production partners, receipts and fulfillment, transactions, payments and the ledger, reviews, your profile and addresses, and the buyer and seller taxonomies. Your AI client loads 30 tools by default and searches the rest on demand, so it does not drown in a hundred definitions.

Can it build a listing from scratch, or only edit existing ones?

From scratch. The full draft to inventory to images to publish flow is covered, so an agent can call create_draft_listing, fill variations and stock with update_listing_inventory, populate attributes with update_listing_property, and take it live with update_listing. get_properties_by_taxonomy_id and get_seller_taxonomy_nodes give it the valid categories and attribute values to work with rather than guessing them.

Can it look at listings and shops that are not mine?

Yes, and this is the part that surprises people. Etsy's Open API v3 includes marketplace-wide browse endpoints, so find_shops and find_all_listings_active reach beyond your own shop, and find_all_active_listings_by_shop reads the active listings of a specific shop by its ID. Every write, though, stays inside the shop the connection is locked to.

How many events can PopMCP watch, and how quickly do they fire?

There are 15 triggers. Eight are polled, covering the order lifecycle from received, updated and paid through shipped, delivered and cancelled, plus new reviews and payment account activity. The rest use change detection to notice listings being created, going live, changing state or selling, along with shop section and shipping profile edits. Neither kind is a push webhook from Etsy, so treat them as near-real-time rather than instant.

Do I have to run or host the Etsy MCP server myself?

No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.

Which AI clients can use this MCP server?

Any client that supports a remote Streamable HTTP MCP server — Claude Desktop, Claude Web, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.

Why do only 30 of the 100 tools load by default?

Loading 100 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 30-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. You can switch a connection to the full catalog at any time.

What is the difference between a tool and a trigger?

A tool is something your AI calls — there are 100 here. A trigger is something PopMCP watches for you: 15 Etsy events that can start work on the PopMCP side. Triggers never enter your AI client's context, and none of them ask you to paste a callback URL into Etsy.

Connect Etsy to your AI in minutes

Launch a hosted MCP endpoint for Etsy, keep tool access under control, and start testing real workflow prompts right away.

Connect your first MCP