Provides access to Etsy API data for search, shop info, product details, trends, and full shop management with optional OAuth authentication.
Configuration
View docs{
"mcpServers": {
"dynamicendpoints-etsy-mcp": {
"url": "https://server.smithery.ai/your-username/etsy-mcp-server/mcp",
"headers": {
"ETSY_API_KEY": "sk_live_ABC123",
"ETSY_SHOP_ID": "12345678",
"ETSY_ACCESS_TOKEN": "ya29.a0AfH6SMA..."
}
}
}
}You have a Model Context Protocol (MCP) server that enables AI assistants and applications to interact with Etsy API v3. It lets you search active listings, fetch shop and product details, manage listings and shop sections, and leverage built-in prompts and guides, all with secure access and zero-configuration defaults.
You connect an MCP client to the Etsy MCP server to perform read-only queries and, if you have write access, manage listings and shop data. Start by choosing a connection method: hosted access via Smithery for automatic availability, or a local stdio setup for direct control. Use the hosted URL when you want a live, always-on endpoint, or run the server locally to test and customize in your own environment.
Once connected, you can perform tasks such as searching listings by keywords, retrieving detailed listing information, inspecting shop data, and obtaining listing inventories and images. If you enable OAuth, you can create, update, and delete listings, manage shop sections, and adjust shop information. Build prompts and analytics workflows to optimize listings, pricing, and SEO across your Etsy shop.
Prerequisites: you need Node.js installed on your system. You will also use npm to install dependencies and run the server.
Step 1: Install Node.js and npm if they are not already installed on your machine.
Step 2: Clone the project repository and navigate into it.
Step 3: Install dependencies.
Step 4: Build the project.
Step 5: Run the server locally in stdio mode to start using it immediately.
You can operate in demo mode without an API key for documentation/testing purposes. For production use with your own Etsy shop, provide an Etsy API key and, for write operations, OAuth credentials.
Environment variables you may configure include ETSY_API_KEY, ETSY_SHOP_ID, and ETSY_ACCESS_TOKEN. Read-only operations require an API key; write operations also require an OAuth access token.
If you plan to deploy to Smithery for hosted, always-available access, push your code, connect Smithery, and deploy according to the hosted deployment guide.
Search for active Etsy listings with keyword filtering and optional price, pagination, and sorting controls.
Retrieve detailed information for a single listing, with optional includes for Images, Shop, and other related data.
Fetch information about a specific Etsy shop by its ID.
Get all listings from a particular shop with pagination and state filtering.
Find shops by name with optional limits and offsets.
Return inventory data for a listing, including quantities and variations.
Get all images associated with a listing.
Retrieve shop sections or categories for a given shop.
Obtain currently trending listings on Etsy with pagination support.
Search shops by location or other criteria.
Create a new listing in your shop with complete product details and metadata.
Update an existing listing's details, including title, description, price, and tags.
Remove a listing from your shop.
Update inventory details including variations, SKUs, and quantities.
Add an image to a listing with optional ranking and alt text.
Create a new shop section or category to organize listings.
Rename or modify an existing shop section.
Remove a shop section from your shop.
Update general shop information and settings such as announcements and policies.