{"_id":"@brandkity/mcp","_rev":"10-fa9f2bf24795956bfbb3c0e18478be44","name":"@brandkity/mcp","dist-tags":{"latest":"1.4.3"},"versions":{"1.1.0":{"name":"@brandkity/mcp","version":"1.1.0","keywords":["mcp","brandkity","brand-kit","ai","claude","cursor","model-context-protocol"],"author":{"url":"https://brandkity.com","name":"BrandKity","email":"hello@brandkity.com"},"license":"MIT","_id":"@brandkity/mcp@1.1.0","maintainers":[{"name":"brandkity","email":"info@brandkity.com"}],"homepage":"https://brandkity.com/mcp","bugs":{"url":"https://brandkity.com/contact"},"bin":{"brandkity-mcp":"dist/index.js"},"dist":{"shasum":"943115033140c7229874d7751a03965aa449b495","tarball":"https://registry.npmjs.org/@brandkity/mcp/-/mcp-1.1.0.tgz","fileCount":39,"integrity":"sha512-++M64jXyhtN7Me35TYpZDAzy2cQbiFIT1jTNApqZlipAiXl90Dqdt0ftPfrwHJ3nvZhhXN3Tr6kAYrvILY68UQ==","signatures":[{"sig":"MEUCIQCOKL+uCcnU4rbbmA+aYdjm46J+77oTbX/vYpyoByDhfAIgaP17xnal1RJW/IadIluA9CnNwU2q0rByJA99xDTFv3s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":95237},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"694fad3220b893de525fc9f8489fa7ada195f34a","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"brandkity","email":"info@brandkity.com"},"repository":{"url":"git+https://github.com/brandkity/mcp-server.git","type":"git"},"_npmVersion":"11.7.0","description":"BrandKity MCP Server — Create and manage brand kits from AI agents","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.10.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.1.0_1776098183175_0.27388922134415306","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@brandkity/mcp","version":"1.2.0","keywords":["mcp","brandkity","brand-kit","ai","claude","cursor","model-context-protocol"],"author":{"url":"https://brandkity.com","name":"BrandKity","email":"hello@brandkity.com"},"license":"MIT","_id":"@brandkity/mcp@1.2.0","maintainers":[{"name":"brandkity-main","email":"info@brandkity.com"}],"homepage":"https://brandkity.com/mcp","bugs":{"url":"https://brandkity.com/contact"},"bin":{"brandkity-mcp":"dist/index.js"},"dist":{"shasum":"8e38c7f060df712fb699043789580fbbb407494e","tarball":"https://registry.npmjs.org/@brandkity/mcp/-/mcp-1.2.0.tgz","fileCount":39,"integrity":"sha512-FwU/GshWWoE0iVjsX7f1X/oPfUEH9dpd6qrech7d25e0ZR3Ya/pxJxgwOmtALlxO1jC01nFPMgcMyoq/C1bU/Q==","signatures":[{"sig":"MEYCIQDweqa7NiANE8D52Dyzl5bTi+4JIhKahNhQMOUIdBE7ZQIhANDiPjDcoOk3lVDwVoALJ1I/ENc/tfQS62eh7OqBHDGr","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@brandkity%2fmcp@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":104728},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"02730d31401c9c7dba8fda5b205ed3cd811c9905","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:de9cd6ed-f2db-495b-9d37-ad5640c2874f"}},"repository":{"url":"git+https://github.com/BrandKity/mcp-server.git","type":"git"},"_npmVersion":"11.11.0","description":"BrandKity MCP Server — Create and manage brand kits from AI agents","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.10.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.2.0_1776284584863_0.251460065930563","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@brandkity/mcp","version":"1.3.0","keywords":["mcp","brandkity","brand-kit","ai","claude","cursor","model-context-protocol"],"author":{"url":"https://brandkity.com","name":"BrandKity","email":"hello@brandkity.com"},"license":"MIT","_id":"@brandkity/mcp@1.3.0","maintainers":[{"name":"brandkity-main","email":"info@brandkity.com"}],"homepage":"https://brandkity.com/mcp","bugs":{"url":"https://brandkity.com/contact"},"bin":{"brandkity-mcp":"dist/index.js"},"dist":{"shasum":"a86a7eb2c03d23033110a4dbea5de7dd0fda797c","tarball":"https://registry.npmjs.org/@brandkity/mcp/-/mcp-1.3.0.tgz","fileCount":39,"integrity":"sha512-O5oTTozAe/Kplmf5Ixl5lDsSsMWhJ+vqXGKq7wWyhY4TTBIVunPYrnQLAAFK2dzhHCOX1a7U/nJg+3Lnpjt/rg==","signatures":[{"sig":"MEUCIQCqIwR3gtND0xbydOVlVpvwSV8yXTd6/2QNaEGz0N812gIgWM2EpsrFJM6lvCr/7HG57Ps8YHOLkZvLMwSSl/dbiQs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":121532},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"02730d31401c9c7dba8fda5b205ed3cd811c9905","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"brandkity-main","email":"info@brandkity.com"},"repository":{"url":"git+https://github.com/BrandKity/mcp-server.git","type":"git"},"_npmVersion":"11.7.0","description":"BrandKity MCP Server — Create and manage brand kits from AI agents","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.10.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.3.0_1776368290175_0.05244736983299281","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@brandkity/mcp","version":"1.3.1","keywords":["mcp","brandkity","brand-kit","ai","claude","cursor","model-context-protocol"],"author":{"url":"https://brandkity.com","name":"BrandKity","email":"hello@brandkity.com"},"license":"MIT","_id":"@brandkity/mcp@1.3.1","maintainers":[{"name":"brandkity-main","email":"info@brandkity.com"}],"homepage":"https://brandkity.com/mcp","bugs":{"url":"https://brandkity.com/contact"},"bin":{"brandkity-mcp":"dist/index.js"},"dist":{"shasum":"af71689c3cc9fd941b12e78a8f974254fa9f6d46","tarball":"https://registry.npmjs.org/@brandkity/mcp/-/mcp-1.3.1.tgz","fileCount":39,"integrity":"sha512-SgnKws5yjPlb8jRaf6RgBvB2kjyaWguAAaGxCz9OCFdJ9lFzVQBcM8bQk7kPEb+x1e6X6TRRniAXiXb0+WokEg==","signatures":[{"sig":"MEUCIQDK2AyVRfViwQub0c5J731jfVWh4/+jl1kVf22UfuvwJAIgZBtkgtAok8L04Paqs4zbcjVCFnwZmT+5jFAVTbU6r+Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":132539},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"02730d31401c9c7dba8fda5b205ed3cd811c9905","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"brandkity-main","email":"info@brandkity.com"},"repository":{"url":"git+https://github.com/BrandKity/mcp-server.git","type":"git"},"_npmVersion":"11.7.0","description":"BrandKity MCP Server — Create and manage brand kits from AI agents","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.10.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.3.1_1776371885820_0.7097804813567894","host":"s3://npm-registry-packages-npm-production"}},"1.3.2":{"name":"@brandkity/mcp","version":"1.3.2","keywords":["mcp","brandkity","brand-kit","ai","claude","cursor","model-context-protocol"],"author":{"url":"https://brandkity.com","name":"BrandKity","email":"hello@brandkity.com"},"license":"MIT","_id":"@brandkity/mcp@1.3.2","maintainers":[{"name":"brandkity-main","email":"info@brandkity.com"}],"homepage":"https://brandkity.com/mcp","bugs":{"url":"https://brandkity.com/contact"},"bin":{"brandkity-mcp":"dist/index.js"},"dist":{"shasum":"386abe6675d86943ebc52216dcde090bd290aab8","tarball":"https://registry.npmjs.org/@brandkity/mcp/-/mcp-1.3.2.tgz","fileCount":39,"integrity":"sha512-XAX371+X19EZ3VkWhGwuRFkgA8+86bmvTvbrv+nAWeQSIj86qoChzhNSYEFwv7AlS0EpSf9sQKC3Qrln63lXZA==","signatures":[{"sig":"MEUCIQDQXv9jkkOsMFtv5tOqp5GeeyAXevg9FvMM/9fizrFJegIgL2oU1HRZIHp+Owq1k9/WkHD16FFP+ZJ8dmgI06dF5i8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":132539},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"0e7fdcafb452b588f7c66a8eb8e03c216fda8a9a","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"brandkity-main","email":"info@brandkity.com"},"repository":{"url":"git+https://github.com/BrandKity/mcp-server.git","type":"git"},"_npmVersion":"11.7.0","description":"BrandKity MCP Server — Create and manage brand kits from AI agents","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.10.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.3.2_1777376163293_0.19701033404513035","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"@brandkity/mcp","version":"1.4.0","keywords":["mcp","brandkity","brand-kit","ai","claude","cursor","model-context-protocol"],"author":{"url":"https://brandkity.com","name":"BrandKity","email":"hello@brandkity.com"},"license":"MIT","_id":"@brandkity/mcp@1.4.0","maintainers":[{"name":"brandkity-main","email":"info@brandkity.com"}],"homepage":"https://brandkity.com/mcp","bugs":{"url":"https://brandkity.com/contact"},"bin":{"brandkity-mcp":"dist/index.js"},"dist":{"shasum":"24460c4f291f8cad9f1d42f398ceece4c495d1f9","tarball":"https://registry.npmjs.org/@brandkity/mcp/-/mcp-1.4.0.tgz","fileCount":39,"integrity":"sha512-NSwR+ojivZoHj49aqBRJ72hW42YIbe/IE6mfeN8qFhxVmRmVMoMcf4dW/eZsPQmSICSBqB0lTLx4q0TqbqYCDQ==","signatures":[{"sig":"MEYCIQCNt1ACPxqCaAEbygI9Cdcv0mb5XkS2u9D+0PsM+rKraAIhAKmjZKDl5bmQMLkEdowvZZVVxFuGJ0Yvt8lGUD01DIlg","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":137066},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"1f90b6d306b9f1c8133fbd2f83cab8075221243b","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"brandkity-main","email":"info@brandkity.com"},"repository":{"url":"git+https://github.com/BrandKity/mcp-server.git","type":"git"},"_npmVersion":"11.7.0","description":"BrandKity MCP Server — Create and manage brand kits from AI agents","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.10.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.4.0_1777708469457_0.09846785336292552","host":"s3://npm-registry-packages-npm-production"}},"1.4.1":{"name":"@brandkity/mcp","version":"1.4.1","keywords":["mcp","brandkity","brand-kit","ai","claude","cursor","model-context-protocol"],"author":{"url":"https://brandkity.com","name":"BrandKity","email":"hello@brandkity.com"},"license":"MIT","_id":"@brandkity/mcp@1.4.1","maintainers":[{"name":"brandkity-main","email":"info@brandkity.com"}],"homepage":"https://brandkity.com/mcp","bugs":{"url":"https://brandkity.com/contact"},"bin":{"brandkity-mcp":"dist/index.js"},"dist":{"shasum":"0bfdbf6ca3d57eedeb8745a1a8f33c41fb8d31a3","tarball":"https://registry.npmjs.org/@brandkity/mcp/-/mcp-1.4.1.tgz","fileCount":39,"integrity":"sha512-XXqgMqI6G66nt1y1yrcooefpEm4gmBTy/clPl28zcoNP661I/Q5g2VYJV3YYTk0DsyhpkOJ0IuoSCgyj0GnY9g==","signatures":[{"sig":"MEQCIFiw8eWYS4WDdVWT8di3EYaa6N75a1VD+VGt7N7t9tkWAiBHyD0vpELnMHoGxdFJx5UPjVlXHkIaurdZwTZB+UHYaw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":138229},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"1f90b6d306b9f1c8133fbd2f83cab8075221243b","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"brandkity-main","email":"info@brandkity.com"},"repository":{"url":"git+https://github.com/BrandKity/mcp-server.git","type":"git"},"_npmVersion":"11.7.0","description":"BrandKity MCP Server — Create and manage brand kits from AI agents","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.10.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.4.1_1778570064770_0.7308679709074783","host":"s3://npm-registry-packages-npm-production"}},"1.4.2":{"name":"@brandkity/mcp","version":"1.4.2","keywords":["mcp","brandkity","brand-kit","ai","claude","cursor","model-context-protocol"],"author":{"url":"https://brandkity.com","name":"BrandKity","email":"hello@brandkity.com"},"license":"MIT","_id":"@brandkity/mcp@1.4.2","maintainers":[{"name":"brandkity-main","email":"info@brandkity.com"}],"homepage":"https://brandkity.com/mcp","bugs":{"url":"https://brandkity.com/contact"},"bin":{"brandkity-mcp":"dist/index.js"},"dist":{"shasum":"17e5d5fc56579358dd32c636fcd96c306e257d67","tarball":"https://registry.npmjs.org/@brandkity/mcp/-/mcp-1.4.2.tgz","fileCount":39,"integrity":"sha512-1My4o7XPvJj900Ty/MnC3EasjdcJcBD9vnjiqFvJKrSWfbNjc4SF4wccBDXohfbhn/zEEyvpz3uYz11OIlidSA==","signatures":[{"sig":"MEQCIES7YSoQyuDwCvLLirRLSr9X4OH4OvtBrKt73cFWfhDKAiAWItGnzjXBtUlWvRa4AnT01Hpv+tHb05HjZij93rLbkg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":138541},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"c0b45a43be8b2226cf239048d45473afb42d54cb","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"brandkity-main","email":"info@brandkity.com"},"repository":{"url":"git+https://github.com/BrandKity/mcp-server.git","type":"git"},"_npmVersion":"11.7.0","description":"BrandKity MCP Server — Create and manage brand kits from AI agents","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.10.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.4.2_1779022672464_0.9056131159244509","host":"s3://npm-registry-packages-npm-production"}},"1.4.3":{"name":"@brandkity/mcp","version":"1.4.3","description":"BrandKity MCP Server — Create and manage brand kits from AI agents","type":"module","bin":{"brandkity-mcp":"dist/index.js"},"main":"./dist/index.js","scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","prepublishOnly":"npm run build"},"keywords":["mcp","brandkity","brand-kit","ai","claude","cursor","model-context-protocol"],"author":{"name":"BrandKity","email":"hello@brandkity.com","url":"https://brandkity.com"},"license":"MIT","homepage":"https://brandkity.com/mcp","repository":{"type":"git","url":"git+https://github.com/BrandKity/mcp-server.git"},"bugs":{"url":"https://brandkity.com/contact"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.10.0","zod":"^3.23.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.4.0"},"engines":{"node":">=18.0.0"},"gitHead":"67f2ede3f52621531a4d9a7b25b8b68e00c44bd8","types":"./dist/index.d.ts","_id":"@brandkity/mcp@1.4.3","_nodeVersion":"22.14.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-MNAZRdU618dlwgN89kG3TX4gi2APoux2yaSXkwwAr9Fafy0qu8T1KaAAaxsq+xanHwcusQOCDFCSxU4u4kho6Q==","shasum":"7572700f55971f651b2799d145f17f92329fe996","tarball":"https://registry.npmjs.org/@brandkity/mcp/-/mcp-1.4.3.tgz","fileCount":39,"unpackedSize":138690,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCdtOBEGbJbeFcGMOakZaBHVbLbWUG6Pp398YoyemujqwIgDu4Eadk5eIsNMCfclPOf5klMoLUb497m1ZNVSjUGDAY="}]},"_npmUser":{"name":"brandkity-main","email":"info@brandkity.com"},"directories":{},"maintainers":[{"name":"brandkity-main","email":"info@brandkity.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.4.3_1782491703902_0.22042194226386536"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-13T16:36:23.025Z","modified":"2026-06-26T16:35:04.174Z","1.1.0":"2026-04-13T16:36:23.340Z","1.2.0":"2026-04-15T20:23:05.012Z","1.3.0":"2026-04-16T19:38:10.353Z","1.3.1":"2026-04-16T20:38:05.972Z","1.3.2":"2026-04-28T11:36:03.457Z","1.4.0":"2026-05-02T07:54:29.591Z","1.4.1":"2026-05-12T07:14:24.898Z","1.4.2":"2026-05-17T12:57:52.627Z","1.4.3":"2026-06-26T16:35:04.060Z"},"bugs":{"url":"https://brandkity.com/contact"},"author":{"name":"BrandKity","email":"hello@brandkity.com","url":"https://brandkity.com"},"license":"MIT","homepage":"https://brandkity.com/mcp","keywords":["mcp","brandkity","brand-kit","ai","claude","cursor","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/BrandKity/mcp-server.git"},"description":"BrandKity MCP Server — Create and manage brand kits from AI agents","maintainers":[{"name":"brandkity-main","email":"info@brandkity.com"}],"readme":"# @brandkity/mcp — [BrandKity](https://brandkity.com) MCP Server\r\n\r\nModel Context Protocol server for **BrandKity** — create and manage brand kits from any AI agent (Claude Desktop, Cursor, Windsurf, or any MCP-compatible client).\r\n\r\n**Current Version**: 1.4.3 — MCP now available on Starter, Pro, and Agency plans\r\n\r\n## Quick Start\r\n\r\n### 1. Get an API Key\r\n\r\n1. Sign in at [brandkity.com](https://brandkity.com)\r\n2. Go to **Settings → API Keys**\r\n3. Click **Generate New Key** and copy the key (`bk_live_...`)\r\n\r\n> Available on **Starter**, **Pro**, and **Agency** plans. Sign up free to explore, then upgrade Starter or above to run tool calls.\r\n\r\n### 2. Configure Your AI Client\r\n\r\n#### Claude Desktop\r\n\r\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"brandkity\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@brandkity/mcp\"],\r\n      \"env\": {\r\n        \"BRANDKITY_API_KEY\": \"bk_live_your_key_here\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n#### Cursor\r\n\r\nEdit `.cursor/mcp.json`:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"brandkity\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@brandkity/mcp\"],\r\n      \"env\": {\r\n        \"BRANDKITY_API_KEY\": \"bk_live_your_key_here\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n#### Windsurf\r\n\r\nEdit `~/.codeium/windsurf/mcp_config.json`:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"brandkity\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@brandkity/mcp\"],\r\n      \"env\": {\r\n        \"BRANDKITY_API_KEY\": \"bk_live_your_key_here\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### 3. Use It\r\n\r\nOnce configured, ask your AI agent to create a brand kit:\r\n\r\n> \"Create a brand kit for Acme Corp with the accent color #E55B00. Add a Colors block with the primary palette (Orange Flame #E55B00, Midnight #1A1A2E, Canvas #FAF9F7) and a Typography block with Inter for headings and DM Sans for body. Upload the logos from /Users/me/acme/logos/.\"\r\n\r\n## Available Tools (22)\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| **Workspace** | |\r\n| `get_workspace` | Get workspace info (plan, kit count, storage) |\r\n| **Files** | |\r\n| `upload_file` | Upload any local file to workspace storage → returns a public URL |\r\n| `list_files` | List workspace files with type filter and pagination |\r\n| **Kits** | |\r\n| `list_kits` | List all brand kits (filter by draft/published/all) |\r\n| `create_kit` | Create a new kit → returns kit_id |\r\n| `get_kit` | Get a kit with all blocks and content |\r\n| `update_kit` | Update kit settings (name, color, template, logo_url, cover_image_url, **white-label fields**) |\r\n| `publish_kit` | Publish a kit → returns public URL |\r\n| `unpublish_kit` | Unpublish a kit (reverts to draft) |\r\n| **Blocks** | |\r\n| `list_blocks` | List all blocks in a kit with IDs and types |\r\n| `ensure_block` | **Idempotent** — returns existing block_id or creates a new block (preferred over add_block) |\r\n| `add_block` | Add a block unconditionally (use ensure_block instead to prevent duplicates) |\r\n| `update_block` | Update block name/visibility |\r\n| `delete_block` | Permanently delete a block and all its content |\r\n| **Content** | |\r\n| `add_colors` | Add color swatches to a Colors block |\r\n| `add_typography` | Add font entries to a Typography block |\r\n| `set_brand_story` | Set rich text content (brand story, tone of voice) |\r\n| `set_block_note` | Set the editorial note displayed above any block |\r\n| **Upload** | |\r\n| `upload_asset` | Upload a local file into a block (logos, visuals, videos, etc.) with auto-retry |\r\n| `upload_assets_batch` | Upload multiple local files into the same block; deduplicates by file path |\r\n| `upload_kit_logo` | Upload and set the kit's header logo |\r\n| `upload_cover_image` | Upload and set the kit's cover image |\r\n\r\n## White-Label Branding (Pro+ Feature)\r\n\r\nCustomize your portal with custom favicon, social share image, and SEO metadata:\r\n\r\n```typescript\r\n// Upload custom assets\r\nconst faviconUrl = await client.uploadFile('favicon.ico', faviconBuffer);\r\nconst ogImageUrl = await client.uploadFile('og-image.png', ogImageBuffer);\r\n\r\n// Apply white-label branding\r\nawait client.updateKit('kit-id', {\r\n  og_title: 'Acme Corp Brand Guidelines',\r\n  og_description: 'Official brand assets and standards',\r\n  custom_favicon_url: faviconUrl,\r\n  og_image_url: ogImageUrl,\r\n});\r\n```\r\n\r\n**Fields**:\r\n- `og_title` (string, max 100 chars) — SEO title for social share\r\n- `og_description` (string, max 300 chars) — SEO description\r\n- `custom_favicon_url` (string) — CDN URL to favicon (ICO/PNG/SVG)\r\n- `og_image_url` (string) — CDN URL to social share image (1200×630 px recommended)\r\n\r\n**Plan Requirements**:\r\n- Free: White-label fields are read-only; MCP tool calls return 403\r\n- Starter/Pro/Agency: Full MCP access; white-label fields are read-write on Pro/Agency\r\n\r\n## Environment Variables\r\n\r\n| Variable | Required | Default | Description |\r\n|----------|----------|---------|-------------|\r\n| `BRANDKITY_API_KEY` | Yes | — | Personal Access Token (`bk_live_...`) |\r\n| `BRANDKITY_API_URL` | No | `https://brandkity.com` | API base URL (for local dev) |\r\n\r\n## Typical Workflow\r\n\r\n```\r\n1. get_workspace       → verify connection, check plan and storage\r\n2. list_kits           → confirm kit doesn't already exist\r\n3. create_kit          → returns kit_id\r\n4. ensure_block        → idempotent: returns existing block_id or creates a new one (for each block type)\r\n5. add_colors          → populate the Colors block\r\n6. add_typography      → populate the Typography block\r\n7. upload_file         → upload font/logo/cover files to workspace storage\r\n8. upload_asset        → upload logos, images, videos into blocks\r\n9. set_brand_story     → write the brand story in a rich_text block\r\n10. set_block_note     → add usage guidance to any block\r\n11. publish_kit        → make the portal live\r\n```\r\n\r\n## Reliability Notes (v1.4.0)\r\n\r\n- **No duplicate blocks** — `ensure_block` is idempotent. Re-running a workflow never creates duplicate blocks.\r\n- **Auto-retry on uploads** — `upload_asset` and `upload_file` retry up to 3 times on network errors with exponential backoff.\r\n- **Size-aware timeouts** — Upload timeout scales with file size (60 s base + 20 s per 10 MB, max 10 min). Large files like 64 MB video assets are handled reliably.\r\n- **Batch deduplication** — `upload_assets_batch` silently skips duplicate `file_path` entries so the same file is never uploaded twice in one batch.\r\n- **Agent instructions** — The server now provides operating rules to AI clients at connection time, reducing duplicate operations from AI agents automatically.\r\n- **White-label URL resolution** — CDN URLs in white-label fields are automatically resolved to asset IDs server-side; agents don't need to manage asset IDs directly.\r\n- **Storage tracking** — All file uploads are tracked per workspace for accurate quota enforcement.\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md"}