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 Integration for OpenAI Agents SDK

Connect Etsy to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

6 functions 5 read 1 write Manual OAuth token auth

Submit Etsy feedback View package source

Connect Etsy to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Etsy MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-etsy": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=etsy",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=etsy --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Etsy instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Etsy Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Etsy integration catalog.

MCP tool	Source function	Type	Description
`integration__etsy__etsy_list_listings`	`etsy.etsy_list_listings`	Read	List all listings in the Etsy shop. Returns paginated results with optional state filtering (active, draft, inactive, expired).
`integration__etsy__etsy_get_listing`	`etsy.etsy_get_listing`	Read	Get full details for a specific Etsy listing, including title, description, price, images, and state.
`integration__etsy__etsy_create_listing`	`etsy.etsy_create_listing`	Write	Create a new listing in the Etsy shop. Requires a title, description, price, quantity, and shipping profile ID.
`integration__etsy__etsy_list_orders`	`etsy.etsy_list_orders`	Read	List orders (receipts) for the Etsy shop. Returns paginated order data including buyer info, items, and totals.
`integration__etsy__etsy_get_listing_inventory`	`etsy.etsy_get_listing_inventory`	Read	Get the inventory (products, offerings, and pricing) for a specific Etsy listing.
`integration__etsy__etsy_get_current_user`	`etsy.etsy_get_current_user`	Read	Get the profile of the currently authenticated Etsy user, including user ID and primary shop info.

Related Etsy Pages

Etsy CLIUse direct JSON commands instead of MCP discovery. Etsy MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.