@copysmith.ai/describely-mcp-server

Use Claude, Cursor, and other AI assistants to interact with your Describely account. Generate product content, manage catalogs, apply rulesets, and run bulk operations — all from your AI tool of choice.

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI assistants like Claude to securely connect to external tools and data sources. This server implements MCP to give your AI assistant access to your Describely account.

Quick Start

Option 1: Interactive Setup (Recommended)

npx @copysmith.ai/describely-mcp-server init

This will:

1. Detect your installed AI tools (Claude Desktop, Claude Code, Cursor, etc.)
2. Prompt for your Describely API key
3. Automatically configure the selected tools

Option 2: Manual Configuration

Claude Code

claude mcp add describely -e DESCRIBELY_API_KEY=ds-your-key-here -- npx -y @copysmith.ai/describely-mcp-server

Claude Desktop

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "describely": {
      "command": "npx",
      "args": ["-y", "@copysmith.ai/describely-mcp-server"],
      "env": {
        "DESCRIBELY_API_KEY": "ds-your-key-here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP config:

macOS/Linux: ~/.cursor/mcp.json Windows: %USERPROFILE%\.cursor\mcp.json

{
  "mcpServers": {
    "describely": {
      "command": "npx",
      "args": ["-y", "@copysmith.ai/describely-mcp-server"],
      "env": {
        "DESCRIBELY_API_KEY": "ds-your-key-here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP config:

macOS/Linux: ~/.codeium/windsurf/mcp_config.json Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

{
  "mcpServers": {
    "describely": {
      "command": "npx",
      "args": ["-y", "@copysmith.ai/describely-mcp-server"],
      "env": {
        "DESCRIBELY_API_KEY": "ds-your-key-here"
      }
    }
  }
}

VS Code

Add to your VS Code settings (settings.json):

{
  "mcp": {
    "servers": {
      "describely": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@copysmith.ai/describely-mcp-server"],
        "env": {
          "DESCRIBELY_API_KEY": "ds-your-key-here"
        }
      }
    }
  }
}

Getting Your API Key

1. Log in to Describely
2. Go to Settings → Business Settings → Security & Access
3. Click Create API Key (it will start with ds-)

Available Tools

Product Management

| Tool | Description | |------|-------------| | find_single_product | Find a product by name or SKU | | get_product_details | Get full product details with images | | create_product_from_context | Create a product from free-form text |

Content Generation

| Tool | Description | |------|-------------| | get_generation_fields | Get available fields for content generation | | generate_content_inline | Generate AI content for a product | | save_inline_generated_content | Save generated content to product fields |

Catalog & Configuration

| Tool | Description | |------|-------------| | list_catalogs | List all catalogs in your account | | list_rulesets | List content rulesets | | get_ruleset | Get detailed ruleset configuration | | list_brand_tones | List brand voice/tone definitions |

Bulk Operations

| Tool | Description | |------|-------------| | list_bulk_jobs | List bulk jobs with status | | get_bulk_generation_options | Get bulk generation configuration options | | get_filtered_product_count_for_bulk_generation | Preview product count for bulk generation | | execute_bulk_generation | Run bulk content generation | | get_bulk_enrichment_options | Get bulk enrichment configuration options | | get_filtered_product_count_for_enrichment | Preview product count for enrichment | | execute_bulk_enrichment | Run bulk data enrichment |

Example Prompts

• "List my Describely catalogs"
• "Find the product with SKU ABC-123"
• "Generate product descriptions for my winter collection"
• "What rulesets do I have configured?"
• "Run bulk enrichment on products missing descriptions"

Configuration Options

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | DESCRIBELY_API_KEY | Yes | Your Describely API key (starts with ds-) | | DESCRIBELY_API_URL | No | Override API URL (default: https://app.describely.ai/api/mcp/agent) |

CLI Arguments

npx @copysmith.ai/describely-mcp-server --api-key ds-xxx --api-url https://custom.url/api/mcp/agent

Config File

Create ~/.describely/config.json:

{
  "apiKey": "ds-your-key-here"
}

Priority: CLI args > environment variables > config file.

How It Works

This package acts as a stdio-to-HTTP transport bridge:

AI Tool (stdio) ↔ This Package ↔ HTTPS ↔ Describely MCP Server

• Your AI tool communicates via stdin/stdout (MCP stdio protocol)
• This package forwards requests to Describely's embedded MCP server over HTTPS
• All communication is encrypted (TLS)
• Your API key is sent via the x-api-key header over HTTPS

License

MIT - see LICENSE for details.