@thenavidm/midjourney-mcp-cli 1.3.0 → 1.3.1

package/README.md

@@ -109,7 +109,7 @@ All 27 with their arguments are in [section 6](#6-tools).
 | 2 | [Sign in once](#2-sign-in-once) | No key, no cookie |
 | 3 | [Install](#3-install) | Every client, copy and paste, plus the shell |
 | 4 | [Output and exit codes](#4-output-and-exit-codes) | What scripts branch on |
-| 5 | [Which surface, and what each costs](#5-which-surface-and-what-each-costs) | ~8,900 tokens a turn, or nothing |
+| 5 | [Which surface, and what each costs](#5-which-surface-and-what-each-costs) | Measured in Claude Code, and how to spend less |
 | 6 | [Tools](#6-tools) | All 27, by what they reach |
 | 7 | [Spending safely](#7-spending-safely) | Why generating asks twice |
 | 8 | [Prompts and parameters](#8-prompts-and-parameters) | The grammar, validated before you pay |
@@ -288,21 +288,32 @@ authorises a charge.
 
 ## 5. Which surface, and what each costs
 
-An MCP server is expensive and a CLI is free.
+Both surfaces are the same program with the same 32 tools. The
+difference is when the model pays for them. Measured in Claude Code:
 
-The `tools/list` payload for these 32 tools is about **11,062 tokens**, plus the
-server instructions. That is charged on every turn of every conversation, used
-or not, because the descriptions are long and carry the parameter grammar.
-
-A CLI costs nothing until it is called. The skill mentions it in one line, and
-the model pays only when it runs something.
-
-So the two are not competing:
-
-| Where you are | What you can reach |
-|---|---|
-| An agent that can run shell commands | Both. The CLI costs nothing until you type it |
-| A terminal, a script, cron or CI | The CLI only |
+| | MCP server | CLI |
+|---|---|---|
+| Every message, with every tool loaded | 15,200 tokens | nothing |
+| Every message, Claude Code's default | 1,000 tokens | nothing |
+| When Midjourney comes up | nothing more, or the tools it picks | 3,700 tokens for `SKILL.md`, once |
+| 20 messages with Midjourney in 1, every tool loaded | 305,000 tokens | 3,700 tokens |
+
+Claude Code's [tool search](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search)
+is on by default: it sends only the tool names and the server instructions,
+and loads a tool's full definition when the model reaches for it. An app that
+loads every tool up front pays the first line on every message, whether
+Midjourney comes up or not. With the skill added, Claude Code also lists its
+one-line description, about 90 tokens.
+
+To spend less, turn the server off when you are not using it, which in Claude
+Code is the `/mcp` panel. `MIDJOURNEY_READ_ONLY=1` takes the 15 write tools off the list, leaving 17.
+Or install the CLI and add the server on the days it earns its place.
+
+Measured on 2026-09-27 with Claude Code 2.1.257 on Claude Opus 5: one
+short prompt with and without the server connected, once with
+`ENABLE_TOOL_SEARCH=false` and once with the default, the difference read
+from the API's own usage figures. `SKILL.md` was measured the same way. Other
+apps and models count tokens a little differently.
 
 ## 6. Tools
 
@@ -580,7 +591,7 @@ An MCP server is a standard way to give an AI assistant real access to a tool, s
 <details>
 <summary><b>Should I use the MCP server or the CLI?</b></summary>
 
-Use the MCP server in an app with no terminal, like Claude Desktop's chat. Use the CLI anywhere commands run: an agent like Claude Code, Codex or OpenCode, a script or a cron job. The MCP server sends its full tool list to the model on every turn, and the CLI costs nothing until it runs.
+Use the MCP server in an app with no terminal, like Claude Desktop's chat. Use the CLI anywhere commands run: an agent like Claude Code, Codex or OpenCode, a script or a cron job. The MCP server's tools take up context on every message, and the CLI costs nothing until it runs.
 
 </details>
 
@@ -667,7 +678,7 @@ Run into a problem or have a question? [Open an issue](https://github.com/thenav
 
 ## About the author 👋
 
-Navid Moazzez is a leading AI business strategist, and the host of the AI Creator Summit, watched by 100,000+ creators. He helps creators and founders master AI and build their own AI Operating System (AI OS) to automate their business and life. This Midjourney MCP server is one piece of that system.
+Navid Moazzez is a leading AI business strategist, and the host of the AI Creator Summit, watched by 100,000+ creators. He helps creators and founders master AI and build their own AI Operating System (AI OS) to automate their business and life. He creates useful free tools, MCP servers and CLIs that creators and founders can use in their own workflows.
 
 **Links**
 
@@ -696,4 +707,4 @@ Not affiliated with, endorsed by, or sponsored by Midjourney, Inc. Midjourney is
 
 ---
 
-© 2026 [NM Media](https://navid.media). Made with ❤️ by [Navid Moazzez](https://navid.me).
+© 2026 [Navid Media](https://navid.media?utm_source=github&utm_medium=referral&utm_campaign=midjourney-mcp-cli&utm_content=readme). Made with ❤️ by [Navid Moazzez](https://navid.me?utm_source=github&utm_medium=referral&utm_campaign=midjourney-mcp-cli&utm_content=readme).

package/dist/npx.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/npx.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * What `npx -y @thenavidm/midjourney-mcp-cli` runs.
+ *
+ * npx starts a binary named after the package when the package's binaries
+ * point to different files. When they all share one file it starts whichever
+ * one the registry lists first, and the registry does not keep the order they
+ * were published in, so it could start midjourney-cli and hand an MCP client the
+ * command list instead of a server. This file starts the entry as midjourney-mcp.
+ */
+process.argv[1] = (process.argv[1] ?? "").replace(/[^/\\]*$/, "midjourney-mcp");
+void import("./index.js");
+export {};
+//# sourceMappingURL=npx.js.map

package/dist/npx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npx.js","sourceRoot":"","sources":["../src/npx.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;AAChF,KAAK,MAAM,CAAC,YAAY,CAAC,CAAC"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@thenavidm/midjourney-mcp-cli",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Midjourney MCP server and CLI for Claude Code and AI agents. 32 tools for generating images, following jobs to completion, downloading the real files, and building moodboards that make a style reusable.",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
     "midjourney-mcp": "dist/index.js",
-    "midjourney-cli": "dist/index.js"
+    "midjourney-cli": "dist/index.js",
+    "midjourney-mcp-cli": "dist/npx.js"
   },
   "engines": {
     "node": ">=22"