@etchify/mcp-server

Official MCP server for Etchify — connect Claude, ChatGPT, or Gemini to your Shopify engraving & print shop.

Quick Start

npx @etchify/mcp-server --shop mystore.myshopify.com

With API key (for full access):

npx @etchify/mcp-server --shop mystore.myshopify.com --api-key sk_etch_...

Claude Desktop / Claude Code

Add to your claude_desktop_config.json or project .mcp.json:

{
  "mcpServers": {
    "etchify": {
      "command": "npx",
      "args": ["-y", "@etchify/mcp-server"],
      "env": {
        "ETCHIFY_SHOP": "mystore.myshopify.com",
        "ETCHIFY_API_KEY": "sk_etch_..."
      }
    }
  }
}

Available Tools

Public (no API key needed)

| Tool | Description | |------|-------------| | list-products | List configurator-enabled products | | get-product-config | Get dimensions, mode, tools for a product | | browse-templates | Browse design template gallery | | health-check | Check API status | | get-api-spec | Get OpenAPI 3.0 spec |

Authenticated (API key required)

| Tool | Description | |------|-------------| | list-materials | Full material library | | list-shapes | Full shape/geometry library | | list-all-templates | All templates including curated | | shop-info | Shop connection status |

Get Your API Key

1. Open Etchify in your Shopify admin
2. Go to Settings → AI Integration
3. Click Generate API Key
4. Copy the key (shown only once)

Security

• All endpoints are read-only — AI cannot modify your data
• API keys are SHA-256 hashed in the database
• Rate limited: 60 requests/minute
• Each key is scoped to one shop

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | ETCHIFY_SHOP | Yes | Your Shopify domain | | ETCHIFY_API_KEY | No | API key for authenticated access | | ETCHIFY_API_URL | No | Custom API URL (default: https://api.etchify.app) |

License

MIT