# @striderlabs/mcp-etsy

An MCP (Model Context Protocol) server connector for Etsy that enables AI agents to search, browse, and interact with Etsy using browser automation via Playwright.

## Features

- **Search Products** - Search handmade, vintage, and supply items with filters
- **View Item Details** - Get detailed listing info including seller, reviews, and shipping
- **Add to Cart** - Add items with variations and quantity
- **View Cart** - Check current cart contents
- **Manage Favorites** - View and add items to favorites/collections
- **Purchase Items** - Proceed through checkout flow
- **Track Orders** - View order history and tracking status
- **Message Sellers** - Send messages to shop owners
- **Shop Info** - Browse seller profiles and listings

## Installation

```bash
npm install -g @striderlabs/mcp-etsy
```

Playwright browsers must be installed:

```bash
npx playwright install chromium
```

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "etsy": {
      "command": "mcp-etsy"
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `etsy_search_products` | Search Etsy with filters (category, price, sort) |
| `etsy_get_item_details` | Get full listing details |
| `etsy_add_to_cart` | Add item to cart |
| `etsy_view_cart` | View cart contents |
| `etsy_get_favorites` | View favorited items |
| `etsy_add_to_favorites` | Add item to favorites |
| `etsy_checkout` | Proceed through checkout |
| `etsy_track_orders` | View and track orders |
| `etsy_message_seller` | Contact a seller |
| `etsy_login` | Log in to Etsy account |
| `etsy_get_shop_info` | Browse a seller's shop |
| `etsy_close_browser` | Clean up browser resources |

## Authentication

For actions requiring login (cart, favorites, orders, messaging), use `etsy_login` first:

```
Use etsy_login with my email and password, then search for handmade jewelry under $50.
```

> **Note**: Some operations like checkout default to `dry_run: true` for safety. Set `dry_run: false` to complete purchases.

## Requirements

- Node.js >= 18
- Playwright (with Chromium browser)

## License

MIT