Can I use Etsy as a CLI?

Yes. KosmoKrator exposes a Etsy CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Etsy through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Etsy tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Etsy credentials stored?

Etsy credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Etsy MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Etsy MCP, CLI, and Lua Integration for AI Agents

Etsy integration docs for AI agents: MCP gateway setup, Etsy CLI commands, Lua API reference, credentials, and function schemas.

Etsy for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Etsy CLIHeadless setup, JSON output, direct function calls. Etsy MCPExpose selected tools to local MCP clients. Etsy LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug: etsy
route_slug: etsy
package: etsy
auth_strategy: oauth2_manual_token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true

Function Catalog

Function	Type	Parameters	Description
`etsy.etsy_get_shop`	Read `read`	0	Get configured Etsy shop profile.
`etsy.etsy_list_listings`	Read `read`	3	List all listings in the Etsy shop. Returns paginated results with optional state filtering (active, draft, inactive, expired).
`etsy.etsy_get_listing`	Read `read`	1	Get full details for a specific Etsy listing, including title, description, price, images, and state.
`etsy.etsy_create_listing`	Write `write`	10	Create a new listing in the Etsy shop. Requires a title, description, price, quantity, and shipping profile ID.
`etsy.etsy_update_listing`	Write `write`	0	Update a listing.
`etsy.etsy_delete_listing`	Write `write`	0	Delete a listing.
`etsy.etsy_list_listing_images`	Read `read`	0	List listing images.
`etsy.etsy_upload_listing_image`	Write `write`	0	Upload a listing image.
`etsy.etsy_get_listing_inventory`	Read `read`	1	Get the inventory (products, offerings, and pricing) for a specific Etsy listing.
`etsy.etsy_update_listing_inventory`	Write `write`	0	Update listing inventory.
`etsy.etsy_list_orders`	Read `read`	4	List orders (receipts) for the Etsy shop. Returns paginated order data including buyer info, items, and totals.
`etsy.etsy_get_receipt`	Read `read`	0	Get one receipt/order.
`etsy.etsy_list_receipt_transactions`	Read `read`	0	List receipt line items.
`etsy.etsy_list_shop_sections`	Read `read`	0	List shop sections.
`etsy.etsy_list_shipping_profiles`	Read `read`	0	List shop shipping profiles.
`etsy.etsy_list_seller_taxonomy_nodes`	Read `read`	0	List seller taxonomy nodes.
`etsy.etsy_get_current_user`	Read `read`	0	Get the profile of the currently authenticated Etsy user, including user ID and primary shop info.
`etsy.etsy_api_get`	Read `read`	0	Call an Etsy GET endpoint.
`etsy.etsy_api_post`	Write `write`	0	Call an Etsy POST endpoint.
`etsy.etsy_api_put`	Write `write`	0	Call an Etsy PUT endpoint.
`etsy.etsy_api_delete`	Write `write`	0	Call an Etsy DELETE endpoint.