Etsy

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:

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

For local stdio usage, configure the npm bridge:

{
  "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.