home / mcp / etsy mcp server

Etsy MCP Server

Provides access to Etsy API data via MCP endpoints for searching, listing details, shop info, and reviews.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "administrativetrick-etsy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "etsy-mcp-server"
      ],
      "env": {
        "ETSY_API_KEY": "YOUR_ETSY_API_KEY"
      }
    }
  }
}

You set up an MCP server that bridges to Etsy API v3, enabling your AI assistants to search for listings, view shop data, fetch listing details, and discover trending items—all through a simple MCP client workflow. This server is read-only, meaning you can explore public Etsy data without modifying anything on Etsy.

How to use

Connect your MCP client to the Etsy MCP Server to perform read-only operations. You can search active listings, retrieve detailed listing information, fetch shop data and reviews, and discover trending items. Use the client to call endpoints like search_listings, get_listing_details, get_shop_by_name, get_shop_listings, search_shops, get_trending_listings, and get_shop_reviews. Ensure you provide required parameters (for example, keywords for searches or listing_id for details) and optional filters (like price ranges or pagination) as supported by your client.

How to install

Prerequisites: Node.js 18 or higher and an Etsy API key.

Install from npm (if published):

npm install -g etsy-mcp-server

Additional setup requirements

Configure how you run the MCP server by using either a local runtime or a hosted runtime that your MCP client can reach.

runs with an MCP client

If you install via npm, you can start immediately with your API key set in the environment. You may also run a local build from source if you prefer.

Notes on running modes

The server operates in read-only mode, using public Etsy data only. OAuth or authenticated actions are not implemented in this server.

Available tools

search_listings

Search active Etsy listings with filters such as keywords, price range, and pagination to retrieve matching items.

get_listing_details

Fetch detailed information for a specific listing, including optional related data like shop, images, and inventory.

get_shop_by_name

Retrieve information about a shop using its name or slug.

get_shop_listings

Get all active listings from a specific shop with optional pagination and sorting.

search_shops

Search for Etsy shops by name with optional pagination.

get_trending_listings

Get currently trending or popular listings on Etsy.

get_shop_reviews

Retrieve reviews for a specific shop with optional date range and pagination.