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.

ecommerce

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.

6 functions 5 read 1 write Manual OAuth token auth

Submit Etsy feedback View package source

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.

Machine-Readable Metadata

integration_slug: etsy
route_slug: etsy
package: etsy
auth_strategy: oauth2_manual_token Manual OAuth token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Etsy CLIHeadless setup and direct function calls. Etsy MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Etsy MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Etsy.

Claude Code Etsy MCP setup for Claude Code. Cursor Etsy MCP setup for Cursor. Codex Etsy MCP setup for Codex. OpenAI Agents Etsy MCP setup for OpenAI Agents SDK. Claude Agent SDK Etsy MCP setup for Claude Agent SDK. Vercel AI SDK Etsy MCP setup for Vercel AI SDK. LangChain Etsy MCP setup for LangChain. LangGraph Etsy MCP setup for LangGraph. CrewAI Etsy MCP setup for CrewAI. MCP clients Etsy MCP setup for Generic MCP Clients.

Etsy CLI Matrix

Use these pages for direct Etsy CLI workflows in scripts, CI, cron, and agent wrappers.

CI Etsy CLI for CI. Cron Jobs Etsy CLI for cron jobs. Shell Scripts Etsy CLI for shell scripts. Headless Automation Etsy CLI for headless automation. Coding Agents Etsy CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`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_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_listing_inventory`	Read `read`	1	Get the inventory (products, offerings, and pricing) for a specific Etsy listing.
`etsy.etsy_get_current_user`	Read `read`	0	Get the profile of the currently authenticated Etsy user, including user ID and primary shop info.