@anychat-ai/mcp 0.51.0 → 0.52.0

package/README.md

@@ -49,7 +49,7 @@ Flags: `--profile core|full` picks the tool set (default `full`, see [Profiles](
 
 ## Tools
 
-191 tools, a 1:1 projection of the [Agent API](https://docs.anychat.ai/reference/agent-api/) grouped as the reference is (orient → Definition → Capabilities → Channels → People → Campaigns → Tests → Testers → Activity → Org → Docs). `npx -y @anychat-ai/mcp tools` prints the live table.
+195 tools, a 1:1 projection of the [Agent API](https://docs.anychat.ai/reference/agent-api/) grouped as the reference is (orient → Definition → Capabilities → Channels → People → Campaigns → Tests → Testers → Emulator → Activity → Org → Docs). `npx -y @anychat-ai/mcp tools` prints the live table.
 
 Every tool carries MCP annotations: `read` tools are `readOnlyHint`; `write` tools change configuration; `destructive` tools (deletes, outreach sends to real people, provisioning requests, imports over an existing agent, secret rotation) are `destructiveHint` so your host asks before running them.
 
@@ -57,8 +57,8 @@ Every tool carries MCP annotations: `read` tools are `readOnlyHint`; `write` too
 
 Every tool definition (name, description, input schema) is sent to the model on every call, so a big table has a real per-turn cost. Two profiles trade breadth for weight:
 
-- **`full`** (default) — all 183 tools.
-- **`core`** — 72 tools, the everyday set: `whoami`; agents (list / get / create / update / export / import, apply template, catalogs); the whole Definition (identity, personality, standing instructions, guardrails, rules, goals, playbooks, message templates, `lint_agent`); the media library (list / add / update / delete); tool bindings (list / upsert); scheduling config; People field definitions; outreach config; Things (read); Facts (read / replace); business info (read / replace); channels (list / get / request / bind, early access, launch); people (list / get / update, send outreach, list segments); testers (list); conversations / messages / logs / activity; org; docs. About half the tokens of `full`.
+- **`full`** (default) — all 195 tools.
+- **`core`** — 74 tools, the everyday set: `whoami`; agents (list / get / create / update / export / import, apply template, catalogs); the whole Definition (identity, personality, standing instructions, guardrails, rules, goals, playbooks, message templates, `lint_agent`); the media library (list / add / update / delete); tool bindings (list / upsert); scheduling config; People field definitions; outreach config; Things (read); Facts (read / replace); business info (read / replace); channels (list / get / request / bind, early access, launch); people (list / get / update, send outreach, list segments); testers (list); emulator links (list / create); conversations / messages / logs / activity; org; docs. About half the tokens of `full`.
 
 Pick one with `--profile core` on the CLI or `createServer({ profile: 'core' })` in code; the `Profile` column below shows which set each tool belongs to, and `npx -y @anychat-ai/mcp tools --profile core` lists just that set. Nothing else changes: `full` stays the default, and the `core` set only ever grows — a tool leaves it only when the route behind it is retired.
 
@@ -241,6 +241,10 @@ Pick one with `--profile core` on the CLI or `createServer({ profile: 'core' })`
 | `set_tester_disabled`               | write       | `agents:write`         | full    | Disable or enable tester                            |
 | `regenerate_tester_link`            | destructive | `agents:write`         | full    | Regenerate tester sign-in link                      |
 | `remove_tester`                     | destructive | `agents:write`         | full    | Remove tester                                       |
+| `list_emulator_links`               | read        | `agents:read`          | core    | List standalone emulator links                      |
+| `create_emulator_link`              | destructive | `agents:write`         | core    | Create a standalone emulator link                   |
+| `revoke_emulator_link`              | destructive | `agents:write`         | full    | Revoke a standalone emulator link                   |
+| `create_emulator_grant`             | destructive | `agents:read`          | full    | Open the emulator now (short-lived grant)           |
 | `list_messages`                     | read        | `messages:read`        | core    | List messages                                       |
 | `list_sessions`                     | read        | `messages:read`        | core    | List sessions                                       |
 | `list_users`                        | read        | `messages:read`        | full    | List users                                          |

package/dist/tools/emulator.d.ts

@@ -0,0 +1 @@
+export declare const emulatorTools: import("../tool").AnyTool[];

package/dist/tools/emulator.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emulatorTools = void 0;
+const zod_1 = require("zod");
+const tool_1 = require("../tool");
+/**
+ * Emulator group — the sandbox emulator outside the console: standalone
+ * emulator links (share with a colleague who has no console account;
+ * revocable) and short-lived session grants (open the emulator page for
+ * an agent right now). Mirrors the "Emulator links" section of the API
+ * reference. Everything here is Sandbox: nothing done through a link or
+ * grant reaches a real customer.
+ *
+ * The create responses carry the link `url` exactly once. It is a
+ * credential for talking to the agent, so the tools that mint one are
+ * `destructive` (hosts prompt) and tell the model to hand it to the
+ * operator rather than paste it around.
+ */
+const URL_HANDLING = 'The response includes the url exactly once (a list never repeats it): give it to the operator to share — do not paste it anywhere else unprompted.';
+const agentIdField = zod_1.z.string();
+const linkIdField = zod_1.z.string().min(1).describe('Link id from list_emulator_links');
+function emulatorPath(agentId, resource, suffix = '') {
+    return `/agents/${encodeURIComponent(agentId)}/${resource}${suffix}`;
+}
+exports.emulatorTools = [
+    (0, tool_1.defineTool)({
+        name: 'list_emulator_links',
+        title: 'List standalone emulator links',
+        description: 'List the active standalone emulator links of an agent: id, label, expiresAt, createdAt, createdBy. A link lets someone without a console account talk to the agent in the sandbox emulator (RCS, Apple Messages, WhatsApp or SMS look) — nothing they do reaches a real customer. Expired and revoked links are not listed; the link url is never included (it is returned once, on create). Maps to GET /v1/orgs/{org}/agents/{agent}/emulator-links.',
+        kind: 'read',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        profile: 'core',
+        input: { agentId: agentIdField },
+        run: async ({ client }, { agentId }) => client.get(await client.orgPath(emulatorPath(agentId, 'emulator-links'))),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'create_emulator_link',
+        title: 'Create a standalone emulator link',
+        description: `Create a shareable sandbox emulator link for an agent — for a colleague, client or reviewer who works with the team but not in the console. It opens the emulator page for this one agent with no sign-in; conversations are sandbox conversations (kept beside the real ones, never counted, no real effects). ttlDays 1–90 (default 14); label is an optional note. ${URL_HANDLING} Revoke it any time with revoke_emulator_link. Maps to POST /v1/orgs/{org}/agents/{agent}/emulator-links.`,
+        kind: 'destructive',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        profile: 'core',
+        input: {
+            agentId: agentIdField,
+            ttlDays: zod_1.z
+                .number()
+                .int()
+                .min(1)
+                .max(90)
+                .optional()
+                .describe('Days until the link expires (default 14)'),
+            label: zod_1.z.string().max(200).optional().describe('Note, e.g. "Marketing review"'),
+        },
+        run: async ({ client }, { agentId, ttlDays, label }) => client.post(await client.orgPath(emulatorPath(agentId, 'emulator-links')), {
+            ...(ttlDays !== undefined ? { ttlDays } : {}),
+            ...(label !== undefined ? { label } : {}),
+        }),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'revoke_emulator_link',
+        title: 'Revoke a standalone emulator link',
+        description: 'Revoke a standalone emulator link: its url stops working immediately for everyone who has it. Irreversible — create a new link instead. 404 agent.emulator_link.not_found if the id is not a link of this agent. Maps to DELETE /v1/orgs/{org}/agents/{agent}/emulator-links/{id}.',
+        kind: 'destructive',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: { agentId: agentIdField, linkId: linkIdField },
+        run: async ({ client }, { agentId, linkId }) => {
+            const removed = await client.delete(await client.orgPath(emulatorPath(agentId, 'emulator-links', `/${encodeURIComponent(linkId)}`)));
+            return removed ?? { ok: true, revoked: linkId };
+        },
+    }),
+    (0, tool_1.defineTool)({
+        name: 'create_emulator_grant',
+        title: 'Open the emulator now (short-lived grant)',
+        description: `Mint a short-lived session grant for an agent's sandbox emulator and get the page url to open it right now — for the operator themselves, not for sharing (share with create_emulator_link instead). ttlSec 60–3600 (default 1800); the grant cannot be revoked and is not listed anywhere. Returns { grant, expiresAt, url }. ${URL_HANDLING} Maps to POST /v1/orgs/{org}/agents/{agent}/emulator-grants.`,
+        kind: 'destructive',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        input: {
+            agentId: agentIdField,
+            ttlSec: zod_1.z
+                .number()
+                .int()
+                .min(60)
+                .max(3600)
+                .optional()
+                .describe('Seconds until the grant expires (default 1800)'),
+        },
+        run: async ({ client }, { agentId, ttlSec }) => client.post(await client.orgPath(emulatorPath(agentId, 'emulator-grants')), ttlSec !== undefined ? { ttlSec } : {}),
+    }),
+];
+//# sourceMappingURL=emulator.js.map

package/dist/tools/emulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emulator.js","sourceRoot":"","sources":["../../src/tools/emulator.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -2,7 +2,7 @@ import { AnyTool, ToolProfile } from '../tool';
 /**
  * The tool table, in the order hosts list them. Grouped as the API reference
  * is: orient → Definition → Capabilities → Channels → People → Campaigns →
- * Tests → Testers → Activity → Org → Docs. Names must be unique (enforced by test/tools.spec.ts).
+ * Tests → Testers → Emulator → Activity → Org → Docs. Names must be unique (enforced by test/tools.spec.ts).
  */
 export declare const allTools: AnyTool[];
 export declare const toolsByName: ReadonlyMap<string, AnyTool>;

package/dist/tools/index.js

@@ -9,6 +9,7 @@ const capabilities_1 = require("./capabilities");
 const channels_1 = require("./channels");
 const definition_1 = require("./definition");
 const docs_1 = require("./docs");
+const emulator_1 = require("./emulator");
 const tests_1 = require("./tests");
 const goals_1 = require("./goals");
 const media_1 = require("./media");
@@ -19,7 +20,7 @@ const testers_1 = require("./testers");
 /**
  * The tool table, in the order hosts list them. Grouped as the API reference
  * is: orient → Definition → Capabilities → Channels → People → Campaigns →
- * Tests → Testers → Activity → Org → Docs. Names must be unique (enforced by test/tools.spec.ts).
+ * Tests → Testers → Emulator → Activity → Org → Docs. Names must be unique (enforced by test/tools.spec.ts).
  */
 exports.allTools = [
     ...me_1.meTools,
@@ -33,6 +34,7 @@ exports.allTools = [
     ...campaigns_1.campaignTools,
     ...tests_1.testTools,
     ...testers_1.testerTools,
+    ...emulator_1.emulatorTools,
     ...activity_1.activityTools,
     ...org_1.orgTools,
     ...docs_1.docsTools,

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AA8CA,0CAKC;AAlDD,yCAA2C;AAC3C,qCAAsC;AACtC,2CAA4C;AAC5C,iDAAiD;AACjD,yCAA0C;AAC1C,6CAA+C;AAC/C,iCAAmC;AACnC,mCAAoC;AACpC,mCAAoC;AACpC,mCAAqC;AACrC,6BAA+B;AAC/B,+BAAiC;AACjC,qCAAuC;AACvC,uCAAwC;AAExC;;;;GAIG;AACU,QAAA,QAAQ,GAAc;IACjC,GAAG,YAAO;IACV,GAAG,mBAAU;IACb,GAAG,4BAAe;IAClB,GAAG,iBAAS;IACZ,GAAG,kBAAU;IACb,GAAG,8BAAe;IAClB,GAAG,uBAAY;IACf,GAAG,oBAAW;IACd,GAAG,yBAAa;IAChB,GAAG,iBAAS;IACZ,GAAG,qBAAW;IACd,GAAG,wBAAa;IAChB,GAAG,cAAQ;IACX,GAAG,gBAAS;CACb,CAAC;AAEW,QAAA,WAAW,GAAiC,IAAI,GAAG,CAC9D,gBAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAC/B,CAAC;AAEF;;;GAGG;AACH,SAAgB,eAAe,CAC7B,OAAoB,EACpB,QAA4B,gBAAQ;IAEpC,OAAO,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;AACnF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAgDA,0CAKC;AApDD,yCAA2C;AAC3C,qCAAsC;AACtC,2CAA4C;AAC5C,iDAAiD;AACjD,yCAA0C;AAC1C,6CAA+C;AAC/C,iCAAmC;AACnC,yCAA2C;AAC3C,mCAAoC;AACpC,mCAAoC;AACpC,mCAAqC;AACrC,6BAA+B;AAC/B,+BAAiC;AACjC,qCAAuC;AACvC,uCAAwC;AAExC;;;;GAIG;AACU,QAAA,QAAQ,GAAc;IACjC,GAAG,YAAO;IACV,GAAG,mBAAU;IACb,GAAG,4BAAe;IAClB,GAAG,iBAAS;IACZ,GAAG,kBAAU;IACb,GAAG,8BAAe;IAClB,GAAG,uBAAY;IACf,GAAG,oBAAW;IACd,GAAG,yBAAa;IAChB,GAAG,iBAAS;IACZ,GAAG,qBAAW;IACd,GAAG,wBAAa;IAChB,GAAG,wBAAa;IAChB,GAAG,cAAQ;IACX,GAAG,gBAAS;CACb,CAAC;AAEW,QAAA,WAAW,GAAiC,IAAI,GAAG,CAC9D,gBAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAC/B,CAAC;AAEF;;;GAGG;AACH,SAAgB,eAAe,CAC7B,OAAoB,EACpB,QAA4B,gBAAQ;IAEpC,OAAO,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;AACnF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anychat-ai/mcp",
-  "version": "0.51.0",
+  "version": "0.52.0",
   "description": "Anychat MCP server — drive your Anychat workspace (agents, playbooks, channels, people, outreach) from Claude Code, Claude Desktop, Cursor, or any MCP host.",
   "keywords": [
     "anychat",