pigment-mcp 0.2.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mirunamu00
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
+<a href="https://pigmentui.com"><img src="https://pigmentui.com/opengraph-image" alt="Pigment — give your agent a palette, not a prompt." width="100%" /></a>
+
 # pigment-mcp
 
 MCP server for [Pigment](https://pigmentui.com) design systems. Your coding agent (Claude Code, Codex,
@@ -31,7 +33,7 @@ Prefer nothing to install? The same server runs remotely: `claude mcp add --tran
 
 Start a new session and just ask:
 
-> Apply the Pigment design system margin-notes@1.0.0 to this project.
+> Apply the Pigment design system margin-notes to this project.
 
 Or run the `apply` prompt (Claude Code: `/mcp__pigment__apply`), which adds the working agreement: audit first,
 propose a plan, restyle one sample screen, then report build and visual checks.
@@ -48,3 +50,7 @@ propose a plan, restyle one sample screen, then report build and visual checks.
 | `get_references` | Screenshots of four reference apps restyled with the system |
 
 Requires Node 22+.
+
+## License
+
+[MIT](https://github.com/mirunamu00/pigment/blob/main/LICENSE) © 2026 [mirunamu00](https://github.com/mirunamu00) · [Source](https://github.com/mirunamu00/pigment) · [pigmentui.com](https://pigmentui.com)

package/cli.js

@@ -34866,7 +34866,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@pigment/mcp",
-      version: "0.2.0",
+      version: "0.3.0",
       private: true,
       type: "module",
       description: "MCP server for Pigment design systems: tokens, rules, component specs and installation guides for your coding agent.",
@@ -34922,13 +34922,14 @@ function specForMcp(systemId, pinned) {
   ].join("\n");
   const body = start < 0 ? md : md.slice(0, start) + chapter + (end < 0 ? "" : md.slice(end));
   return [
-    `> Delivered over MCP as ${systemId}@${pinned}. Where this document says tokens.css or tokens.json, call get_tokens and copy the file verbatim.`,
+    `> Delivered over MCP as ${systemId}@${pinned}. Record exactly \`${systemId}@${pinned}\` in design-system/VERSION and pass version "${pinned}" in every later call.`,
+    "> Where this document says tokens.css or tokens.json, call get_tokens and copy the file verbatim.",
     "",
     body
   ].join("\n");
 }
 function createServer() {
-  const server = new McpServer({ name: "pigment", title: "Pigment design systems", version: SERVER_VERSION });
+  const server = new McpServer({ name: "pigment", title: "Pigment design systems", version: SERVER_VERSION }, { instructions: INSTRUCTIONS });
   server.registerTool(
     "list_design_systems",
     {
@@ -34949,7 +34950,7 @@ function createServer() {
     "get_design_system",
     {
       title: "Get design system",
-      description: "The full specification of one pinned version: character, the defining rules, color, type, spacing and motion rules, semantic and primitive token tables, setup and verification. Read it before changing any UI.",
+      description: "The full specification of one version (the latest unless the project pins one): character, the defining rules, color, type, spacing and motion rules, semantic and primitive token tables, setup and verification. Read it before changing any UI.",
       inputSchema: external_exports.object({ id, version: version2 }),
       annotations: { readOnlyHint: true }
     },
@@ -35035,7 +35036,7 @@ function createServer() {
   );
   return server;
 }
-var SERVER_VERSION, id, version2, mode;
+var SERVER_VERSION, id, version2, INSTRUCTIONS, mode;
 var init_server = __esm({
   "src/server.ts"() {
     "use strict";
@@ -35046,7 +35047,13 @@ var init_server = __esm({
     init_package();
     SERVER_VERSION = package_default.version;
     id = external_exports.string().describe('Design system id, e.g. "margin-notes" (see list_design_systems)');
-    version2 = external_exports.string().describe('Exact version such as "1.0.0". Pin the version a project installed; "latest" only when starting fresh.');
+    version2 = external_exports.string().default("latest").describe('Leave out (or "latest") when adding a system to a project. If the project has design-system/VERSION (e.g. margin-notes@1.0.0), pass that exact version.');
+    INSTRUCTIONS = [
+      "Pigment serves versioned design systems. Published versions never change.",
+      "Before UI work, check the project for design-system/VERSION. If it exists, use exactly that id and version in every call.",
+      "If it does not, the user is adding a system: omit the version (latest), then record the exact id@version that get_design_system reports in design-system/VERSION.",
+      "Only change the recorded version when the user asks to upgrade."
+    ].join("\n");
     mode = external_exports.enum(["new", "existing", "ongoing"]);
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pigment-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server for Pigment design systems: tokens, rules, component specs and installation guides for your coding agent.",
   "type": "module",
   "bin": {
@@ -9,7 +9,8 @@
   "files": [
     "cli.js",
     "content",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=22"
@@ -21,6 +22,10 @@
     "design-tokens",
     "ai-agent"
   ],
+  "license": "MIT",
+  "author": "mirunamu00 (https://github.com/mirunamu00)",
+  "homepage": "https://pigmentui.com",
+  "bugs": "https://github.com/mirunamu00/pigment/issues",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mirunamu00/pigment.git",