{"_id":"@copysmith.ai/describely-mcp-server","_rev":"2-b4ed8215ed5861a1b7ba0bb1ce9d6daf","name":"@copysmith.ai/describely-mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@copysmith.ai/describely-mcp-server","version":"1.0.0","keywords":["mcp","describely","ai","product-content","ecommerce","claude","model-context-protocol"],"author":{"name":"Copysmith Inc."},"license":"MIT","_id":"@copysmith.ai/describely-mcp-server@1.0.0","maintainers":[{"name":"alexhaughton","email":"alex.haughton@copysmith.ai"},{"name":"sheguno","email":"shegun@copysmith.ai"},{"name":"atosin","email":"atosin@gmail.com"}],"homepage":"https://github.com/copysmith/describely#readme","bugs":{"url":"https://github.com/copysmith/describely/issues"},"bin":{"describely-mcp":"dist/index.js"},"dist":{"shasum":"ea5eb8fe55854268c6ce7b2f512c02390ab6f3e6","tarball":"https://registry.npmjs.org/@copysmith.ai/describely-mcp-server/-/describely-mcp-server-1.0.0.tgz","fileCount":29,"integrity":"sha512-1jOCrn4kUV0xKy1OY2zYWhi3GoMBh6kxRhLjAeJ2/uEXuZ8FYSKpuQT5ed5JsFJjdSZMV0Gj3HT4ZcKrqO4b3g==","signatures":[{"sig":"MEUCIQDGzZsjs8xKeW0sPMzO6v7NvnXMlae4QLrVkt2BPntmtgIgTvUZXG1cyVht1XEnwi3KRclD1oEm92h+Fi6AGKyMg2Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57844},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b4f5fdc460f112b8742c212e9fb46d3a6512c5f8","scripts":{"build":"tsc","build:mcpb":"npm run build && mcpb pack","prepublishOnly":"npm run build"},"_npmUser":{"name":"alexhaughton","email":"alex.haughton@copysmith.ai"},"repository":{"url":"git+https://github.com/copysmith/describely.git","type":"git"},"_npmVersion":"11.6.2","description":"Describely MCP Server — AI-powered product content generation, catalog management, and bulk operations for Claude Desktop, Claude Code, Cursor, and other MCP clients.","directories":{},"_nodeVersion":"24.11.1","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.0","@anthropic-ai/mcpb":"^2.1.2"},"_npmOperationalInternal":{"tmp":"tmp/describely-mcp-server_1.0.0_1773855145517_0.196075819397159","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@copysmith.ai/describely-mcp-server","version":"1.0.1","description":"Describely MCP Server — AI-powered product content generation, catalog management, and bulk operations for Claude Desktop, Claude Code, Cursor, and other MCP clients.","type":"module","main":"dist/index.js","bin":{"describely-mcp":"dist/index.js"},"scripts":{"build":"tsc","build:mcpb":"npm run build && mcpb pack","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"devDependencies":{"@anthropic-ai/mcpb":"^2.1.2","@types/node":"^22.10.0","typescript":"^5.7.2"},"keywords":["mcp","describely","ai","product-content","ecommerce","claude","model-context-protocol"],"author":{"name":"Copysmith Inc."},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/copysmith/describely.git"},"publishConfig":{"access":"public"},"gitHead":"b4f5fdc460f112b8742c212e9fb46d3a6512c5f8","types":"./dist/index.d.ts","_id":"@copysmith.ai/describely-mcp-server@1.0.1","bugs":{"url":"https://github.com/copysmith/describely/issues"},"homepage":"https://github.com/copysmith/describely#readme","_nodeVersion":"24.11.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-yhMBKZ36uuKMxCha+5Ce+UHORCA9/P7pdbmNw5u3gbzQxr7LnMa7w/js1OC22vs1KQyKxdR5burLQDne69Z27A==","shasum":"82d66fe9a0a4da011a5a82d30f0c7284a75bc391","tarball":"https://registry.npmjs.org/@copysmith.ai/describely-mcp-server/-/describely-mcp-server-1.0.1.tgz","fileCount":30,"unpackedSize":60004,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDkoXtVWnIeViBz117srIukyBcTy/v3dcv4j1Yq9ljXpAiEAsFJ6f2Kenhim2fR1f9boU7PE08pwDZYzqsMf36LbCb8="}]},"_npmUser":{"name":"alexhaughton","email":"alex.haughton@copysmith.ai"},"directories":{},"maintainers":[{"name":"alexhaughton","email":"alex.haughton@copysmith.ai"},{"name":"sheguno","email":"shegun@copysmith.ai"},{"name":"atosin","email":"atosin@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/describely-mcp-server_1.0.1_1773856496800_0.5305385906966429"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-18T17:32:25.430Z","modified":"2026-03-18T17:54:57.058Z","1.0.0":"2026-03-18T17:32:25.674Z","1.0.1":"2026-03-18T17:54:56.935Z"},"bugs":{"url":"https://github.com/copysmith/describely/issues"},"author":{"name":"Copysmith Inc."},"license":"MIT","homepage":"https://github.com/copysmith/describely#readme","keywords":["mcp","describely","ai","product-content","ecommerce","claude","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/copysmith/describely.git"},"description":"Describely MCP Server — AI-powered product content generation, catalog management, and bulk operations for Claude Desktop, Claude Code, Cursor, and other MCP clients.","maintainers":[{"name":"alexhaughton","email":"alex.haughton@copysmith.ai"},{"name":"sheguno","email":"shegun@copysmith.ai"},{"name":"atosin","email":"atosin@gmail.com"}],"readme":"# @copysmith.ai/describely-mcp-server\n\n[![npm version](https://img.shields.io/npm/v/@copysmith.ai/describely-mcp-server.svg)](https://www.npmjs.com/package/@copysmith.ai/describely-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nUse Claude, Cursor, and other AI assistants to interact with your [Describely](https://describely.ai) account. Generate product content, manage catalogs, apply rulesets, and run bulk operations — all from your AI tool of choice.\n\n## What is MCP?\n\n[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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.\n\n## Quick Start\n\n### Option 1: Interactive Setup (Recommended)\n\n```bash\nnpx @copysmith.ai/describely-mcp-server init\n```\n\nThis will:\n1. Detect your installed AI tools (Claude Desktop, Claude Code, Cursor, etc.)\n2. Prompt for your Describely API key\n3. Automatically configure the selected tools\n\n### Option 2: Manual Configuration\n\n#### Claude Code\n\n```bash\nclaude mcp add describely -e DESCRIBELY_API_KEY=ds-your-key-here -- npx -y @copysmith.ai/describely-mcp-server\n```\n\n#### Claude Desktop\n\nAdd to your Claude Desktop config:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"describely\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@copysmith.ai/describely-mcp-server\"],\n      \"env\": {\n        \"DESCRIBELY_API_KEY\": \"ds-your-key-here\"\n      }\n    }\n  }\n}\n```\n\n#### Cursor\n\nAdd to your Cursor MCP config:\n\n**macOS/Linux:** `~/.cursor/mcp.json`\n**Windows:** `%USERPROFILE%\\.cursor\\mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"describely\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@copysmith.ai/describely-mcp-server\"],\n      \"env\": {\n        \"DESCRIBELY_API_KEY\": \"ds-your-key-here\"\n      }\n    }\n  }\n}\n```\n\n#### Windsurf\n\nAdd to your Windsurf MCP config:\n\n**macOS/Linux:** `~/.codeium/windsurf/mcp_config.json`\n**Windows:** `%USERPROFILE%\\.codeium\\windsurf\\mcp_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"describely\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@copysmith.ai/describely-mcp-server\"],\n      \"env\": {\n        \"DESCRIBELY_API_KEY\": \"ds-your-key-here\"\n      }\n    }\n  }\n}\n```\n\n#### VS Code\n\nAdd to your VS Code settings (`settings.json`):\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"describely\": {\n        \"type\": \"stdio\",\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"@copysmith.ai/describely-mcp-server\"],\n        \"env\": {\n          \"DESCRIBELY_API_KEY\": \"ds-your-key-here\"\n        }\n      }\n    }\n  }\n}\n```\n\n## Getting Your API Key\n\n1. Log in to [Describely](https://app.describely.ai)\n2. Go to **Settings → Business Settings → Security & Access**\n3. Click **Create API Key** (it will start with `ds-`)\n\n## Available Tools\n\n### Product Management\n\n| Tool | Description |\n|------|-------------|\n| `find_single_product` | Find a product by name or SKU |\n| `get_product_details` | Get full product details with images |\n| `create_product_from_context` | Create a product from free-form text |\n\n### Content Generation\n\n| Tool | Description |\n|------|-------------|\n| `get_generation_fields` | Get available fields for content generation |\n| `generate_content_inline` | Generate AI content for a product |\n| `save_inline_generated_content` | Save generated content to product fields |\n\n### Catalog & Configuration\n\n| Tool | Description |\n|------|-------------|\n| `list_catalogs` | List all catalogs in your account |\n| `list_rulesets` | List content rulesets |\n| `get_ruleset` | Get detailed ruleset configuration |\n| `list_brand_tones` | List brand voice/tone definitions |\n\n### Bulk Operations\n\n| Tool | Description |\n|------|-------------|\n| `list_bulk_jobs` | List bulk jobs with status |\n| `get_bulk_generation_options` | Get bulk generation configuration options |\n| `get_filtered_product_count_for_bulk_generation` | Preview product count for bulk generation |\n| `execute_bulk_generation` | Run bulk content generation |\n| `get_bulk_enrichment_options` | Get bulk enrichment configuration options |\n| `get_filtered_product_count_for_enrichment` | Preview product count for enrichment |\n| `execute_bulk_enrichment` | Run bulk data enrichment |\n\n## Example Prompts\n\n- \"List my Describely catalogs\"\n- \"Find the product with SKU ABC-123\"\n- \"Generate product descriptions for my winter collection\"\n- \"What rulesets do I have configured?\"\n- \"Run bulk enrichment on products missing descriptions\"\n\n## Configuration Options\n\n### Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `DESCRIBELY_API_KEY` | Yes | Your Describely API key (starts with `ds-`) |\n| `DESCRIBELY_API_URL` | No | Override API URL (default: `https://app.describely.ai/api/mcp/agent`) |\n\n### CLI Arguments\n\n```bash\nnpx @copysmith.ai/describely-mcp-server --api-key ds-xxx --api-url https://custom.url/api/mcp/agent\n```\n\n### Config File\n\nCreate `~/.describely/config.json`:\n\n```json\n{\n  \"apiKey\": \"ds-your-key-here\"\n}\n```\n\nPriority: CLI args > environment variables > config file.\n\n## How It Works\n\nThis package acts as a stdio-to-HTTP transport bridge:\n\n```\nAI Tool (stdio) ↔ This Package ↔ HTTPS ↔ Describely MCP Server\n```\n\n- Your AI tool communicates via stdin/stdout (MCP stdio protocol)\n- This package forwards requests to Describely's embedded MCP server over HTTPS\n- All communication is encrypted (TLS)\n- Your API key is sent via the `x-api-key` header over HTTPS\n\n## License\n\nMIT - see [LICENSE](./LICENSE) for details.\n","readmeFilename":"README.md"}