@labelgrid/mcp 0.1.0

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@labelgrid/mcp",
+  "version": "0.1.0",
+  "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" },
+  "files": ["dist", "README.md", "CHANGELOG.md", "LICENSE", "server.json"],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run --exclude 'test/contract/**'",
+    "test:contract": "vitest run test/contract",
+    "lint": "biome check .",
+    "leak-guard": "node scripts/leak-guard.mjs",
+    "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" },
+  "license": "MIT",
+  "engines": { "node": ">=20" },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}

package/server.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
+  "name": "io.github.labelgrid/labelgrid-mcp",
+  "description": "Official LabelGrid MCP server — connect your AI client to your LabelGrid account to manage catalog, releases, files, analytics, accounting, webhooks and distribution.",
+  "version": "0.1.0",
+  "repository": {
+    "url": "https://github.com/labelgrid/labelgrid-mcp",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registry_type": "npm",
+      "identifier": "@labelgrid/mcp",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environment_variables": [
+        {
+          "name": "LABELGRID_API_TOKEN",
+          "description": "Your LabelGrid API token. Create one in your dashboard under Profile → API Tokens. Without it the server starts in setup mode and walks you through creating one.",
+          "is_required": false,
+          "is_secret": true
+        },
+        {
+          "name": "LABELGRID_API_URL",
+          "description": "Override the API base URL. Defaults to the production API.",
+          "is_required": false
+        },
+        {
+          "name": "LABELGRID_ENABLE_WRITES",
+          "description": "Enable safe writes (create/update drafts, labels, artists, and similar). Enabled by default; set to false for read-only.",
+          "is_required": false
+        },
+        {
+          "name": "LABELGRID_ENABLE_FULL_WRITES",
+          "description": "Enable full writes (distribution, takedowns, immutable uploads). Disabled by default; also requires LABELGRID_FULL_WRITES_ACK.",
+          "is_required": false
+        },
+        {
+          "name": "LABELGRID_FULL_WRITES_ACK",
+          "description": "Must equal the exact acknowledgment sentence (see the README safety section) to arm full writes.",
+          "is_required": false,
+          "is_secret": false
+        },
+        {
+          "name": "LABELGRID_TOOLSETS",
+          "description": "Comma-separated subset of toolsets to expose (identity, reference, catalog, releases, review, analytics, accounting, delivery, webhooks, distribution). Defaults to all.",
+          "is_required": false
+        },
+        {
+          "name": "LABELGRID_READ_ONLY",
+          "description": "Force reads only; overrides both write flags. Defaults to false.",
+          "is_required": false
+        }
+      ]
+    }
+  ]
+}