@marlinjai/studio-mcp 0.3.0 → 0.4.0

package/README.md

@@ -21,7 +21,9 @@ claude mcp add lumitra-studio \
   -- node /absolute/path/to/packages/studio-mcp/dist/cli.js
 ```
 
-If the key is already in your shell (for example injected by `cc.sh` as `LUMITRA_STUDIO_SERVICE_TOKEN`), drop the `--env` flag: the server reads the legacy variable too.
+If `LUMITRA_STUDIO_API_KEY` is already exported in your shell, drop the `--env` flag: the server reads it from its own environment.
+
+**Breaking in 0.4.0.** The legacy variable `LUMITRA_STUDIO_SERVICE_TOKEN` is no longer read. Provide the same key as `LUMITRA_STUDIO_API_KEY`; a server started with only the legacy name stops with an error that says so.
 
 ### Cursor (`.cursor/mcp.json`) and Claude Desktop
 
@@ -67,7 +69,6 @@ The HTTP mode is stateless (one server instance per request, no sessions to expi
 | Variable | Required | Default | Notes |
 |---|---|---|---|
 | `LUMITRA_STUDIO_API_KEY` | yes | | Bearer token for the Studio API. |
-| `LUMITRA_STUDIO_SERVICE_TOKEN` | fallback | | Legacy name, accepted when `LUMITRA_STUDIO_API_KEY` is unset. |
 | `LUMITRA_STUDIO_BASE_URL` | no | `https://studio.lumitra.co` | Point at a local Studio (`http://localhost:3000`) to test. |
 
 An env value that is still a literal, unexpanded `${VAR}` placeholder (some plugin hosts only expand `${PLUGIN_ROOT}` and pass everything else through verbatim) is treated as unset and the variable is read from the server's own `process.env` instead.

package/dist/cli.js

@@ -8,6 +8,7 @@ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/
 
 // src/config.ts
 var DEFAULT_BASE_URL = "https://studio.lumitra.co";
+var LEGACY_API_KEY_VAR = "LUMITRA_STUDIO_SERVICE_TOKEN";
 var ConfigError = class extends Error {
   constructor(message) {
     super(message);
@@ -40,10 +41,11 @@ function resolveConfig(env = process.env) {
       `LUMITRA_STUDIO_BASE_URL is not a valid http(s) URL (got ${JSON.stringify(rawBase)})`
     );
   }
-  const apiKey = readEnvVar("LUMITRA_STUDIO_API_KEY", env) ?? readEnvVar("LUMITRA_STUDIO_SERVICE_TOKEN", env);
+  const apiKey = readEnvVar("LUMITRA_STUDIO_API_KEY", env);
   if (!apiKey) {
+    const legacyHint = readEnvVar(LEGACY_API_KEY_VAR, env) ? ` ${LEGACY_API_KEY_VAR} is set, but that legacy name is no longer read since 0.4.0: provide the same key as LUMITRA_STUDIO_API_KEY.` : "";
     throw new ConfigError(
-      'Missing API key: set LUMITRA_STUDIO_API_KEY (or the legacy LUMITRA_STUDIO_SERVICE_TOKEN) to a Lumitra Studio bearer token. An unexpanded "${...}" placeholder counts as unset.'
+      `Missing API key: set LUMITRA_STUDIO_API_KEY to a Lumitra Studio bearer token. An unexpanded "\${...}" placeholder counts as unset.${legacyHint}`
     );
   }
   return { baseUrl, apiKey };
@@ -6552,7 +6554,7 @@ function registerTools(server, ctx) {
 
 // src/server.ts
 var SERVER_NAME = "lumitra-studio";
-var SERVER_VERSION = "0.3.0";
+var SERVER_VERSION = "0.4.0";
 function createStudioMcpServer(opts = {}) {
   const config = opts.config ?? resolveConfig(opts.env ?? process.env);
   const client = new StudioClient(config, {
@@ -6605,7 +6607,7 @@ Usage:
   studio-mcp --http --host 0.0.0.0 --port 3939
 
 Environment:
-  LUMITRA_STUDIO_API_KEY         bearer token (required; legacy LUMITRA_STUDIO_SERVICE_TOKEN accepted)
+  LUMITRA_STUDIO_API_KEY         bearer token (required)
   LUMITRA_STUDIO_BASE_URL        default https://studio.lumitra.co
 
 Tools: ${TOOL_NAMES.join(", ")}

package/dist/index.d.ts

@@ -869,11 +869,12 @@ interface ProjectionIssue {
 /**
  * Server configuration, resolved from the environment once at startup.
  *
- * `LUMITRA_STUDIO_API_KEY` is the bearer token. The legacy name
- * `LUMITRA_STUDIO_SERVICE_TOKEN` (the batch skill + lola-stories backend) is
- * accepted as a fallback so an existing cc.sh-injected environment works
- * unchanged. The token is held in memory only: nothing in this package ever
- * logs, echoes, or serializes it (see `redactSecret` in errors.ts).
+ * `LUMITRA_STUDIO_API_KEY` is the bearer token, and the only name read. The
+ * legacy name `LUMITRA_STUDIO_SERVICE_TOKEN` was a fallback until 0.4.0; the two
+ * names carried different keys on one machine, so there is now one. A legacy
+ * variable that is still set is named in the error, never read. The token is
+ * held in memory only: nothing in this package ever logs, echoes, or serializes
+ * it (see `redactSecret` in errors.ts).
  *
  * Placeholder handling: the Agent Plugins spec only guarantees expansion of
  * `${PLUGIN_ROOT}` / `${PLUGIN_DATA}` in a plugin's `.mcp.json`, so some
@@ -1499,7 +1500,7 @@ declare function registerTools(server: McpServer, ctx: ToolContext): void;
  */
 
 declare const SERVER_NAME = "lumitra-studio";
-declare const SERVER_VERSION = "0.3.0";
+declare const SERVER_VERSION = "0.4.0";
 interface CreateServerOptions {
     config?: StudioConfig;
     env?: NodeJS.ProcessEnv;
@@ -2839,7 +2840,7 @@ declare function buildCharacterSwapDefinition(input: CharacterSwapInput): Workfl
  * `studio-mcp --http [--port 3939]`  Streamable HTTP transport on /mcp (remote / shared)
  *
  * Config: LUMITRA_STUDIO_BASE_URL (default https://studio.lumitra.co) and
- * LUMITRA_STUDIO_API_KEY (or legacy LUMITRA_STUDIO_SERVICE_TOKEN). The token is
+ * LUMITRA_STUDIO_API_KEY (the only key name read). The token is
  * never printed. All diagnostics go to stderr (stdout is the stdio transport).
  */
 

package/dist/index.js

@@ -377,6 +377,7 @@ function projectQuery(projectId) {
 
 // src/config.ts
 var DEFAULT_BASE_URL = "https://studio.lumitra.co";
+var LEGACY_API_KEY_VAR = "LUMITRA_STUDIO_SERVICE_TOKEN";
 var ConfigError = class extends Error {
   constructor(message) {
     super(message);
@@ -409,10 +410,11 @@ function resolveConfig(env = process.env) {
       `LUMITRA_STUDIO_BASE_URL is not a valid http(s) URL (got ${JSON.stringify(rawBase)})`
     );
   }
-  const apiKey = readEnvVar("LUMITRA_STUDIO_API_KEY", env) ?? readEnvVar("LUMITRA_STUDIO_SERVICE_TOKEN", env);
+  const apiKey = readEnvVar("LUMITRA_STUDIO_API_KEY", env);
   if (!apiKey) {
+    const legacyHint = readEnvVar(LEGACY_API_KEY_VAR, env) ? ` ${LEGACY_API_KEY_VAR} is set, but that legacy name is no longer read since 0.4.0: provide the same key as LUMITRA_STUDIO_API_KEY.` : "";
     throw new ConfigError(
-      'Missing API key: set LUMITRA_STUDIO_API_KEY (or the legacy LUMITRA_STUDIO_SERVICE_TOKEN) to a Lumitra Studio bearer token. An unexpanded "${...}" placeholder counts as unset.'
+      `Missing API key: set LUMITRA_STUDIO_API_KEY to a Lumitra Studio bearer token. An unexpanded "\${...}" placeholder counts as unset.${legacyHint}`
     );
   }
   return { baseUrl, apiKey };
@@ -6547,7 +6549,7 @@ function registerTools(server, ctx) {
 
 // src/server.ts
 var SERVER_NAME = "lumitra-studio";
-var SERVER_VERSION = "0.3.0";
+var SERVER_VERSION = "0.4.0";
 function createStudioMcpServer(opts = {}) {
   const config = opts.config ?? resolveConfig(opts.env ?? process.env);
   const client = new StudioClient(config, {
@@ -6604,7 +6606,7 @@ Usage:
   studio-mcp --http --host 0.0.0.0 --port 3939
 
 Environment:
-  LUMITRA_STUDIO_API_KEY         bearer token (required; legacy LUMITRA_STUDIO_SERVICE_TOKEN accepted)
+  LUMITRA_STUDIO_API_KEY         bearer token (required)
   LUMITRA_STUDIO_BASE_URL        default https://studio.lumitra.co
 
 Tools: ${TOOL_NAMES.join(", ")}

package/examples/claude-code.sh

@@ -1,12 +1,12 @@
 #!/usr/bin/env bash
 # Register the Lumitra Studio MCP server with Claude Code.
 # Pick ONE of the blocks below. Never paste the key into a chat; set it in your
-# shell (or let cc.sh inject LUMITRA_STUDIO_SERVICE_TOKEN) and pass it by reference.
+# shell as LUMITRA_STUDIO_API_KEY and pass it by reference.
 set -euo pipefail
 
 # 1) stdio via npx (published package), key from the current shell
 claude mcp add lumitra-studio \
-  --env "LUMITRA_STUDIO_API_KEY=${LUMITRA_STUDIO_API_KEY:-${LUMITRA_STUDIO_SERVICE_TOKEN:?set LUMITRA_STUDIO_API_KEY}}" \
+  --env "LUMITRA_STUDIO_API_KEY=${LUMITRA_STUDIO_API_KEY:?set LUMITRA_STUDIO_API_KEY}" \
   -- npx -y @marlinjai/studio-mcp
 
 # 2) stdio from a local monorepo build

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marlinjai/studio-mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "private": false,
   "description": "Model Context Protocol (MCP) server over the Lumitra Studio HTTP API: generate images, mint characters, run workflows, swap characters into video.",
   "license": "MIT",