# Etsy [Health: Active]

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/pipeworx-io/mcp-etsy  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1018  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/etsy

## Description
Etsy MCP — public listing search via Etsy Open API v3 (api_key auth only)

## Tools
Capabilities this server exposes over MCP:

- **etsy_search_listings** — Search active Etsy listings site-wide (Etsy Open API v3, findAllListingsActive). Requires an Etsy API key — pass your keystring as _apiKey (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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "etsy": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-etsy"]
  }
}
```

## Documentation

## What Etsy does

Etsy provides three MCP tools for read-only access to active Etsy listings through Etsy Open API v3:

- `etsy_search_listings` searches active listings across Etsy. It accepts optional keywords, result limits, offsets, sorting options, price bounds, taxonomy filters, and buyer country.
- `etsy_search_shop_listings` searches active listings belonging to a specific shop ID. It supports keywords, pagination, and sorting. Use the site-wide search first when the shop ID is unknown.
- `etsy_get_listing` retrieves a single listing using its numeric listing ID.

The integration is limited to endpoints that accept an Etsy API key. It does not expose listing writes, shop management, receipt access, user management, or other operations requiring an OAuth user token. Results stay close to Etsy's response format, including the response count, result records, and a `source` field.

## How it works

The hosted MCP endpoint is `https://gateway.pipeworx.io/etsy/mcp`. A full Pipeworx gateway connection is also available at `https://gateway.pipeworx.io/mcp`; the Etsy endpoint lists this pack's tools directly and also includes shared Pipeworx meta-tools. `ask_pipeworx` can route questions across the wider catalog from either connection.

For clients without MCP support, the gateway exposes HTTP tool endpoints under `https://gateway.pipeworx.io/v1/tools/`. The npm package, `@pipeworx/mcp-etsy`, runs as a local stdio bridge and forwards calls to the hosted gateway, so it requires network access and has no offline mode.

## Setup and configuration

Register an Etsy app at `https://www.etsy.com/developers/register` to obtain an API key. Pass the key to the tools as `_apiKey`; the integration uses `x-api-key` authentication and can handle either the bare keystring or the keystring-plus-shared-secret value shown by Etsy.

For a hosted MCP connection, add the endpoint to the client's MCP configuration:

```json
{
  "mcpServers": {
    "etsy": {
      "url": "https://gateway.pipeworx.io/etsy/mcp"
    }
  }
}
```

For local stdio usage, configure the npm bridge:

```json
{
  "mcpServers": {
    "etsy": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-etsy"]
    }
  }
}
```

Anonymous npm-bridge use is capped at 50 calls per day. Setting `PIPEWORX_API_KEY` to a Pipeworx account key raises the allowance to 200 calls per day. Set `PIPEWORX_META_TOOLS=1` if the local bridge should also list the shared gateway tools. When using an HTTPS proxy, newer Node versions may require `NODE_USE_ENV_PROXY=1`.

## Tools and capabilities

- Search active Etsy listings site-wide with keyword, price, taxonomy, country, pagination, and sort filters.
- Search active listings for a known Etsy shop ID.
- Retrieve listing details by numeric listing ID.
- Connect through hosted MCP, local stdio, or HTTP tool calls.
- Route broader catalog questions through Pipeworx shared tools when enabled.

## Limitations and notes

Only active listings are available. Etsy's v3 API does not provide sold-price or comparable-sales data through this integration. The three tools require an approved Etsy API key; OAuth user-token workflows are outside its scope. The local bridge forwards requests to Pipeworx and therefore cannot operate offline. The package is an independent, unofficial integration and is not affiliated with Etsy.

_Full upstream README: https://allmcps.com/mcp/etsy/readme_