Etsy Ops

A confirmation-gated MCP server for Etsy Open API v3 listing inspection and title/tag updates. Configuration is supplied at runtime; no shop names, IDs, access tokens, or personal data are included in this repository.

Features

• List configured shops and active listings.
• Read listings and their tags.
• Validate Etsy's 13-tag and 20-character tag constraints locally.
• Update a title and/or tags only after an explicit confirmation and a live title check.

Install

python -m venv .venv
.venv/bin/pip install -e .

On Windows, use .venv\\Scripts\\pip install -e ..

Configuration

ETSY_API_KEY=your-application-key
ETSY_ACCESS_TOKEN=oauth-access-token-for-writes
ETSY_SHOPS_JSON={"shop-a":{"shop_id":"123456"}}

For one shop, ETSY_SHOP_ID can be used instead of ETSY_SHOPS_JSON. Obtain and refresh OAuth credentials using Etsy's official developer flow; the server deliberately does not persist credentials.

Run with python server.py.

Safety model

Every listing change requires confirm_write=true. Before changing a listing, the server re-reads it and requires its title to match expected_title, preventing an unintended overwrite. The server provides no delete or publish endpoint.

Development

python -m unittest -v

License

MIT. See LICENSE.