Schema | etsy-mcp-server

etsy-mcp-server

Describes the environment variables required to run the server.

Name	Required	Description	Default
`ETSY_SHOP_ID`	No	Optional. Defaults the shop_id argument on shop tools.
`MCP_READ_ONLY`	No	Set to 1 to refuse anything that changes state.	1
`ETSY_KEYSTRING`	No	Your Etsy API keystring. Required for all modes.
`ETSY_SHARED_SECRET`	No	Your Etsy shared secret. Required for seller mode to access all operations.
`MCP_NO_DESTRUCTIVE`	No	Set to 1 to allow writes but refuse deletes.	1
`ETSY_CREDENTIALS_FILE`	No	Path to the credentials file used in seller mode (e.g., ~/.etsy-mcp-credentials).

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Features and capabilities supported by this server

Protocol revision2025-11-25

Capability	Details
`tools`	{}

Functions exposed to the LLM to take actions

Name	Description
etsy_list_operationsA	Browse all 105 operations in the Etsy Open API v3. Every one is reachable — Etsy's API is entirely seller-facing. Each entry names the OAuth scope it needs, which is what turns a 403 into something you can act on. Use this to find an operation id for etsy_call.
etsy_callB	Call any Etsy operation by id. If it returns 403, check the scope it needs with etsy_check_scopes — Etsy's scope refusals read like permission errors.
etsy_check_scopesA	Which OAuth scopes the Etsy API needs, and what each one unlocks. Useful before authorising an app, and the fastest way to understand a 403. Pass an operation id to see what one call needs; pass held=true to ask Etsy what your token actually carries. The two together are what turn a 403 into a fix.
etsy_get_meA	The authenticated Etsy user, including their user_id and shop_id.
etsy_list_listingsC	Listings in a shop, filtered by state.
etsy_get_listingB	One listing in full. Public — works without a seller token.
etsy_list_receiptsC	Orders in a shop. Needs transactions_r.

Interactive templates invoked by user choice

Name	Description
No prompts

Contextual data attached and managed by the client

Name	Description
No resources

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/N-Graves/etsy-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server