@letterstory/cli 0.177.23 → 0.177.24

package/lib/cli.mjs

@@ -88,7 +88,7 @@ import {
 import { fetchParkedSections, withoutParked } from "./parked.mjs";
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.177.23";
+export const VERSION = "0.177.24";
 
 /** The exit code for a gate refusal (CARD_REQUIRED, PAYMENT_FAILED, OUT_OF_TOKENS): 1 is a plain error. */
 export const EXIT_PAYMENT_REQUIRED = 3;
@@ -97,6 +97,8 @@ export const EXIT_PAYMENT_REQUIRED = 3;
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
 // `negate` spelling) in a command's ARGS map must be listed; boolean-flags.test.ts enforces it.
 export const BOOLEAN_FLAGS = new Set([
+	// org mcp add: the server signs in with OAuth instead of a header value.
+	"sign-in",
 	// collection onboard: connect without drafting or scheduling.
 	"connect-only",
 	// admin demo ideas: every live recipe, not only the Ideas that fit.

package/lib/commands/org.mjs

@@ -58,6 +58,27 @@ export const ARGS = {
 		project_id: { value: (flags) => (flags.project === "none" ? null : flagStr(flags.project)) },
 	},
 	disconnect_linear: {},
+	list_mcp_connections: {},
+	connect_mcp: {
+		name: { positional: 0, label: "name", required: true },
+		url: { positional: 1, label: "url", required: true },
+		token: { flag: "token" },
+		header_name: { flag: "header" },
+		allow_tools: { flag: "allow", type: "list" },
+		sign_in: { flag: "sign-in", type: "bool" },
+	},
+	test_mcp_connection: { name: { positional: 0, label: "name", required: true } },
+	update_mcp_connection: {
+		name: { positional: 0, label: "name", required: true },
+		enabled: { value: (flags) => (flags.off ? false : flags.on ? true : undefined) },
+		allow_tools: {
+			value: (flags) => (flags.allow === "none" ? [] : flags.allow ? flagStr(flags.allow).split(",") : undefined),
+		},
+		token: { value: (flags) => (flags.clear ? null : flagStr(flags.token)) },
+		header_name: { flag: "header" },
+		sign_in: { flag: "sign-in", type: "bool" },
+	},
+	remove_mcp_connection: { name: { positional: 0, label: "name", required: true } },
 	connect_org_config_source: {
 		repo: { positional: 0, label: "owner/name" },
 		branch: { flag: "branch" },
@@ -91,11 +112,13 @@ export async function cmdOrg(ctx) {
 			return orgFields(rest);
 		case "linear":
 			return orgLinear(rest);
+		case "mcp":
+			return orgMcp(rest);
 		case "billing":
 			return orgBilling(rest);
 		default:
 			throw new CliError(
-				`Unknown org subcommand: ${sub ?? "(none)"}. Try: export, join, diff, apply, git, integrations, linear, fields, billing`
+				`Unknown org subcommand: ${sub ?? "(none)"}. Try: export, join, diff, apply, git, integrations, linear, mcp, fields, billing`
 			);
 	}
 }
@@ -454,6 +477,105 @@ async function orgLinear(ctx) {
 	}
 }
 
+/**
+ * `org mcp` — other products' MCP servers Letter's agent can call (docs/architecture/mcp-connections.md):
+ *   org mcp                                              the connections (list_mcp_connections)
+ *   org mcp add <name> <url> [--token <value> [--header <name>] | --sign-in] [--allow a,b]   (connect_mcp)
+ *   org mcp signin <name>                                sign in again with OAuth (update_mcp_connection)
+ *   org mcp tools <name>                                 read the server's tools again (test_mcp_connection)
+ *   org mcp allow <name> <a,b|none>                      the tools that change things the agent may call (update_mcp_connection)
+ *   org mcp on|off <name>                                (update_mcp_connection)
+ *   org mcp token <name> <value>|--clear                 a new header value (update_mcp_connection)
+ *   org mcp remove <name>                                (remove_mcp_connection)
+ */
+async function orgMcp(ctx) {
+	const { client, flags, io } = ctx;
+	const sub = ctx.positionals[0] ?? "list";
+	const rest = ctx.positionals.slice(1);
+	const call = async (tool, allowed, args) => {
+		refuseUnknownFlags(ctx, {}, allowed);
+		const result = await client.callTool(tool, args ?? argsFromFlags(ARGS[tool], flags, rest));
+		ok(ctx, result.message);
+		return result;
+	};
+	const tools = (r) =>
+		r.tools
+			.map((t) => `${t.allowed ? "●" : "○"} ${t.name}${t.read_only ? "  (reads only)" : ""}  ${t.description}`)
+			.join("\n");
+	switch (sub) {
+		case "list": {
+			const result = await call("list_mcp_connections", []);
+			printResult(
+				io,
+				flags,
+				result,
+				(r) =>
+					r.connections
+						.map(
+							(c) =>
+								`${c.enabled ? "●" : "○"} ${c.name}  ${c.url}  ${c.tool_count ?? "?"} tools${c.last_status === "failed" ? `  (failed: ${c.last_error})` : ""}`
+						)
+						.join("\n") || r.message
+			);
+			return 0;
+		}
+		case "add": {
+			const result = await call("connect_mcp", ["token", "header", "allow", "sign-in"]);
+			printResult(io, flags, result, (r) =>
+				r.sign_in_url ? `${r.message}\n${r.sign_in_url}` : `${r.message}\n${tools(r)}`
+			);
+			return 0;
+		}
+		case "signin": {
+			const result = await call("update_mcp_connection", [], {
+				name: requirePositional(rest, 0, "name"),
+				sign_in: true,
+			});
+			printResult(io, flags, result, (r) => `${r.message}\n${r.sign_in_url}`);
+			return 0;
+		}
+		case "tools": {
+			const result = await call("test_mcp_connection", []);
+			printResult(io, flags, result, tools);
+			return 0;
+		}
+		case "allow": {
+			const list = requirePositional(rest, 1, "a,b|none");
+			const result = await call("update_mcp_connection", [], {
+				name: requirePositional(rest, 0, "name"),
+				allow_tools: list === "none" ? [] : list.split(","),
+			});
+			printResult(io, flags, result, tools);
+			return 0;
+		}
+		case "on":
+		case "off": {
+			const result = await call("update_mcp_connection", [], {
+				name: requirePositional(rest, 0, "name"),
+				enabled: sub === "on",
+			});
+			printResult(io, flags, result, (r) => r.message);
+			return 0;
+		}
+		case "token": {
+			const name = requirePositional(rest, 0, "name");
+			const value = flags.clear ? null : requirePositional(rest, 1, "value");
+			const result = await call("update_mcp_connection", ["clear"], { name, token: value });
+			printResult(io, flags, result, (r) => r.message);
+			return 0;
+		}
+		case "remove": {
+			const result = await call("remove_mcp_connection", []);
+			printResult(io, flags, result, (r) => r.message);
+			return 0;
+		}
+		default:
+			throw new CliError(
+				`Unknown org mcp subcommand: ${sub}. Try: add, signin, tools, allow, on, off, token, remove`
+			);
+	}
+}
+
 const ROOT_FILE = "organization.json";
 
 function slug(name) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@letterstory/cli",
-	"version": "0.177.23",
+	"version": "0.177.24",
 	"description": "Spin up and manage Letter phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",