@anychat-ai/mcp 0.4.0 → 0.5.0

package/README.md

@@ -49,7 +49,7 @@ Flags: `--profile core|full` picks the tool set (default `full`, see [Profiles](
 
 ## Tools
 
-116 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 → Testers → Activity → Org → Docs). `npx -y @anychat-ai/mcp tools` prints the live table.
+122 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 → Testers → 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 116 tools.
-- **`core`** — 56 tools, the everyday set: `whoami`; agents (list / get / create / update / export / import, apply template, catalogs); the whole Definition (identity, personality, objectives, guardrails, playbooks, message templates, `lint_agent`); tool bindings (list / upsert); scheduling config; People field definitions; outreach config; product catalog (read); channels (list / get / request / bind); 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 122 tools.
+- **`core`** — 60 tools, the everyday set: `whoami`; agents (list / get / create / update / export / import, apply template, catalogs); the whole Definition (identity, personality, objectives, guardrails, playbooks, message templates, `lint_agent`); the image library (list / add / update / delete); tool bindings (list / upsert); scheduling config; People field definitions; outreach config; product catalog (read); channels (list / get / request / bind); people (list / get / update, send outreach, list segments); testers (list); 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.
 
@@ -109,6 +109,12 @@ Pick one with `--profile core` on the CLI or `createServer({ profile: 'core' })`
 | `delete_message_template`     | destructive | `agents:write`         | core    | Delete message template                             |
 | `preview_message_template`    | read        | `agents:read`          | full    | Preview message template                            |
 | `lint_agent`                  | read        | `agents:read`          | core    | Lint agent definition                               |
+| `list_images`                 | read        | `agents:read`          | core    | List images                                         |
+| `get_image`                   | read        | `agents:read`          | full    | Get image                                           |
+| `add_image`                   | write       | `agents:write`         | core    | Add image                                           |
+| `update_image`                | write       | `agents:write`         | core    | Update image                                        |
+| `describe_image`              | write       | `agents:write`         | full    | Regenerate image description                        |
+| `delete_image`                | destructive | `agents:write`         | core    | Delete image                                        |
 | `list_tool_bindings`          | read        | `agents:read`          | core    | List tool bindings                                  |
 | `get_tool_binding`            | read        | `agents:read`          | full    | Get a tool binding                                  |
 | `upsert_tool_binding`         | write       | `agents:write`         | core    | Create or replace a tool binding                    |

package/dist/tools/images.d.ts

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

package/dist/tools/images.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.imageTools = void 0;
+/**
+ * Image library — `/v1/orgs/{org}/agents/{agent}/images`.
+ *
+ * Images an agent may show in rich cards, carousels and media messages.
+ * The platform hosts them (the object is created and deleted with the
+ * entry); content references them **by id**, never by URL:
+ * `[[card | Title ~ text | media: image:<id>]]`, `[[carousel …]]` lines,
+ * `[[media: image:<id>]]` in v1 templates/playbooks, or `card.image` /
+ * `image` in Framework v2 responses. The description (generated by a
+ * vision model, editable) and the optional usage hint are what the agent
+ * chooses images by.
+ */
+const zod_1 = require("zod");
+const tool_1 = require("../tool");
+const agentId = zod_1.z.string();
+const imageId = zod_1.z
+    .string()
+    .min(1)
+    .describe('The image id (per-agent slug, e.g. "showcase-authentic-ai")');
+const imageTextFields = {
+    name: zod_1.z.string().min(1).optional().describe('Operator label'),
+    description: zod_1.z
+        .string()
+        .optional()
+        .describe('What the image shows. Omit to have a vision model write it from the pixels (recommended); supply it to skip generation.'),
+    usageHint: zod_1.z
+        .string()
+        .optional()
+        .describe('When the agent should show it, e.g. "early in the conversation, when explaining what RCS can do"'),
+};
+exports.imageTools = [
+    (0, tool_1.defineTool)({
+        name: 'list_images',
+        title: 'List images',
+        description: "List the agent's image library — hosted images the agent may show in cards, carousels and media messages, each with an id (the reference key), a description and an optional usage hint. Reference an image in a template or playbook as `media: image:<id>` (e.g. `[[card | Title ~ text | media: image:<id>]]`, one card per line inside `[[carousel … ]]`, or `[[media: image:<id>]]`). Maps to GET /v1/orgs/{org}/agents/{agent}/images.",
+        kind: 'read',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        profile: 'core',
+        input: { agentId },
+        run: async ({ client }, { agentId }) => client.get(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/images`)),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'get_image',
+        title: 'Get image',
+        description: 'Read one image-library entry ({ id, name, description, descriptionSource, usageHint?, url, contentType, bytes, width?, height? }). Maps to GET /v1/orgs/{org}/agents/{agent}/images/{imageId}.',
+        kind: 'read',
+        scope: 'agents:read',
+        roleFloor: 'viewer',
+        input: { agentId, imageId },
+        run: async ({ client }, { agentId, imageId }) => client.get(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/images/${encodeURIComponent(imageId)}`)),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'add_image',
+        title: 'Add image',
+        description: "Add an image to the agent's library from a public http(s) URL: the platform fetches it (PNG, JPEG, GIF or WebP, ≤ 5 MB), hosts its own copy, records dimensions, and — unless you pass a description — has a vision model describe it. Same bytes added twice return the existing entry. Choose the id (slug) or let it derive from the name. Maps to POST /v1/orgs/{org}/agents/{agent}/images.",
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        profile: 'core',
+        input: {
+            agentId,
+            sourceUrl: zod_1.z.string().url().describe('Public http(s) URL of the image'),
+            id: zod_1.z
+                .string()
+                .optional()
+                .describe('Preferred id (slugified; suffixed when taken). Defaults from name.'),
+            ...imageTextFields,
+        },
+        run: async ({ client }, { agentId, ...body }) => client.post(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/images`), body),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'update_image',
+        title: 'Update image',
+        description: "Edit an image's name, description or usage hint (an empty usageHint clears it). The id and the hosted file never change — to replace the picture, delete and add. Maps to PATCH /v1/orgs/{org}/agents/{agent}/images/{imageId}.",
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        profile: 'core',
+        input: { agentId, imageId, ...imageTextFields },
+        run: async ({ client }, { agentId, imageId, usageHint, ...rest }) => client.patch(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/images/${encodeURIComponent(imageId)}`), { ...rest, ...(usageHint === undefined ? {} : { usageHint: usageHint || null }) }),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'describe_image',
+        title: 'Regenerate image description',
+        description: 'Have the vision model rewrite the description from the stored pixels (replaces operator edits). Maps to POST /v1/orgs/{org}/agents/{agent}/images/{imageId}:describe.',
+        kind: 'write',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        input: { agentId, imageId },
+        run: async ({ client }, { agentId, imageId }) => client.post(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/images/${encodeURIComponent(imageId)}:describe`), {}),
+    }),
+    (0, tool_1.defineTool)({
+        name: 'delete_image',
+        title: 'Delete image',
+        description: 'Remove an image from the library AND delete its hosted file. Templates or playbooks still referencing `image:<id>` keep sending, without the picture (lint reports them as image.ref.unknown). Irreversible. Maps to DELETE /v1/orgs/{org}/agents/{agent}/images/{imageId}.',
+        kind: 'destructive',
+        scope: 'agents:write',
+        roleFloor: 'editor',
+        profile: 'core',
+        input: { agentId, imageId },
+        run: async ({ client }, { agentId, imageId }) => {
+            await client.delete(await client.orgPath(`/agents/${encodeURIComponent(agentId)}/images/${encodeURIComponent(imageId)}`));
+            return { ok: true, deleted: imageId };
+        },
+    }),
+];
+//# sourceMappingURL=images.js.map

package/dist/tools/images.js.map

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

package/dist/tools/index.js

@@ -8,6 +8,7 @@ const capabilities_1 = require("./capabilities");
 const channels_1 = require("./channels");
 const definition_1 = require("./definition");
 const docs_1 = require("./docs");
+const images_1 = require("./images");
 const me_1 = require("./me");
 const org_1 = require("./org");
 const people_1 = require("./people");
@@ -21,6 +22,7 @@ exports.allTools = [
     ...me_1.meTools,
     ...agents_1.agentTools,
     ...definition_1.definitionTools,
+    ...images_1.imageTools,
     ...capabilities_1.capabilityTools,
     ...channels_1.channelTools,
     ...people_1.peopleTools,

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAsCA,0CAKC;AA1CD,yCAA2C;AAC3C,qCAAsC;AACtC,iDAAiD;AACjD,yCAA0C;AAC1C,6CAA+C;AAC/C,iCAAmC;AACnC,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,8BAAe;IAClB,GAAG,uBAAY;IACf,GAAG,oBAAW;IACd,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":";;;AAwCA,0CAKC;AA5CD,yCAA2C;AAC3C,qCAAsC;AACtC,iDAAiD;AACjD,yCAA0C;AAC1C,6CAA+C;AAC/C,iCAAmC;AACnC,qCAAsC;AACtC,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,mBAAU;IACb,GAAG,8BAAe;IAClB,GAAG,uBAAY;IACf,GAAG,oBAAW;IACd,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anychat-ai/mcp",
-  "version": "0.4.0",
+  "version": "0.5.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",