etsy

This MCP server provides a read-only integration with the Etsy API v3, enabling AI agents to search for active listings, fetch shop information, retrieve detailed listing data with images, discover trending items, and access shop reviews. It exposes a set of tools such as search_listings, get_listing_details, get_shop_by_name, get_shop_listings, search_shops, get_trending_listings, and get_shop_reviews, each with parameters that map to Etsy API query options. To use it, run the server via a supported method (for example with npx if you’re using the published npm package) and point your MCP client at the server name you configured (e.g., etsy). The tools can then be invoked from your AI assistant workflow to retrieve structured Etsy data for downstream tasks like product recommendations, market insights, or shop comparisons.

Prerequisites:

• Node.js 18+ installed on your system
• npm (comes with Node.js)
• An Etsy API key from the Etsy Developer Portal

Install from npm (recommended if the package is published):

npm install -g etsy-mcp-server

Install from source (if you have the repository):

git clone <repository-url>
cd etsy-mcp-server
npm install
npm run build

Run the server (example using npx as shown in the configuration):

npx -y etsy-mcp-server

If you prefer running via a local built entry point, ensure you point the MCP client to the built index.js path as shown in configuration examples.

Set the required environment variable (API key) in your shell or configuration file:

export ETSY_API_KEY=your_etsy_api_key_here

Or embed it in your MCP configuration (see environment section in the configuration examples).

Notes and tips:

• Your API key is required for read-only operations like search, view, and listing details. OAuth is not currently implemented for this server.
• Respect Etsy API rate limits (around 10 requests per second per API key). Implement client-side rate limiting and pagination handling where appropriate.
• The server is read-only by design; avoid attempting operations that modify data (e.g., creating listings) through this MCP server.
• If you install from source, you may need to build before running: npm run build. Ensure the built index.js path matches what your MCP client expects.
• Ensure ETSY_API_KEY is kept secure and not checked into version control. Use environment variables or secret management where possible.