Etsy

This project exposes a subset of theEtsy APIthrough the Model Context Protocol. It allows tools to be called from an MCP client to retrieve shop data and manage listings.

npx tsx src/get-refresh-token --keystring YOUR_KEY --shared-secret YOUR_SECRET

# Future: docker pull etsy-mcp-server:latest

docker run --rm \ -e ETSY_API_KEY=YOUR_KEY \ -e ETSY_SHARED_SECRET=YOUR_SECRET \ -e ETSY_REFRESH_TOKEN=YOUR_TOKEN \ etsy-mcp-server

docker run --rm  -e ETSY_API_KEY=YOUR_KEY  -e ETSY_SHARED_SECRET=YOUR_SECRET  -e ETSY_REFRESH_TOKEN=YOUR_TOKEN  etsy-mcp-server

docker run --rm \ -v ./etsy_mcp_settings.json:/usr/src/app/etsy_mcp_settings.json \ etsy-mcp-server

docker run --rm  -v ./etsy_mcp_settings.json:/usr/src/app/etsy_mcp_settings.json  etsy-mcp-server

{ "command": "docker", "args": [ "run", "--rm", "-v", "./etsy_mcp_settings.json:/usr/src/app/etsy_mcp_settings.json", "etsy-mcp-server" ] }

The MCP client will automatically start the container when it needs to use the Etsy tools and stop it when done.

For easier management, use Docker Compose:
-

Copy.env.exampleto.envand fill in your credentials:

cp .env.example .env # Edit .env with your Etsy API credentials

Multi-platform Builds(for ARM64/Apple Silicon):

# Build for multiple architectures docker buildx build --platform linux/amd64,linux/arm64 -t etsy-mcp-server:latest . # Or build specifically for ARM64 (Apple Silicon) docker buildx build --platform linux/arm64 -t etsy-mcp-server:arm64 .

# Tag for registry docker tag etsy-mcp-server:latest your-registry.com/etsy-mcp-server:1.0.0 # Push to registry docker push your-registry.com/etsy-mcp-server:1.0.0

- Container exits immediately: This is normal behavior for MCP servers when no client connects
- Permission denied: Ensure Docker has proper file system access
- Settings file not found: Check volume mount path matches your file location
- Environment variables not loaded: Verify.envfile syntax and variable names

# Check container logs docker logs etsy-mcp-server # Run container interactively for debugging docker run -it --rm etsy-mcp-server sh # Test container with manual input echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | docker run -i --rm etsy-mcp-server

Fetch information about a shop. Required argument:shop_id.

Return basic info about the authenticated user, includinguser_idandshop_id. This endpoint takes no arguments.

List the listings in a shop. Supports an optionalstateparameter (e.g.active,draft). Requiresshop_id.

Create a new physical draft listing usingPOST /v3/application/shops/{shop_id}/listings. The tool accepts all fields supported by Etsy'screateDraftListingendpoint.

Upload an image to a listing. Requiresshop_id,listing_idandimage_path. (Implementation is currently a placeholder.)

Update an existing listing. Requiresshop_idandlisting_id. Optional fields includetitle,descriptionandprice.

Retrieve receipts for a shop. Requiresshop_id.

Retrieve the list of sections in a shop. Requiresshop_id.

Retrieve a single shop section byshop_idandshop_section_id.

Retrieve the full hierarchy of seller taxonomy nodes.

List product properties supported for a specific taxonomy node. Requirestaxonomy_id.

For debugging and testing the server functionality, use the MCP Inspector with thelocal development setup:
- Start a proxy server and web interface
- Launch the locally built MCP server
- Provide a URL to view communication logs and test tools interactively

Important: The MCP Inspector only works with the local development setup, not with Docker. This is because:

- Docker containers start and exit quickly when no MCP client connects
- The inspector needs direct access to the server process
- Network isolation prevents the inspector from communicating with containerized servers
-

For Development and Testing: Use local development with the MCP Inspector

For Deployment: Use Docker with MCP clients

docker build -t etsy-mcp-server . # Then use with your MCP client

This approach gives you the best of both worlds: interactive debugging locally and reliable deployment with Docker.

Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, Claude Code, OpenClaw, and HTTP-capable MCP clients.

A read-only MCP server for querying live eBay data. Requires a separately licensed CData JDBC Driver for eBay.

MCP server for Walmart Marketplace APIs (US, 3P seller)

Transaction-complete hotel booking over MCP — 300K+ properties, real hotel confirmation numbers, loyalty points, secure checkout. Hotels are merchant of record. Builders set their own booking fee via Stripe Connect. Built on proven distribution infrastructure.

Static MCP discovery card for x402 spend-policy, paid MCP launch guidance, seller checkout repair, and agent-payment safety APIs.

MCP server for 402 Index: discover 15,000+ paid API endpoints across L402, x402, and MPP

Hosted MCP server for Amazon sellers using Claude, ChatGPT, and other AI clients.

AI agent API marketplace-discover, call, and pay for services with USDC payments. List your own AI services and earn money per call.

Unified MCP server for 70+ eCommerce platforms: products, orders, customers, inventory, and more.