@pipeworx/etsy

Connect: https://gateway.pipeworx.io/etsy/mcp · Install: one-click buttons

Tools: 3

Search active Etsy listings via the Etsy Open API v3 — scoped to the three endpoints that authenticate with just an API key (no OAuth user token).

Tools

• etsy_search_listings(keywords?, limit?, offset?, sort_on?, sort_order?, min_price?, max_price?, taxonomy_id?, buyer_country?) — site-wide active-listing search (findAllListingsActive).
• etsy_search_shop_listings(shop_id, keywords?, limit?, offset?, sort_on?, sort_order?) — active listings within one shop (findAllActiveListingsByShop).
• etsy_get_listing(listing_id) — one listing by ID (getListing).

No sold-price / comps data — Etsy’s v3 API has none. Active listings only.

Auth

BYO key only (_apiKey), requires an API key. Register a free app at https://www.etsy.com/developers/register to get a keystring + shared secret. Pass ?_apiKey=<keystring>:<shared_secret> (colon-joined) — Etsy’s own quickstart shows the x-api-key header value as the colon-joined pair, not the bare keystring (verified against developers.etsy.com/documentation/tutorials/quickstart/ 2026-09-05).

Etsy’s v3 reference marks each endpoint’s required auth. Only the three endpoints above are api_key-only; everything else (shop/receipt/user management, listing writes) requires an OAuth user token issued through Etsy’s manual commercial-review flow — out of scope for this pack. If Etsy’s review later grants broader access, extend this pack rather than building a second one.

Registering an Etsy developer account requires signing in with (or creating) an Etsy account and a password — a human step this pack’s author cannot perform on Bruce’s behalf. See the open Needs Bruce item for platform-key registration; this pack ships BYOK-gated in the meantime and its own live call has not yet been verified against a real key.

Data sources

• https://developers.etsy.com/documentation/reference/ — Etsy Open API v3. Base URL https://openapi.etsy.com/v3/application.

Traps for the next person:

• The x-api-key header value is keystring:shared_secret, colon-joined — easy to miss since most “API key” auth schemes want the bare key.
• This pack returns Etsy’s response JSON close to verbatim (count + results plus a source field) rather than re-mapping field names, since the exact Listing resource shape was only checked against the published OpenAPI reference, not a live authenticated response (no working key was available at build time — see Auth above).

Tools

• etsy_search_listings — Search active Etsy listings site-wide (Etsy Open API v3, findAllListingsActive). Requires an Etsy API key (x-api-key auth only, no OAuth). No sold-price data — active listings only.
• etsy_search_shop_listings — Search a specific Etsy shop’s active listings by shop ID (Etsy Open API v3, findAllActiveListingsByShop). Requires an Etsy API key. Use etsy_search_listings first if you don’t already have a shop_id.
• etsy_get_listing — Get one Etsy listing by its numeric listing ID (Etsy Open API v3, getListing). Requires an Etsy API key.