@labelgrid/mcp 0.1.1 → 0.2.1

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to `@labelgrid/mcp` are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.1] - 2026-07-15
+
+### Added
+
+- Dockerfile (the server runs containerized; boots into setup mode without credentials).
+- `glama.json` metadata and score badges.
+
+### Changed
+
+- Setup mode now lists the full tool catalog for introspection; every catalog
+  tool returns setup guidance (`NOT_CONNECTED`) until a token is configured.
+
+## [0.2.0] - 2026-07-15
+
+### Added
+
+- MCPB one-click bundle for Claude Desktop, attached to GitHub releases.
+
 ## [0.1.1] - 2026-07-15
 
 ### Changed

package/README.md

@@ -1,12 +1,24 @@
 # LabelGrid MCP Server
 
+[![npm version](https://img.shields.io/npm/v/%40labelgrid%2Fmcp)](https://www.npmjs.com/package/@labelgrid/mcp) [![LabelGrid MCP server](https://glama.ai/mcp/servers/@labelgrid/labelgrid-mcp/badges/score.svg)](https://glama.ai/mcp/servers/@labelgrid/labelgrid-mcp)
+
 `@labelgrid/mcp` — the official [Model Context Protocol](https://modelcontextprotocol.io) server for [LabelGrid](https://labelgrid.com), the music distribution platform. Point Claude Desktop, Claude Code, Cursor, or any MCP client at your own LabelGrid account and manage your music catalog, releases, files, analytics, royalty accounting, webhooks, and distribution in natural language — it is a thin, typed wrapper over the LabelGrid public API, so every rule and validation stays on the server.
 
 ## Quickstart
 
 You need a LabelGrid API token (see [Getting a token](#getting-a-token)) and Node.js 20+. The server runs on demand via `npx` — nothing to install globally.
 
-### Claude Desktop
+### Claude Desktop — one-click install
+
+The quickest way in, with no config file to edit:
+
+1. Download **`labelgrid.mcpb`** from the [latest release](https://github.com/labelgrid/labelgrid-mcp/releases/latest).
+2. Double-click it, or open Claude Desktop → **Settings → Extensions** and drag the file in.
+3. When prompted, paste your [LabelGrid API token](#getting-a-token) — or leave it blank and let the in-chat guided setup walk you through creating one.
+
+To update later, download the newer `.mcpb` and install it over the old one. Prefer to configure it yourself, or using a different client? The manual `npx` setup below works everywhere.
+
+### Claude Desktop — manual config
 
 Add this to your `claude_desktop_config.json` (Settings → Developer → Edit Config):
 
@@ -52,7 +64,7 @@ Add this to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per project):
 
 ### First run / setup mode
 
-If you start the server without `LABELGRID_API_TOKEN`, it does not fail — it launches in **setup mode** and exposes a single `setup` helper. Just ask your AI client to "set up LabelGrid" and it will walk you through creating a token and adding it to your config. Once the token is set, restart your client and the full toolset loads automatically.
+If you start the server without `LABELGRID_API_TOKEN`, it does not fail — it launches in **setup mode**: the full tool catalog stays listed so you can see what the server offers, and a `setup` helper leads the way. Nothing can run in this state — every catalog tool returns setup guidance instead. Just ask your AI client to "set up LabelGrid" and it will walk you through creating a token and adding it to your config. Once the token is set, restart your client and the tools go live.
 
 ## Getting a token
 

package/dist/index.js

@@ -13,35 +13,8 @@ import { isToolEnabled } from './gating.js';
 import { FULL_WRITES_NOTICE, LEGAL_SUMMARY } from './legal.js';
 import { log } from './log.js';
 import { buildServer } from './server.js';
-import { accountingTools } from './tools/accounting.js';
-import { analyticsTools } from './tools/analytics.js';
-import { catalogReadTools } from './tools/catalog-read.js';
-import { catalogWriteTools } from './tools/catalog-write.js';
-import { deliveryTools } from './tools/delivery.js';
-import { filesReadTools } from './tools/files-read.js';
-import { fullWriteTools } from './tools/full-writes.js';
-import { identityTools } from './tools/identity.js';
-import { referenceTools } from './tools/reference.js';
-import { releaseWriteTools } from './tools/release-write.js';
-import { reviewReadTools } from './tools/review-read.js';
-import { webhookTools } from './tools/webhooks.js';
+import { allTools } from './tools/all.js';
 import { VERSION } from './version.js';
-function allTools() {
-    return [
-        ...identityTools,
-        ...referenceTools,
-        ...analyticsTools,
-        ...catalogReadTools,
-        ...filesReadTools,
-        ...reviewReadTools,
-        ...deliveryTools,
-        ...accountingTools,
-        ...webhookTools,
-        ...catalogWriteTools,
-        ...releaseWriteTools,
-        ...fullWriteTools,
-    ];
-}
 async function main() {
     let config;
     try {
@@ -62,7 +35,7 @@ async function main() {
         version: VERSION,
     });
     if (config.setupMode) {
-        const server = buildServer(config, client, []);
+        const server = buildServer(config, client, allTools());
         log('info', `labelgrid-mcp v${VERSION} — setup mode (no API token configured); call the "setup" tool for guided setup`);
         log('info', LEGAL_SUMMARY);
         await server.connect(new StdioServerTransport());

package/dist/server.js

@@ -24,8 +24,10 @@ function buildInstructions(config) {
     if (config.setupMode) {
         return [
             'No LabelGrid API token is configured, so the account is not connected yet. ' +
-                'Call the `setup` tool for step-by-step instructions to connect. No account ' +
-                'data can be accessed in this state.',
+                'Call the `setup` tool for step-by-step instructions to connect. The full ' +
+                'tool catalog is listed so you can see what the server offers, but no ' +
+                'account data can be accessed in this state — every tool returns setup ' +
+                'guidance until a token is configured.',
             LEGAL_SUMMARY,
         ].join('\n\n');
     }
@@ -41,11 +43,20 @@ function buildInstructions(config) {
 }
 export function buildServer(config, client, tools) {
     const server = new McpServer({ name: 'labelgrid-mcp', version: VERSION }, { instructions: buildInstructions(config) });
-    // In setup mode ONLY the setup helper is registered — the account is not
-    // connected, so none of the API-backed tools are exposed.
-    const registered = config.setupMode ? setupTools : tools;
+    // In setup mode the setup helper leads, and the full catalog stays LISTED so
+    // introspection shows what the server offers — but every catalog tool is
+    // inert: without a token no API call is possible, so invoking one returns
+    // setup guidance instead of executing.
+    const registered = config.setupMode ? [...setupTools, ...tools] : tools;
     for (const tool of registered) {
-        if (!isToolEnabled(tool, config))
+        const isSetupHelper = tool.toolset === 'setup';
+        // Listing rule: connected mode applies the full gate matrix; setup mode
+        // lists the whole catalog (only honoring an explicit toolset narrowing),
+        // because nothing can execute without a token anyway.
+        const listable = config.setupMode
+            ? config.toolsets === null || config.toolsets.has(tool.toolset)
+            : isToolEnabled(tool, config);
+        if (!isSetupHelper && !listable)
             continue;
         server.registerTool(tool.name, {
             title: tool.title,
@@ -53,8 +64,19 @@ export function buildServer(config, client, tools) {
             inputSchema: tool.inputShape,
             annotations: { title: tool.title, ...tool.annotations },
         }, async (args) => {
+            // Not connected: every catalog tool refuses with setup guidance.
+            if (config.setupMode && !isSetupHelper) {
+                return toToolResult({
+                    error: {
+                        code: 'NOT_CONNECTED',
+                        message: 'No LabelGrid API token is configured, so this tool cannot run yet. ' +
+                            'Call the `setup` tool for step-by-step instructions to connect your account.',
+                        status: 0,
+                    },
+                });
+            }
             // Defense in depth: even a registered tool re-verifies its gate.
-            if (!isToolEnabled(tool, config)) {
+            if (!isSetupHelper && !isToolEnabled(tool, config)) {
                 return toToolResult({
                     error: {
                         code: 'TOOL_DISABLED',

package/dist/tools/all.d.ts

@@ -0,0 +1,3 @@
+/** The complete tool catalog, in registration order. */
+import type { ToolDef } from './types.js';
+export declare function allTools(): ToolDef[];

package/dist/tools/all.js

@@ -0,0 +1,29 @@
+/** The complete tool catalog, in registration order. */
+import { accountingTools } from './accounting.js';
+import { analyticsTools } from './analytics.js';
+import { catalogReadTools } from './catalog-read.js';
+import { catalogWriteTools } from './catalog-write.js';
+import { deliveryTools } from './delivery.js';
+import { filesReadTools } from './files-read.js';
+import { fullWriteTools } from './full-writes.js';
+import { identityTools } from './identity.js';
+import { referenceTools } from './reference.js';
+import { releaseWriteTools } from './release-write.js';
+import { reviewReadTools } from './review-read.js';
+import { webhookTools } from './webhooks.js';
+export function allTools() {
+    return [
+        ...identityTools,
+        ...referenceTools,
+        ...analyticsTools,
+        ...catalogReadTools,
+        ...filesReadTools,
+        ...reviewReadTools,
+        ...deliveryTools,
+        ...accountingTools,
+        ...webhookTools,
+        ...catalogWriteTools,
+        ...releaseWriteTools,
+        ...fullWriteTools,
+    ];
+}

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "@labelgrid/mcp",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "mcpName": "io.github.labelgrid/labelgrid-mcp",
   "description": "Official LabelGrid MCP server — connect your AI client to your LabelGrid account",
   "type": "module",
   "keywords": ["mcp", "model-context-protocol", "labelgrid", "music-distribution", "ai", "claude"],
   "main": "dist/index.js",
-  "bin": { "labelgrid-mcp": "dist/index.js" },
+  "bin": {
+    "labelgrid-mcp": "dist/index.js"
+  },
   "files": ["dist", "README.md", "CHANGELOG.md", "LICENSE", "server.json"],
   "scripts": {
     "build": "tsc",
+    "build:mcpb": "npm run build && node scripts/build-mcpb.mjs",
     "start": "node dist/index.js",
     "dev": "tsc --watch",
     "test": "vitest run --exclude 'test/contract/**'",
@@ -19,9 +22,14 @@
     "check-coverage": "node scripts/check-api-coverage.mjs",
     "gen-docs": "node scripts/gen-tool-docs.mjs"
   },
-  "repository": { "type": "git", "url": "git+https://github.com/labelgrid/labelgrid-mcp.git" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/labelgrid/labelgrid-mcp.git"
+  },
   "license": "MIT",
-  "engines": { "node": ">=20" },
+  "engines": {
+    "node": ">=20"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
     "zod": "^3.24.0"

package/server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.labelgrid/labelgrid-mcp",
   "description": "Official LabelGrid MCP server — manage your music catalog, releases, analytics and distribution.",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "websiteUrl": "https://labelgrid.com",
   "repository": {
     "url": "https://github.com/labelgrid/labelgrid-mcp",
@@ -12,7 +12,7 @@
     {
       "registryType": "npm",
       "identifier": "@labelgrid/mcp",
-      "version": "0.1.1",
+      "version": "0.2.1",
       "transport": {
         "type": "stdio"
       },