neon 4.1.0 → 4.2.1

package/README.md

@@ -722,6 +722,43 @@ That message reports where parsing stopped and nothing more. `--data` carries wh
 | `--preview` | Enable preview features (scaffolding a project from a template) |
 | `--profile <name>` | Run as that stored account. See [Which credential an invocation uses](#which-credential-an-invocation-uses). |
 
+## Install the Neon MCP server (`mcp`)
+
+`neon mcp` writes the hosted Neon MCP server (`https://mcp.neon.tech/mcp`) into coding-agent config files.
+
+```bash
+# Interactive: global or project, then agents, then API key or OAuth, then confirm.
+$ neon mcp
+
+# Skip prompts. Global config, every globally detected agent, minted API key.
+$ neon mcp -y
+
+# OAuth: no API key minted. The agent prompts for Neon sign-in on first use.
+$ neon mcp --oauth
+
+# Project-level config. A minted key is still account-wide.
+$ neon mcp --project
+
+$ neon mcp --agent cursor --agent claude-code
+
+# Hide write tools. Does not change the minted key.
+$ neon mcp --read-only
+
+# Pin MCP tools to one project. Does not change the minted key.
+$ neon mcp --project-id <project-id>
+
+# Limit which tool categories are visible.
+$ neon mcp --category querying --category schema
+```
+
+On a TTY the command asks for config location (global is the default), then agents, then API key vs OAuth, then a summary to confirm before it writes. Detected agents start selected: globally installed agents or project-folder markers such as `.cursor` when the install is project.
+
+`-y` skips those questions. `--project`, `--oauth` and `--agent` skip the question they answer and still apply with `-y`. `--read-only` and `--category` are flags only and are never prompted. A linked project-folder install asks whether to pin MCP tools to that `.neon` project (`?projectId=`). An unlinked project folder does not ask. Global installs never add that param unless you pass `--project-id`. Without a TTY, pass `-y` to mint into every detected agent, `--agent` to name the agents or `--oauth` to write the URL only.
+
+`--agent` names: `antigravity`, `cline`, `cline-cli`, `claude-code`, `codex`, `cursor`, `gemini-cli`, `goose`, `github-copilot-cli`, `grok-build`, `mcporter`, `opencode`, `vscode`, `windsurf`, `zed`. Project installs drop `antigravity`, `cline`, `cline-cli`, `goose` and `windsurf`. `claude-desktop` is a known name that is then skipped.
+
+The default mints an account-wide API key (or reuses the Bearer already configured for Neon at `https://mcp.neon.tech/mcp`) and writes it into each selected agent's config. That key reaches everything the account can, in every organization. Revoke it with `neon api-keys revoke <id>`. `--oauth` writes the URL with no `Authorization` header; the agent signs in on first use. `--project` writes into the project config (`.cursor/mcp.json` and similar). `--read-only` adds `?readonly=true`. `--project-id` adds `?projectId=`. `--category` adds `?category=` (repeatable or comma-separated: `projects`, `branches`, `schema`, `querying`, `neon_auth`, `data_api`, `observability`, `docs`). Those query params restrict which MCP tools the server exposes; they do not change what the minted key can do.
+
 ## Snapshots (`snapshots`)
 
 `neon snapshots` (alias `neon snapshot`) manages **snapshots** — point-in-time backups of a branch that you can list, rename, expire, restore into a branch, or schedule automatically. Snapshots are a Beta Neon feature and were previously only available in the Console and REST API; this command group brings them to the CLI.
@@ -1101,6 +1138,7 @@ Id   Name      Project         Created At            Last Used At          Last
 | deploy                                                                     |                                                                                                              | Alias for `config apply`           |
 | bootstrap                                                                  |                                                                                                              | Scaffold a project from a template |
 | init                                                                       |                                                                                                              | Set up a project for a coding agent |
+| mcp                                                                        |                                                                                                              | Install the Neon MCP server         |
 | bucket                                                                     | `create`, `list`, `delete`, `object list`, `object get`, `object put`, `object delete` (incl. `--recursive`) | Manage buckets and their objects   |
 | [completion](https://neon.com/docs/reference/cli-completion)               |                                                                                                              | Generate a completion script       |
 

package/dist/commands/auth.js

@@ -6,7 +6,7 @@ import { log } from "../log.js";
 import { getApiClient } from "../api.js";
 import { o as isOwnedCredentialPath } from "../_chunks/paths-g3DRqJiD.js";
 import { setAuthContext } from "../auth_context.js";
-import { isConfigInit, isCurrentBranchProbe, isProfileCommand } from "../context.js";
+import { isConfigInit, isCurrentBranchProbe, isMcpCommand, isMcpOauth, isProfileCommand } from "../context.js";
 import { extendTokenSet } from "../utils/auth.js";
 import { auth, refreshToken } from "../auth.js";
 import { i as selectCredential, n as displacedProfileWarning, t as credentialInputs } from "../_chunks/auth_selection-Bx2NAgkk.js";
@@ -215,10 +215,12 @@ const ensureAuth = async (props) => {
 	if (isCurrentBranchProbe(props)) return;
 	if (isConfigInit(props)) return;
 	if (isProfileCommand(props)) return;
+	if (isMcpOauth(props)) return;
 	if (props._[0] === "open") return;
 	const isLocalDev = props._[0] === "dev";
 	const isBootstrap = props._[0] === "bootstrap";
 	const isInit = props._[0] === "init";
+	const isMcp = isMcpCommand(props);
 	if (props._[0] === "auth") {
 		props.apiClient = getApiClient({
 			apiKey: props.apiKey,
@@ -298,6 +300,10 @@ const ensureAuth = async (props) => {
 		log.debug("init: skipping global auth; init manages its own auth flow");
 		return;
 	}
+	if (isMcp) {
+		log.debug("mcp: no usable credentials; minting requires auth or --oauth");
+		return;
+	}
 	const apiKey = await authFlow({
 		...props,
 		profile: selection.profile

package/dist/commands/branches.js

@@ -24,8 +24,8 @@ const BRANCH_FIELDS = [
 	"name",
 	"id",
 	"current_state",
-	"created_at",
-	"expires_at"
+	"expires_at",
+	"created_at"
 ];
 const BRANCH_FIELDS_RESET = [
 	"name",

package/dist/commands/index.js

@@ -20,6 +20,7 @@ import { t as init_exports } from "./init.js";
 import { t as inspect_exports } from "./inspect.js";
 import { t as ip_allow_exports } from "./ip_allow.js";
 import { t as logs_exports } from "./logs.js";
+import { t as mcp_exports } from "./mcp.js";
 import { t as neon_auth_exports } from "./neon_auth.js";
 import { t as open_exports } from "./open.js";
 import { t as operations_exports } from "./operations.js";
@@ -58,6 +59,7 @@ var commands_default = [
 	link_exports,
 	open_exports,
 	init_exports,
+	mcp_exports,
 	data_api_exports,
 	functions_exports,
 	dev_exports,

package/dist/commands/mcp.js

@@ -0,0 +1,212 @@
+import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
+import { log } from "../log.js";
+import { readContextFile } from "../context.js";
+import { getCliName } from "../utils/cli_name.js";
+import { writer } from "../writer.js";
+import { noPassthrough, single } from "../utils/flags.js";
+import { existingNeonApiKey, installNeonMcpServer, neonMcpUrl, parseMcpCategories, trackedProjectMcpConfig } from "../mcp/install.js";
+import { mintMcpApiKey, withdrawMintedKey } from "../mcp/mint.js";
+import { canPickAgentsInteractively } from "../utils/agent_picker.js";
+import { resolveInstallTargets } from "../mcp/targets.js";
+import { confirmMcpInstall } from "../mcp/wizard.js";
+import { resolveMcpPlan } from "../mcp/plan.js";
+//#region src/commands/mcp.ts
+var mcp_exports = /* @__PURE__ */ __exportAll({
+	builder: () => builder,
+	command: () => "mcp",
+	describe: () => describe,
+	handler: () => handler
+});
+const command = "mcp";
+const describe = "Install the Neon MCP server into coding agents";
+const builder = (argv) => argv.usage("$0 mcp [options]").options({
+	oauth: {
+		type: "boolean",
+		default: false,
+		describe: "Write the server URL only. The agent prompts for Neon sign-in on first use. No CLI login, no API key minted. Skips the auth question"
+	},
+	project: {
+		type: "boolean",
+		default: false,
+		describe: "Write project-level MCP config. Skips the config-location question. Does not change the minted key"
+	},
+	yes: {
+		alias: "y",
+		type: "boolean",
+		default: false,
+		describe: "Skip prompts. Defaults to global config, every detected agent and a minted account-wide API key. --project, --oauth, --agent, --read-only, --project-id and --category still apply"
+	},
+	agent: {
+		alias: "a",
+		type: "array",
+		string: true,
+		describe: "Coding agent to install into (repeatable). Skips the agent picker",
+		coerce: (value) => {
+			if (value === void 0) return [];
+			const list = Array.isArray(value) ? value : [value];
+			if (list.length === 0) throw new Error("--agent needs a value. Pass one, or omit the flag entirely.");
+			return list.map((item) => {
+				if (typeof item !== "string" || item.trim() === "") throw new Error("--agent needs a value. Pass one, or omit the flag entirely.");
+				return item;
+			});
+		}
+	},
+	"read-only": {
+		alias: "readonly",
+		type: "boolean",
+		default: false,
+		describe: "Restrict MCP tools to read-only (?readonly=true). Not prompted. Does not change the minted key"
+	},
+	"project-id": {
+		type: "string",
+		describe: "Pin MCP tools to one Neon project (?projectId=). Does not change the minted key. Interactive asks only for a linked project-folder install",
+		coerce: single("project-id")
+	},
+	category: {
+		type: "array",
+		string: true,
+		describe: "MCP tool category (repeatable or comma-separated). Default: all",
+		coerce: (value) => {
+			if (value === void 0) return [];
+			const list = Array.isArray(value) ? value : [value];
+			if (list.length === 0) throw new Error("--category needs a value. Pass one, or omit the flag entirely.");
+			const parts = [];
+			for (const item of list) {
+				if (typeof item !== "string" || item.trim() === "") throw new Error("--category needs a value. Pass one, or omit the flag entirely.");
+				for (const part of item.split(",")) {
+					const trimmed = part.trim();
+					if (trimmed === "") throw new Error("--category needs a value. Pass one, or omit the flag entirely.");
+					parts.push(trimmed);
+				}
+			}
+			return parseMcpCategories(parts);
+		}
+	}
+}).example("$0 mcp", "Interactive: config location, agents, auth, then confirm").example("$0 mcp -y", "Global config, detected agents, minted API key").example("$0 mcp --oauth", "Install with OAuth; the agent signs in on first use").example("$0 mcp --project", "Write project-level config").example("$0 mcp --agent cursor --agent claude-code", "Install into specific agents").example("$0 mcp --read-only", "Hide write tools via ?readonly=true").example("$0 mcp --project-id <id>", "Pin tools to one project via ?projectId=").example("$0 mcp --category querying --category schema", "Limit tools to those categories").strict().check(noPassthrough("mcp"));
+const handler = async (props) => {
+	const cwd = process.cwd();
+	const interactive = canPickAgentsInteractively() && props.yes !== true;
+	const linkedProjectId = readContextFile(props.contextFile).projectId;
+	const plan = await resolveMcpPlan({
+		project: props.project === true,
+		oauth: props.oauth === true,
+		agents: props.agent ?? [],
+		yes: props.yes === true,
+		cwd,
+		interactive,
+		readOnly: props.readOnly === true,
+		projectId: props.projectId,
+		categories: props.category ?? [],
+		linkedProjectId
+	});
+	const { install, skipped } = resolveInstallTargets({
+		agents: plan.agents,
+		scope: plan.scope
+	});
+	const url = neonMcpUrl({
+		readOnly: plan.readOnly,
+		projectId: plan.urlProjectId,
+		categories: plan.categories
+	});
+	if (plan.scope === "project" && plan.auth === "api-key") {
+		const tracked = trackedProjectMcpConfig({
+			agents: install,
+			cwd
+		});
+		if (tracked) throw new Error(`${tracked} is tracked by git. Untrack it before writing an API key, or pass --oauth.`);
+	}
+	const existing = plan.auth === "api-key" ? existingNeonApiKey({
+		agents: install,
+		scope: plan.scope,
+		cwd
+	}) : void 0;
+	if (plan.auth === "api-key" && !existing) {
+		if (!props.apiClient || !props.apiKey) throw new Error(`Authentication required. Run \`${getCliName()} auth\`, pass --api-key or use --oauth to install without a Neon credential.`);
+		if (!canPickAgentsInteractively() && props.yes !== true && (props.agent ?? []).length === 0) throw new Error("No interactive terminal. Pass -y to mint into every detected agent, --agent <name> to name them or --oauth to install without minting.");
+	}
+	if (interactive) {
+		if (!await confirmMcpInstall({
+			scope: plan.scope,
+			install,
+			skipped,
+			auth: plan.auth,
+			reuse: existing !== void 0,
+			url
+		})) {
+			log.info("Aborted. Nothing was written.");
+			return;
+		}
+	}
+	let auth;
+	let minted;
+	if (plan.auth === "oauth") auth = { kind: "oauth" };
+	else if (existing) {
+		auth = {
+			kind: "api-key",
+			apiKey: existing
+		};
+		log.info("Reusing the API key already configured for the Neon MCP server.");
+	} else {
+		minted = await mintMcpApiKey({ apiClient: props.apiClient });
+		auth = {
+			kind: "api-key",
+			apiKey: minted.key
+		};
+		log.warning("This key reaches everything your account can, in every organization.");
+	}
+	const rows = [];
+	let successes = 0;
+	const failedAgents = [];
+	for (const agent of install) {
+		const result = installNeonMcpServer({
+			agent,
+			scope: plan.scope,
+			cwd,
+			auth,
+			url
+		});
+		if (result.ok) {
+			successes += 1;
+			rows.push({
+				agent,
+				status: "installed"
+			});
+			log.info("Wrote %s", result.path);
+		} else {
+			rows.push({
+				agent,
+				status: result.unsupported ? "skipped" : "failed",
+				error: result.error
+			});
+			if (!result.unsupported) failedAgents.push(agent);
+		}
+	}
+	for (const row of skipped) rows.push({
+		agent: row.agent,
+		status: "skipped",
+		error: row.error
+	});
+	if (successes === 0) {
+		if (minted && props.apiClient) {
+			const withdrawn = await withdrawMintedKey(props.apiClient, minted);
+			throw new Error(withdrawn ? "Failed to write Neon MCP config to any agent. The minted API key has been revoked." : `Failed to write Neon MCP config to any agent. The minted API key could NOT be revoked. Remove it with \`${getCliName()} api-keys revoke ${minted.id}\`.`);
+		}
+		throw new Error("Failed to write Neon MCP config to any agent.");
+	}
+	log.info("URL: %s", url);
+	const out = writer(props);
+	out.write(rows, {
+		fields: [
+			"agent",
+			"status",
+			"error"
+		],
+		title: "MCP"
+	});
+	out.end();
+	if (minted) log.info("Minted API key %s (id %d, account). Revoke with: %s", minted.name, minted.id, `${getCliName()} api-keys revoke ${minted.id}`);
+	if (plan.auth === "oauth") log.info("The agent will prompt for Neon sign-in on first use.");
+	if (failedAgents.length > 0) throw new Error(`Failed to write Neon MCP config for: ${failedAgents.join(", ")}.`);
+};
+//#endregion
+export { builder, command, describe, handler, mcp_exports as t };

package/dist/commands/projects.js

@@ -12,6 +12,7 @@ import prompts from "prompts";
 //#region src/commands/projects.ts
 var projects_exports = /* @__PURE__ */ __exportAll({
 	PROJECT_FIELDS: () => PROJECT_FIELDS,
+	RECOVERABLE_PROJECT_FIELDS: () => RECOVERABLE_PROJECT_FIELDS,
 	REGIONS: () => REGIONS,
 	aliases: () => aliases,
 	builder: () => builder,
@@ -25,6 +26,14 @@ const PROJECT_FIELDS = [
 	"region_id",
 	"created_at"
 ];
+const RECOVERABLE_PROJECT_FIELDS = [
+	"id",
+	"name",
+	"recoverable_until",
+	"deleted_at",
+	"region_id",
+	"created_at"
+];
 const REGIONS = [
 	"aws-us-west-2",
 	"aws-ap-southeast-1",
@@ -185,11 +194,7 @@ const list = async (props) => {
 	const sharedProjects = props.orgId || props.recoverableOnly ? [] : await getList(props.apiClient.listSharedProjects);
 	const out = writer(props);
 	out.write(ownedProjects, {
-		fields: props.recoverableOnly ? [
-			...PROJECT_FIELDS,
-			"deleted_at",
-			"recoverable_until"
-		] : PROJECT_FIELDS,
+		fields: props.recoverableOnly ? RECOVERABLE_PROJECT_FIELDS : PROJECT_FIELDS,
 		title: "Projects",
 		emptyMessage: props.recoverableOnly ? "You don't have any recoverable projects." : "You don't have any projects yet. See how to create a new project:\n> neon projects create --help"
 	});
@@ -351,4 +356,4 @@ const onPromptState = (state) => {
 	}
 };
 //#endregion
-export { PROJECT_FIELDS, REGIONS, aliases, builder, command, describe, handler, projects_exports as t };
+export { PROJECT_FIELDS, RECOVERABLE_PROJECT_FIELDS, REGIONS, aliases, builder, command, describe, handler, projects_exports as t };

package/dist/commands/snapshots.js

@@ -18,8 +18,8 @@ const SNAPSHOT_FIELDS = [
 	"id",
 	"name",
 	"source_branch_id",
-	"created_at",
-	"expires_at"
+	"expires_at",
+	"created_at"
 ];
 const SCHEDULE_FIELDS = [
 	"frequency",

package/dist/context.js

@@ -50,6 +50,27 @@ const isProfileCommand = (args) => args._[0] === "profile" || args._[0] === "pro
 * far a credential reaches must come from an explicit flag, never from `.neon`.
 */
 const isApiKeysCommand = (args) => args._[0] === "api-keys" || args._[0] === "api-key";
+const isMcpCommand = (args) => args._[0] === "mcp";
+/** Raw argv is required because auth middleware runs before MCP flags are parsed. */
+const isMcpOauth = (args) => isMcpCommand(args) && argvEnablesMcpOauth(process.argv);
+const OAUTH_FALSE = /* @__PURE__ */ new Set([
+	"false",
+	"0",
+	"no"
+]);
+function argvEnablesMcpOauth(argv) {
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg === "--oauth=true" || arg === "--oauth=1") return true;
+		if (arg === "--oauth=false" || arg === "--oauth=0") continue;
+		if (arg === "--oauth") {
+			const next = argv[i + 1];
+			if (next !== void 0 && OAUTH_FALSE.has(next.toLowerCase())) continue;
+			return true;
+		}
+	}
+	return false;
+}
 const CONTEXT_FILE = ".neon";
 const GITIGNORE_FILE = ".gitignore";
 const canAccessFile = (file) => {
@@ -108,6 +129,7 @@ const enrichFromContext = (args) => {
 	if (args._[0] === "link" || args._[0] === "set-context") return;
 	if (isApiKeysCommand(args)) return;
 	if (isProfileCommand(args)) return;
+	if (isMcpCommand(args)) return;
 	const context = readContextFile(args.contextFile);
 	if (!args.orgId) args.orgId = context.orgId;
 	if (!args.projectId) args.projectId = context.projectId;
@@ -213,4 +235,4 @@ const globToRegExp = (pattern) => {
 	return new RegExp(`^${source}$`);
 };
 //#endregion
-export { applyContext, contextBranch, currentContextFile, enrichFromContext, ensureGitignored, isApiKeysCommand, isConfigInit, isCurrentBranchProbe, isProfileCommand, readContextFile, setContext, updateContextFile, walkContextFile };
+export { applyContext, contextBranch, currentContextFile, enrichFromContext, ensureGitignored, isApiKeysCommand, isConfigInit, isCurrentBranchProbe, isMcpCommand, isMcpOauth, isProfileCommand, readContextFile, setContext, updateContextFile, walkContextFile };

package/dist/human_table.js

@@ -32,6 +32,12 @@ function displayWidth(s) {
 	}
 	return width;
 }
+function presentFields(data, fields) {
+	return fields.filter((field) => data.some((item) => {
+		const value = fieldValue(item, field);
+		return value !== void 0 && value !== "";
+	}));
+}
 function formatHumanChunk(chunk) {
 	const arrayData = Array.isArray(chunk.data) ? chunk.data : [chunk.data];
 	const isList = Array.isArray(chunk.data);
@@ -42,48 +48,28 @@ function formatHumanChunk(chunk) {
 		out += formatTitle(chunk.title, chunk.colorTitle) + "\n";
 	}
 	if (!arrayData.length) return out;
-	const fields = chunk.fields.filter((field) => arrayData.some((item) => {
-		const value = fieldValue(item, field);
-		return value !== void 0 && value !== "";
-	}));
+	if (isList) {
+		const fields = presentFields(arrayData, chunk.fields);
+		if (fields.length) {
+			const headers = fields.map(titleCaseField);
+			const rows = arrayData.map((item) => fields.map((field) => cellText(item, field, chunk.renderColumns)));
+			out += formatColumns(headers, rows, naturalWidths(headers, rows)) + "\n";
+		}
+		return out;
+	}
+	const fields = presentFields(arrayData, chunk.fields);
 	if (!fields.length) return out;
-	const headers = fields.map(titleCaseField);
-	const rows = arrayData.map((item) => fields.map((field) => cellText(item, field, chunk.renderColumns)));
-	const body = isList ? formatList(headers, rows, chunk.width) : formatStacked(headers, rows, chunk.width);
+	const body = formatStacked(fields.map(titleCaseField), arrayData.map((item) => fields.map((field) => cellText(item, field, chunk.renderColumns))), chunk.width);
 	if (body) out += body + "\n";
 	return out;
 }
 function formatTitle(title, colorTitle) {
 	return colorTitle ? chalk.bold(title) : title;
 }
-function formatList(headers, rows, width) {
-	if (headers.length === 1) return formatOneColumn(headers[0] ?? "", rows.map((row) => row[0] ?? ""));
-	if (width === void 0) return formatColumns(headers, rows, naturalWidths(headers, rows));
-	for (let n = headers.length; n >= 2; n--) {
-		const subsetHeaders = headers.slice(0, n);
-		const subsetRows = rows.map((row) => row.slice(0, n));
-		const natural = naturalWidths(subsetHeaders, subsetRows);
-		if (rowWidth(natural) <= width) return formatColumns(subsetHeaders, subsetRows, natural);
-		const fitted = tryFit(subsetHeaders, subsetRows, width);
-		if (fitted === void 0) continue;
-		if (!natural.slice(0, n - 1).every((col, i) => fitted[i] === col)) continue;
-		return formatColumns(subsetHeaders.map((cell, i) => truncateTo(cell, fitted[i] ?? 0)), subsetRows.map((row) => row.map((cell, i) => truncateTo(cell, fitted[i] ?? 0))), fitted);
-	}
-	return formatStacked(headers, rows, width);
-}
-function rowWidth(widths) {
-	if (widths.length === 0) return 0;
-	return widths.reduce((sum, col) => sum + col, 0) + (widths.length - 1) * GUTTER;
-}
-function formatOneColumn(header, values) {
-	const lines = [chalk.green(header)];
-	for (const value of values) lines.push(value);
-	return lines.join("\n");
-}
 function formatColumns(headers, rows, widths) {
 	const joinRow = (cells) => cells.map((cell, i) => {
 		const width = widths[i] ?? 0;
-		return i === cells.length - 1 ? truncateTo(cell, width) : padEndWidth(cell, width);
+		return i === cells.length - 1 ? cell : padEndWidth(cell, width);
 	}).join(" ".repeat(GUTTER)).trimEnd();
 	const lines = [chalk.green(joinRow(headers))];
 	for (const row of rows) lines.push(joinRow(row));
@@ -101,25 +87,6 @@ function formatStacked(headers, rows, width) {
 function stackedLine(header, value, labelWidth) {
 	return `${padEndWidth(header, labelWidth)}${" ".repeat(GUTTER)}${value}`;
 }
-function tryFit(headers, rows, width) {
-	const n = headers.length;
-	if (n === 0) return [];
-	const gutters = (n - 1) * GUTTER;
-	if (width <= gutters) return;
-	const budget = width - gutters;
-	if (budget < n * MIN_COL) return;
-	const widths = naturalWidths(headers, rows);
-	let overflow = widths.reduce((sum, col) => sum + col, 0) - budget;
-	if (overflow <= 0) return widths;
-	for (let i = n - 1; i >= 0 && overflow > 0; i--) {
-		const current = widths[i] ?? 0;
-		const take = Math.min(Math.max(current - MIN_COL, 0), overflow);
-		widths[i] = current - take;
-		overflow -= take;
-	}
-	if (overflow > 0) return;
-	return widths;
-}
 function naturalWidths(headers, rows) {
 	return headers.map((header, i) => Math.max(displayWidth(header), ...rows.map((row) => displayWidth(row[i] ?? ""))));
 }

package/dist/index.js

@@ -29,6 +29,7 @@ const NO_SUBCOMMANDS_VERBS = [
 	"link",
 	"open",
 	"init",
+	"mcp",
 	"dev",
 	"deploy",
 	"diff",

package/dist/init/agents.js

@@ -1,32 +1,6 @@
-import { agents, detectGlobalAgents, getAgentTypes } from "add-mcp";
+import { agentSupportsHttpMcp, agentSupportsProjectMcp, detectInstalledAgents, getAgentDisplayName, listMcpAgentIds, resolveAddMcpAgentId, tryResolveAddMcpAgentId } from "../mcp/agents.js";
+import { agents } from "add-mcp";
 //#region src/init/agents.ts
-const AGENT_ALIASES = {
-	cursor: "cursor",
-	copilot: "vscode",
-	"github-copilot": "vscode",
-	"vs-code": "vscode",
-	vscode: "vscode",
-	claude: "claude-code",
-	"claude-code": "claude-code",
-	"claude-desktop": "claude-desktop",
-	codex: "codex",
-	opencode: "opencode",
-	antigravity: "antigravity",
-	cline: "cline",
-	"cline-cli": "cline-cli",
-	"cline-vscode": "cline",
-	"gemini-cli": "gemini-cli",
-	gemini: "gemini-cli",
-	goose: "goose",
-	windsurf: "windsurf",
-	codeium: "windsurf",
-	cascade: "windsurf",
-	"github-copilot-cli": "github-copilot-cli",
-	mcporter: "mcporter",
-	zed: "zed",
-	grok: "grok-build",
-	"grok-build": "grok-build"
-};
 const SKILLS_AGENT_BY_TYPE = {
 	cursor: "cursor",
 	vscode: "github-copilot",
@@ -44,26 +18,6 @@ const SKILLS_AGENT_BY_TYPE = {
 	zed: "zed",
 	"grok-build": "grok"
 };
-function listMcpAgentIds() {
-	return getAgentTypes();
-}
-function getAgentDisplayName(id) {
-	return agents[id].displayName;
-}
-function agentSupportsProjectMcp(id) {
-	return Boolean(agents[id].localConfigPath);
-}
-function agentSupportsHttpMcp(id) {
-	return agents[id].supportedTransports.includes("http");
-}
-function tryResolveAddMcpAgentId(rawAgent) {
-	return AGENT_ALIASES[rawAgent.toLowerCase()];
-}
-function resolveAddMcpAgentId(rawAgent) {
-	const resolved = tryResolveAddMcpAgentId(rawAgent);
-	if (!resolved) throw new Error(`Unknown agent: "${rawAgent}". Supported agents: ${listMcpAgentIds().join(", ")}`);
-	return resolved;
-}
 function getSkillsAgentName(agent) {
 	if (Object.prototype.hasOwnProperty.call(SKILLS_AGENT_BY_TYPE, agent)) return SKILLS_AGENT_BY_TYPE[agent];
 	const id = tryResolveAddMcpAgentId(agent);
@@ -79,9 +33,6 @@ function agentPickerHint(id) {
 	if (supportsSkills(id)) return "MCP server, skills";
 	return "MCP server";
 }
-async function detectInstalledAgents() {
-	return detectGlobalAgents();
-}
 function mcpPickerOptions() {
 	return listMcpAgentIds().map((id) => ({
 		value: id,

package/dist/init/editors.js

@@ -1,4 +1,5 @@
-import { detectInstalledAgents } from "./agents.js";
+import { detectInstalledAgents } from "../mcp/agents.js";
+import "./agents.js";
 import { resolve } from "node:path";
 //#region src/init/editors.ts
 function getVSCodeGlobalConfigDir(homeDir) {

package/dist/init/interactive.js

@@ -1,11 +1,12 @@
 import { FALLBACK_TEMPLATES, fetchTemplates, scaffoldTemplate } from "./bootstrap.js";
 import { detectAgent, detectIde } from "./detect_agent.js";
 import { neonInitAgentCmd } from "./profile_cli.js";
-import { agentSupportsProjectMcp, detectInstalledAgents, getAgentDisplayName, getSkillsAgentName, mcpPickerOptions, tryResolveAddMcpAgentId } from "./agents.js";
+import { installNeonMcpServer } from "../mcp/install.js";
+import { agentSupportsProjectMcp, detectInstalledAgents, getAgentDisplayName, tryResolveAddMcpAgentId } from "../mcp/agents.js";
+import { getSkillsAgentName, mcpPickerOptions } from "./agents.js";
 import { ensureNeonctlAuth, isAuthenticated } from "./auth.js";
 import { installExtension, isExtensionInstalled } from "./extension.js";
 import { inspectProject } from "./inspect.js";
-import { installNeonMcpServer } from "./install_mcp.js";
 import { ensureNeonctl } from "./neonctl.js";
 import { ensureSkillsUpToDate, installAgentSkills, skillsInstalledForAgent } from "./skills.js";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";

package/dist/init/orchestrate.js

@@ -1,4 +1,5 @@
-import { supportsSkills, tryResolveAddMcpAgentId } from "./agents.js";
+import { tryResolveAddMcpAgentId } from "../mcp/agents.js";
+import { supportsSkills } from "./agents.js";
 import { isAuthenticated } from "./auth.js";
 import { inspectProject } from "./inspect.js";
 import { getSkillList, missingSkillsForAgent, skillsInstalledForAgent } from "./skills.js";

package/dist/init/phases/mcp.js

@@ -1,6 +1,7 @@
-import { agentSupportsHttpMcp, agentSupportsProjectMcp, getAgentDisplayName, getSkillsAgentName, resolveAddMcpAgentId, tryResolveAddMcpAgentId } from "../agents.js";
+import { installNeonMcpServer } from "../../mcp/install.js";
+import { agentSupportsHttpMcp, agentSupportsProjectMcp, getAgentDisplayName, resolveAddMcpAgentId, tryResolveAddMcpAgentId } from "../../mcp/agents.js";
+import { getSkillsAgentName } from "../agents.js";
 import { isAuthenticated } from "../auth.js";
-import { installNeonMcpServer } from "../install_mcp.js";
 //#region src/init/phases/mcp.ts
 function skillsFollowUp(agent) {
 	if (agent && !getSkillsAgentName(agent)) return agent ? [

package/dist/init/phases/setup.js

@@ -1,10 +1,11 @@
 import { FALLBACK_TEMPLATES, fetchTemplates, findTemplate, scaffoldTemplate } from "../bootstrap.js";
 import { detectIde, isCursorInstalled, isVSCodeInstalled } from "../detect_agent.js";
-import { agentSupportsProjectMcp, getSkillsAgentName, listMcpAgentIds, resolveAddMcpAgentId, supportsSkills, tryResolveAddMcpAgentId } from "../agents.js";
+import { installNeonMcpServer } from "../../mcp/install.js";
+import { agentSupportsProjectMcp, listMcpAgentIds, resolveAddMcpAgentId, tryResolveAddMcpAgentId } from "../../mcp/agents.js";
+import { getSkillsAgentName, supportsSkills } from "../agents.js";
 import { NEON_EXTENSION_ID, downloadVsix } from "../vsix.js";
 import { findEditorCommand } from "../extension.js";
 import { inspectProject } from "../inspect.js";
-import { installNeonMcpServer } from "../install_mcp.js";
 import { ensureNeonctl } from "../neonctl.js";
 import { ensureSkillsUpToDate } from "../skills.js";
 import { writeFileSync } from "node:fs";