@rymi/mcp 2.4.0 → 2.6.0

package/README.md

@@ -63,7 +63,7 @@ Run the server on your own machine — it speaks **stdio** by default and talks
 }
 ```
 
-> **Options:** `RYMI_MCP_READONLY=1` hides every mutating tool (including `create_call`, `batch_call`, `publish_agent`). `RYMI_WORKSPACE` makes the local server act in that workspace (sent as the `Rymi-Workspace` header). On the hosted endpoint, send the `Rymi-Workspace` header on the HTTP request instead.
+> **Options:** `RYMI_MCP_READONLY=1` hides every mutating tool (including `create_call`, `batch_call`, `publish_agent`). `RYMI_WORKSPACE` makes the local server act in that workspace (sent as the `Rymi-Workspace` header). On the hosted endpoint, send the `Rymi-Workspace` header on the HTTP request instead. Every tool also takes an optional `workspace` argument, so one connection can act in any workspace it can reach, such as an agency's client workspaces.
 >
 > This package speaks **stdio** only. `--transport http` was removed in 2.0.0 — use the hosted endpoint above, which the local server could never match on auth (it has no OAuth, and no per-key tool gating).
 
@@ -137,7 +137,11 @@ Run the server on your own machine — it speaks **stdio** by default and talks
 </tr>
 <tr>
 <td><b>Workspaces</b></td>
-<td><code>list_workspaces</code> · <code>create_workspace</code></td>
+<td><code>list_workspaces</code> · <code>create_workspace</code> · <code>update_workspace</code> · <code>get_workspace_usage</code> · <code>list_workspace_members</code> · <code>add_workspace_member</code> · <code>remove_workspace_member</code></td>
+</tr>
+<tr>
+<td><b>Compliance settings</b></td>
+<td><code>get_compliance_settings</code> · <code>update_compliance_settings</code></td>
 </tr>
 </table>
 

package/dist/index.js

@@ -373,7 +373,8 @@ var require_dist = __commonJS({
     __export2(index_exports, {
       defineTool: () => defineTool,
       opsToolCatalog: () => opsToolCatalog2,
-      resolveToolDisposition: () => resolveToolDisposition
+      resolveToolDisposition: () => resolveToolDisposition,
+      withWorkspaceParam: () => withWorkspaceParam2
     });
     module2.exports = __toCommonJS2(index_exports);
     function defineTool(def) {
@@ -1641,7 +1642,7 @@ var require_dist = __commonJS({
     var workspaceTools = [
       defineTool({
         name: "list_workspaces",
-        description: "List the workspaces this credential can act in, marking the current one. Act in another by setting RYMI_WORKSPACE (local MCP) or the Rymi-Workspace header.",
+        description: "List the workspaces this credential can act in, marking the current one. Client workspaces show their agency in parent_id. Act in another by setting RYMI_WORKSPACE (local MCP) or the Rymi-Workspace header.",
         scope: "account",
         risk: "read",
         input: {},
@@ -1649,14 +1650,100 @@ var require_dist = __commonJS({
       }),
       defineTool({
         name: "create_workspace",
-        description: "Create a standalone workspace you own, with its own agents, numbers, keys and balance. It gets no free monthly credit.",
+        description: "Create a standalone workspace you own, or, with parent, a client workspace of an agency workspace you run. The agency pays for a client workspace's calls. Neither gets the free monthly credit.",
         scope: "account",
         risk: "write",
         input: {
           name: import_zod13.z.string().min(1).max(80).describe("Workspace name"),
-          operating_country: import_zod13.z.string().length(2).optional().describe('ISO-3166 alpha-2 country, e.g. "IN"')
+          operating_country: import_zod13.z.string().length(2).optional().describe('ISO-3166 alpha-2 country, e.g. "IN"'),
+          parent: import_zod13.z.string().optional().describe("Agency workspace id. Makes this a client workspace the agency pays for.")
         },
         run: (client, params) => client.workspaces.create(params)
+      }),
+      defineTool({
+        name: "get_workspace_usage",
+        description: "Calls, minutes and credits for one workspace in a calendar month (UTC). Use it to invoice a client workspace. Credits are left out for client-role users.",
+        scope: "account",
+        risk: "read",
+        input: {
+          workspace_id: import_zod13.z.string().describe("Workspace id from list_workspaces"),
+          month: import_zod13.z.string().regex(/^\d{4}-\d{2}$/).optional().describe("YYYY-MM; default this month")
+        },
+        run: (client, params) => client.workspaces.usage(params.workspace_id, { month: params.month })
+      }),
+      defineTool({
+        name: "update_workspace",
+        description: "Rename a workspace, change its operating country, or set a client workspace's monthly spend cap in credits (1 credit = $0.01; null removes the cap). Calls in that client workspace stop at the cap until next month.",
+        scope: "account",
+        risk: "write",
+        input: {
+          workspace_id: import_zod13.z.string().describe("Workspace id from list_workspaces"),
+          name: import_zod13.z.string().min(1).max(80).optional().describe("New name"),
+          operating_country: import_zod13.z.string().length(2).nullable().optional().describe('ISO-3166 alpha-2 country, e.g. "IN"; null clears it'),
+          spend_cap_cents_monthly: import_zod13.z.number().int().min(0).nullable().optional().describe("Client workspaces only: monthly cap in credits; null removes it")
+        },
+        run: (client, { workspace_id, ...patch }) => client.workspaces.update(workspace_id, patch)
+      }),
+      defineTool({
+        name: "list_workspace_members",
+        description: "People in a workspace and their roles (owner, admin, client).",
+        scope: "account",
+        risk: "read",
+        input: { workspace_id: import_zod13.z.string().describe("Workspace id from list_workspaces") },
+        run: (client, params) => client.workspaces.listMembers(params.workspace_id)
+      }),
+      defineTool({
+        name: "add_workspace_member",
+        description: "Add a person by email. A client workspace takes the client role (sees calls and minutes, edits contacts, the do-not-call list, knowledge and the transfer number); other workspaces take admin. Someone without a Rymi account gets an invite email.",
+        scope: "account",
+        risk: "sensitive",
+        input: {
+          workspace_id: import_zod13.z.string().describe("Workspace id from list_workspaces"),
+          email: import_zod13.z.string().email().describe("Their email address"),
+          role: import_zod13.z.enum(["admin", "client"]).optional().describe("Defaults to the role the workspace takes")
+        },
+        run: (client, { workspace_id, ...member }) => client.workspaces.addMember(workspace_id, member)
+      }),
+      defineTool({
+        name: "remove_workspace_member",
+        description: "Remove a person's access to a workspace. The owner can't be removed.",
+        scope: "account",
+        risk: "sensitive",
+        input: {
+          workspace_id: import_zod13.z.string().describe("Workspace id from list_workspaces"),
+          user_id: import_zod13.z.string().describe("user_id from list_workspace_members")
+        },
+        run: (client, params) => client.workspaces.removeMember(params.workspace_id, params.user_id)
+      })
+    ];
+    var import_zod14 = require("zod");
+    var rules = import_zod14.z.object({
+      calling_hours: import_zod14.z.object({ start_hour: import_zod14.z.number().int().min(0).max(23), end_hour: import_zod14.z.number().int().min(1).max(24) }).nullable().optional().describe("Callee-local calling hours; null = any hour"),
+      dnc_check: import_zod14.z.boolean().optional().describe("Check the workspace do-not-call list before calls"),
+      require_voice_consent: import_zod14.z.boolean().optional().describe("Require recorded voice consent on the contact"),
+      recording_notice: import_zod14.z.boolean().optional().describe("Recording notice default for new agents"),
+      destination_countries: import_zod14.z.array(import_zod14.z.string().length(2)).nullable().optional().describe("Countries this workspace may call; null = all supported"),
+      apply_to_single_calls: import_zod14.z.boolean().optional().describe("Also apply hours and consent to single calls")
+    }).partial();
+    var complianceTools = [
+      defineTool({
+        name: "get_compliance_settings",
+        description: "Read the workspace's compliance settings: operating country, callee-local calling hours, do-not-call check, voice consent, recording-notice default and allowed destination countries. Compliance is the customer's responsibility; these settings help.",
+        scope: "account",
+        risk: "read",
+        input: {},
+        run: (client) => client.compliance.getSettings()
+      }),
+      defineTool({
+        name: "update_compliance_settings",
+        description: "Change the workspace's compliance settings. Setting operating_country fills every setting not already edited from that country's preset. Blocked calls fail with destination_not_allowed, outside_calling_hours or no_voice_consent.",
+        scope: "account",
+        risk: "write",
+        input: {
+          operating_country: import_zod14.z.string().length(2).nullable().optional().describe('ISO country, e.g. "IN"'),
+          rules: rules.optional()
+        },
+        run: (client, params) => client.compliance.updateSettings(params)
       })
     ];
     var import_agentTools2 = (init_agentTools(), __toCommonJS(agentTools_exports));
@@ -1693,13 +1780,26 @@ var require_dist = __commonJS({
       ...billingTools,
       ...campaignTools,
       ...shareLinkTools,
-      ...workspaceTools
+      ...workspaceTools,
+      ...complianceTools
     ].map((t) => ({ ...t, run: async (client, params) => redactToolSecrets(await t.run(client, params)) }));
     var names = /* @__PURE__ */ new Set();
     for (const tool of opsToolCatalog2) {
       if (names.has(tool.name)) throw new Error(`Duplicate ops tool name: ${tool.name}`);
       names.add(tool.name);
     }
+    var import_zod15 = require("zod");
+    var WORKSPACE = import_zod15.z.string().optional().describe("Act in this workspace, e.g. one of your client workspaces (id from list_workspaces). Default: the workspace this connection uses.");
+    function withWorkspaceParam2(tool) {
+      return {
+        ...tool,
+        input: { ...tool.input, workspace: WORKSPACE },
+        run: (client, params) => {
+          const { workspace, ...rest } = params;
+          return tool.run(typeof workspace === "string" && workspace ? client.withWorkspace(workspace) : client, rest);
+        }
+      };
+    }
   }
 });
 
@@ -1729,7 +1829,7 @@ function withToolErrors(handler) {
 // package.json
 var package_default = {
   name: "@rymi/mcp",
-  version: "2.4.0",
+  version: "2.6.0",
   description: "Rymi MCP server \u2014 manage AI voice agents via Model Context Protocol",
   license: "MIT",
   author: "Rymi AI <engineering@rymi.live>",
@@ -1797,7 +1897,7 @@ function createServer(apiKey2) {
     version: package_default.version
   });
   const isReadOnly = process.env.RYMI_MCP_READONLY === "1";
-  for (const tool of import_ops_tools.opsToolCatalog) {
+  for (const tool of import_ops_tools.opsToolCatalog.map(import_ops_tools.withWorkspaceParam)) {
     if (isReadOnly && tool.risk !== "read") continue;
     server2.tool(
       tool.name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rymi/mcp",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "description": "Rymi MCP server — manage AI voice agents via Model Context Protocol",
   "license": "MIT",
   "author": "Rymi AI <engineering@rymi.live>",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.11.1",
-    "@rymi/node": "^2.3.0",
+    "@rymi/node": "^2.5.0",
     "zod": "^3.23.0"
   },
   "devDependencies": {