@cargo-ai/cli 1.0.65 → 1.0.67

package/build/commands/mcp.d.ts

@@ -1,4 +1,6 @@
 import type { Command } from "commander";
 import type { Api } from "../api.js";
-export declare function registerMcpCommand(parent: Command, getApi: () => Api): void;
+export declare function registerMcpCommand(parent: Command, _getApi: () => Api): void;
+export declare const resolveServerUuid: (explicit: string | undefined) => string | undefined;
+export declare const resolveMcpEndpoint: (baseUrl: string, uuid: string | undefined) => string;
 //# sourceMappingURL=mcp.d.ts.map

package/build/commands/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAerC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAoD3E"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAerC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,IAAI,CAuD5E;AAED,eAAO,MAAM,iBAAiB,aAClB,MAAM,GAAG,SAAS,KAC3B,MAAM,GAAG,SAOX,CAAC;AAEF,eAAO,MAAM,kBAAkB,YACpB,MAAM,QACT,MAAM,GAAG,SAAS,KACvB,MAaF,CAAC"}

package/build/commands/mcp.js

@@ -4,7 +4,7 @@ import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { getConfig } from "../config.js";
 import { getProxyFetch } from "../proxy.js";
-import { ExitCodes, failWith, handleApiCall, info } from "./runHandler.js";
+import { ExitCodes, failWith, info } from "./runHandler.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../../package.json");
 // The prod REST API and the prod MCP server are the same backend image behind
@@ -13,18 +13,21 @@ const { version } = require("../../package.json");
 // base URL (staging, localhost) untouched — that same host serves the MCP routes.
 const PROD_API_HOST = "api.getcargo.io";
 const PROD_MCP_HOST = "mcp.getcargo.io";
-export function registerMcpCommand(parent, getApi) {
+export function registerMcpCommand(parent, _getApi) {
     parent
         .command("mcp")
         .description("Run a local MCP server that bridges to a Cargo MCP server over stdio")
-        .option("--server <uuid>", "MCP server UUID to expose (default: CARGO_MCP_SERVER_UUID, or the workspace's only MCP server)")
+        .option("--server <uuid>", "Curated MCP server UUID (default: CARGO_MCP_SERVER_UUID, or the platform Cargo MCP)")
         .addHelpText("after", `
 Exposes a Cargo-hosted MCP server as a local stdio MCP server, so any stdio MCP
 client (Claude Code, Claude Desktop, Cursor, ...) can use it with the CLI's own
 credentials — no token to copy into client config.
 
+With no --server, bridges to the platform Cargo MCP (find/execute actions).
+Pass --server <uuid> to bridge a curated server instead.
+
 Register it with a client, e.g. Claude Code:
-  $ claude mcp add cargo -- cargo-ai mcp --server <uuid>
+  $ claude mcp add cargo -- cargo-ai mcp
 
 Environment:
   CARGO_MCP_SERVER_UUID   default --server value
@@ -37,7 +40,7 @@ credentials file). stdout carries the MCP protocol; all logs go to stderr.`)
         if (getAccessToken === undefined) {
             failWith('Not authenticated. Run "cargo-ai login --email <email>" (no browser needed) or "cargo-ai login --oauth".', { code: ExitCodes.NotAuthenticated });
         }
-        const serverUuid = await resolveServerUuid(opts.server, getApi);
+        const serverUuid = resolveServerUuid(opts.server);
         const endpoint = resolveMcpEndpoint(baseUrl, serverUuid);
         const headers = {
             "x-cargo-origin": "cli",
@@ -50,39 +53,24 @@ credentials file). stdout carries the MCP protocol; all logs go to stderr.`)
         await runBridge(endpoint, headers, getAccessToken);
     });
 }
-const resolveServerUuid = async (explicit, getApi) => {
+export const resolveServerUuid = (explicit) => {
     if (explicit !== undefined)
         return explicit;
     const fromEnv = process.env["CARGO_MCP_SERVER_UUID"];
     if (fromEnv !== undefined && fromEnv.length > 0)
         return fromEnv;
-    const api = getApi();
-    const { mcpServers } = await handleApiCall(() => api.ai.mcpServer.all(), {
-        spinner: false,
-    });
-    if (mcpServers.length === 0) {
-        failWith("No MCP server in this workspace. Create one with 'cargo-ai ai mcp-server create --name ...', then pass --server <uuid>.", { code: ExitCodes.InvalidUsage });
-    }
-    const only = mcpServers[0];
-    if (mcpServers.length > 1 || only === undefined) {
-        failWith("Multiple MCP servers found; pass --server <uuid>.", {
-            code: ExitCodes.InvalidUsage,
-            extra: {
-                servers: mcpServers.map((server) => ({
-                    uuid: server.uuid,
-                    name: server.name,
-                })),
-            },
-        });
-    }
-    return only.uuid;
+    return undefined;
 };
-const resolveMcpEndpoint = (baseUrl, uuid) => {
+export const resolveMcpEndpoint = (baseUrl, uuid) => {
     const override = process.env["CARGO_MCP_BASE_URL"];
     const origin = override !== undefined && override.length > 0
         ? override
         : mapApiHostToMcp(baseUrl);
-    return `${origin.replace(/\/+$/, "")}/v1/ai/mcpServers/${uuid}/mcp`;
+    const normalized = origin.replace(/\/+$/, "");
+    if (uuid === undefined) {
+        return `${normalized}/mcp`;
+    }
+    return `${normalized}/v1/ai/mcpServers/${uuid}/mcp`;
 };
 const mapApiHostToMcp = (baseUrl) => {
     try {

package/build/commands/orchestration/action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAcxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAuMN"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/commands/orchestration/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAcxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAuRN"}

package/build/commands/orchestration/action.js

@@ -3,21 +3,59 @@ import { applyRecordsLimit, ExitCodes, failWith, handleApiCall, outputJson, pars
 export function registerActionCommands(parent, getApi) {
     const action = parent
         .command("action")
-        .description("Execute actions (single run or batch)")
+        .description("List and execute actions (single run or batch)")
         .addHelpText("after", `
 The default way to run a tool or connector action: no workflow, release, or node
 graph needed. Creates a run and consumes credits.
 
-  - 'config' inside --action must be empty ({}); inputs go in --data.
+  - List first: 'cargo-ai orchestration action list enrich'
+    Each result includes an 'action' object for execute / execute-batch /
+    get-output-schema.
+  - Inputs go in --data, not in the action. 'config' is optional; omit it.
   - The run is asynchronous: pass --wait-until-finished, or poll it with
     'cargo-ai orchestration run get <uuid>'.
 
 To debug a node inside an existing workflow instead, use
 'cargo-ai orchestration node'.`);
+    const listableKinds = ["connector", "native", "tool", "agent"];
+    action
+        .command("list")
+        .description("List actions")
+        .argument("[query...]", "Keywords to match (space-separated, optional)")
+        .option("--kind <kind>", "Restrict to one kind: connector, native, tool, or agent (enum)")
+        .option("--integration-slug <slug>", "Restrict connector actions to this integration (string)")
+        .option("--limit <n>", "Maximum results to return (integer, default: 20, max: 50)", "20")
+        .addHelpText("after", `
+Each result includes an 'action' object you can pass to execute, execute-batch,
+or get-output-schema. All query terms must match (AND). Matches on the action
+slug or name rank above integration matches, which rank above description.
+
+Examples:
+  $ cargo-ai orchestration action list enrich
+  $ cargo-ai orchestration action list --kind tool
+  $ cargo-ai orchestration action list send --kind connector --integration-slug slack`)
+        .action(async (queryTerms, opts) => {
+        let kind;
+        if (opts.kind !== undefined) {
+            kind = listableKinds.find((value) => value === opts.kind);
+            if (kind === undefined) {
+                failWith('--kind must be "connector", "native", "tool", or "agent".', { code: ExitCodes.InvalidUsage });
+            }
+        }
+        const limit = parsePositiveInt(opts.limit, "--limit");
+        const query = queryTerms.length === 0 ? undefined : queryTerms.join(" ");
+        const result = await handleApiCall(() => getApi().orchestration.action.list({
+            query,
+            kind,
+            integrationSlug: opts.integrationSlug,
+            limit,
+        }));
+        outputJson(result);
+    });
     action
         .command("execute")
         .description("Execute a single action")
-        .requiredOption("--action <json>", 'Action definition (JSON object, required). Example: \'{"kind":"tool","toolUuid":"550e8400-...","config":{}}\'')
+        .requiredOption("--action <json>", 'Action definition (JSON object, required). Example: \'{"kind":"tool","toolUuid":"550e8400-..."}\'')
         .requiredOption("--data <json>", "Input data for the run (JSON object, required)")
         .option("--wait-until-finished [value]", "Poll the run until it reaches a terminal status before returning (true/false, defaults to true when passed bare)", parseBooleanOption)
         .option("--polling-interval <ms>", "Polling interval in milliseconds, used with --wait-until-finished (integer, default: 5000)", "5000")
@@ -25,8 +63,8 @@ To debug a node inside an existing workflow instead, use
         .option("--webhook-secret <secret>", "Secret used to sign webhook deliveries")
         .addHelpText("after", `
 Examples:
-  $ cargo-ai orchestration action execute --action '{"kind":"tool","toolUuid":"550e8400-...","config":{}}' --data '{"email":"user@example.com"}'
-  $ cargo-ai orchestration action execute --action '{"kind":"connector","integrationSlug":"slack","actionSlug":"send-message","config":{}}' --data '{"channel":"#general","text":"hello"}' --wait-until-finished`)
+  $ cargo-ai orchestration action execute --action '{"kind":"tool","toolUuid":"550e8400-..."}' --data '{"email":"user@example.com"}'
+  $ cargo-ai orchestration action execute --action '{"kind":"connector","integrationSlug":"slack","actionSlug":"send-message"}' --data '{"channel":"#general","text":"hello"}' --wait-until-finished`)
         .action(async (opts) => {
         const actionPayload = parseJson(opts.action, "--action");
         const data = parseJson(opts.data, "--data");
@@ -48,7 +86,7 @@ Examples:
     action
         .command("execute-batch")
         .description("Execute an action as a batch over multiple records")
-        .requiredOption("--action <json>", 'Action definition (JSON object, required). Example: \'{"kind":"tool","toolUuid":"550e8400-...","config":{}}\'')
+        .requiredOption("--action <json>", 'Action definition (JSON object, required). Example: \'{"kind":"tool","toolUuid":"550e8400-..."}\'')
         .requiredOption("--records <json>", 'Records to process (JSON array, required). Example: \'[{"email":"a@b.com"},{"email":"c@d.com"}]\'')
         .option("--webhook-url <url>", "URL to call when the batch completes")
         .option("--webhook-secret <secret>", "Secret used to sign webhook deliveries")
@@ -57,9 +95,9 @@ Examples:
         .option("--polling-interval <ms>", "Polling interval in milliseconds, used with --wait-until-finished (integer, default: 5000)", "5000")
         .addHelpText("after", `
 Examples:
-  $ cargo-ai orchestration action execute-batch --action '{"kind":"tool","toolUuid":"550e8400-...","config":{}}' --records '[{"email":"a@b.com"},{"email":"c@d.com"}]'
-  $ cargo-ai orchestration action execute-batch --action '{"kind":"connector","integrationSlug":"slack","actionSlug":"send-message","config":{}}' --records '[{"channel":"#general"}]' --wait-until-finished
-  $ cargo-ai orchestration action execute-batch --action '{"kind":"connector","integrationSlug":"waterfall","actionSlug":"findEmail","config":{}}' --records "$(cat records.json)" --limit 1 --wait-until-finished`)
+  $ cargo-ai orchestration action execute-batch --action '{"kind":"tool","toolUuid":"550e8400-..."}' --records '[{"email":"a@b.com"},{"email":"c@d.com"}]'
+  $ cargo-ai orchestration action execute-batch --action '{"kind":"connector","integrationSlug":"slack","actionSlug":"send-message"}' --records '[{"channel":"#general"}]' --wait-until-finished
+  $ cargo-ai orchestration action execute-batch --action '{"kind":"connector","integrationSlug":"waterfall","actionSlug":"findEmail"}' --records "$(cat records.json)" --limit 1 --wait-until-finished`)
         .action(async (opts) => {
         const actionPayload = parseJson(opts.action, "--action");
         let records = parseJson(opts.records, "--records");
@@ -90,16 +128,26 @@ Examples:
     action
         .command("get-output-schema")
         .description("Resolve the JSON schema of an action's data output without executing it")
-        .requiredOption("--action <json>", 'Action definition (JSON object, required). Example: \'{"kind":"tool","toolUuid":"550e8400-...","config":{}}\'')
+        .requiredOption("--action <json>", 'Action definition (JSON object, required). Example: \'{"kind":"tool","toolUuid":"550e8400-..."}\'')
+        .option("--data <json>", 'Inputs the action would run with (JSON object, optional). Only needed when the output schema depends on them. Example: \'{"objectType":"contacts"}\'')
         .addHelpText("after", `
+Nothing is executed and no credits are consumed. Pass the 'action' object from
+'cargo-ai orchestration action list' as-is.
+
+Some actions shape their output from their inputs — a HubSpot object type, a
+Google Sheet. Pass those in --data, exactly as you would to 'action execute'.
+
 Examples:
-  $ cargo-ai orchestration action get-output-schema --action '{"kind":"tool","toolUuid":"550e8400-...","config":{}}'
-  $ cargo-ai orchestration action get-output-schema --action '{"kind":"connector","integrationSlug":"clearbit","actionSlug":"company_enrich","config":{}}'`)
+  $ cargo-ai orchestration action get-output-schema --action '{"kind":"tool","toolUuid":"550e8400-..."}'
+  $ cargo-ai orchestration action get-output-schema --action '{"kind":"connector","integrationSlug":"clearbit","actionSlug":"company_enrich"}'
+  $ cargo-ai orchestration action get-output-schema --action '{"kind":"connector","integrationSlug":"hubspot","actionSlug":"findRecords"}' --data '{"objectType":"contacts"}'`)
         .action(async (opts) => {
         const actionPayload = parseJson(opts.action, "--action");
+        const dataPayload = opts.data === undefined ? undefined : parseJson(opts.data, "--data");
         const api = getApi();
         const result = await handleApiCall(() => api.orchestration.action.getOutputSchema({
             action: actionPayload,
+            data: dataPayload,
         }));
         outputJson(result);
     });

package/build/commands/revenueOrganization/member.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"member.d.ts","sourceRoot":"","sources":["../../../src/commands/revenueOrganization/member.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA8EN"}
+{"version":3,"file":"member.d.ts","sourceRoot":"","sources":["../../../src/commands/revenueOrganization/member.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CA2FN"}

package/build/commands/revenueOrganization/member.js

@@ -49,6 +49,7 @@ export function registerMemberCommands(parent, getApi) {
         .description("Update a member")
         .requiredOption("--uuid <uuid>", "Member UUID")
         .option("--meta <json>", 'Member metadata (JSON object, e.g. {"key":"value"})')
+        .option("--mailbox-uuids <uuids>", "Mailbox UUIDs to attach (comma-separated; empty to detach all)")
         .action(async (opts) => {
         const api = getApi();
         const result = await handleApiCall(() => api.revenueOrganization.member.update({
@@ -56,6 +57,12 @@ export function registerMemberCommands(parent, getApi) {
             meta: opts.meta !== undefined
                 ? parseJson(opts.meta, "--meta")
                 : undefined,
+            mailboxUuids: opts.mailboxUuids === undefined
+                ? undefined
+                : opts.mailboxUuids
+                    .split(",")
+                    .map((uuid) => uuid.trim())
+                    .filter((uuid) => uuid.length > 0),
         }));
         outputJson(result);
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cli",
-  "version": "1.0.65",
+  "version": "1.0.67",
   "private": false,
   "license": "UNLICENSED",
   "homepage": "https://getcargo.ai",
@@ -64,10 +64,10 @@
     "format:check": "prettier --check ."
   },
   "dependencies": {
-    "@cargo-ai/api": "^1.0.67",
+    "@cargo-ai/api": "^1.0.69",
     "@cargo-ai/app-sdk": "^1.0.9",
-    "@cargo-ai/cdk": "^1.0.52",
-    "@cargo-ai/types": "^1.0.65",
+    "@cargo-ai/cdk": "^1.0.53",
+    "@cargo-ai/types": "^1.0.66",
     "@cargo-ai/worker-sdk": "^1.0.17",
     "@modelcontextprotocol/sdk": "1.29.0",
     "commander": "^12.1.0",