@jclvsh/iris 0.24.0 → 0.25.0

package/README.md

@@ -77,6 +77,7 @@ iris campaigns --help
 | channels      | `ch`   | accounts, availability, send                                  | 3     |
 | credits       | `cr`   | balance, buy                                                  | 2     |
 | affiliate     | —      | (status, link, sign-ups, and commission totals)               | 1     |
+| recap         | —      | (your last 30 days of outreach as counts)                     | 1     |
 | responder     | `r`    | status, configure, activity, show, pause, resume, triggers list, triggers add, triggers update, triggers remove, triggers posts | 11 |
 
 ## MCP Server Configuration
@@ -139,7 +140,7 @@ https://api.iris-ai.dev/mcp
 - Transport: MCP streamable HTTP, `POST` only.
 - Registry: listed in the [official MCP registry](https://registry.modelcontextprotocol.io) as `io.github.JCLVSH/iris`.
 - Auth: `Authorization: Bearer is_live_...` (the same API key; its scopes apply). `initialize` and `tools/list` answer without a key, so a client can read the tool list before signing up; calling a tool needs the key.
-- Tools: a subset of this package. Credits, API key, webhook, and affiliate tools are only available through the npm package. The class of each hosted tool is listed at https://www.iris-ai.dev/docs#mcp-hosted.
+- Tools: a subset of this package. Credits, API key, webhook, affiliate, and recap tools are only available through the npm package. The class of each hosted tool is listed at https://www.iris-ai.dev/docs#mcp-hosted.
 
 ## Available Tools
 
@@ -320,6 +321,14 @@ https://api.iris-ai.dev/mcp
 
 CLI: `iris affiliate`.
 
+### Recap
+
+| Tool        | Description                                                                                                  |
+| ----------- | ------------------------------------------------------------------------------------------------------------ |
+| `get_recap` | Your last 30 days of outreach as counts: sent, conversations, replies, and messages per channel (stdio only) |
+
+CLI: `iris recap`.
+
 ### API Keys
 
 | Tool                  | Description                                       |

package/dist/cli.js

@@ -19,6 +19,7 @@ import { registerChannelCommands } from "./commands/channels.js";
 import { registerCreditCommands } from "./commands/credits.js";
 import { registerResponderCommands } from "./commands/responder.js";
 import { registerAffiliateCommands } from "./commands/affiliate.js";
+import { registerRecapCommands } from "./commands/recap.js";
 const program = new Command()
     .name("iris")
     .description("iris CLI - manage campaigns, contacts, messages, and outreach")
@@ -54,6 +55,7 @@ try {
     registerCreditCommands(program, client);
     registerResponderCommands(program, client);
     registerAffiliateCommands(program, client);
+    registerRecapCommands(program, client);
     await program.parseAsync(process.argv);
 }
 catch (error) {

package/dist/commands/recap.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { IrisClient } from "../client.js";
+export declare function registerRecapCommands(program: Command, client: IrisClient): void;

package/dist/commands/recap.js

@@ -0,0 +1,15 @@
+import { formatOutput, handleError, getFormat } from "../cli-utils.js";
+export function registerRecapCommands(program, client) {
+    program
+        .command("recap")
+        .description("your last 30 days of outreach: messages sent, conversations, replies, and messages per channel")
+        .action(async () => {
+        try {
+            const result = await client.get("/recap");
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/server.js

@@ -19,6 +19,7 @@ import { registerAutopilotTools } from "./tools/autopilot.js";
 import { registerResponderTools } from "./tools/responder.js";
 import { registerAudienceTools } from "./tools/audiences.js";
 import { registerAffiliateTools } from "./tools/affiliate.js";
+import { registerRecapTools } from "./tools/recap.js";
 export function createIrisServer({ client, version, profile }) {
     const server = new McpServer({ name: "iris", version });
     const registrar = createPolicyRegistrar(server, TOOL_POLICY, profile);
@@ -38,6 +39,7 @@ export function createIrisServer({ client, version, profile }) {
     registerUsageTools(registrar, client);
     registerAutopilotTools(registrar, client);
     registerAffiliateTools(registrar, client);
+    registerRecapTools(registrar, client);
     registerResponderTools(registrar, client);
     registerAudienceTools(registrar, client);
     return server;

package/dist/tool-policy.d.ts

@@ -1,9 +1,9 @@
 import { type PolicyTable, type ToolClass, type ToolPolicy, type ToolProfile } from "./policy.js";
 export type { ToolClass, ToolPolicy, ToolProfile };
-export declare const TOOL_CATEGORIES: readonly ["campaigns", "contacts", "conversations", "messages", "channels", "discovery", "audiences", "autopilot", "responder", "ai", "analytics", "notifications", "usage", "billing", "credits", "affiliate", "API keys", "webhooks"];
+export declare const TOOL_CATEGORIES: readonly ["campaigns", "contacts", "conversations", "messages", "channels", "discovery", "audiences", "autopilot", "responder", "ai", "analytics", "notifications", "usage", "billing", "credits", "affiliate", "recap", "API keys", "webhooks"];
 export type ToolCategory = (typeof TOOL_CATEGORIES)[number];
 export declare const TOOL_POLICY: PolicyTable<ToolCategory>;
-export declare const toolPolicy: (name: string) => ToolPolicy<"campaigns" | "contacts" | "usage" | "messages" | "conversations" | "discovery" | "ai" | "webhooks" | "notifications" | "analytics" | "billing" | "channels" | "credits" | "responder" | "affiliate" | "audiences" | "autopilot" | "API keys">;
+export declare const toolPolicy: (name: string) => ToolPolicy<"campaigns" | "contacts" | "usage" | "messages" | "conversations" | "discovery" | "ai" | "webhooks" | "notifications" | "analytics" | "billing" | "channels" | "credits" | "responder" | "affiliate" | "recap" | "audiences" | "autopilot" | "API keys">;
 export declare const isToolEnabled: (name: string, profile: ToolProfile) => boolean;
 export declare const toolAnnotations: (name: string) => {
     readOnlyHint: boolean;

package/dist/tool-policy.js

@@ -16,6 +16,7 @@ export const TOOL_CATEGORIES = [
     "billing",
     "credits",
     "affiliate",
+    "recap",
     "API keys",
     "webhooks",
 ];
@@ -129,6 +130,8 @@ export const TOOL_POLICY = {
     get_billing_plans: hosted("billing", "read"),
     // affiliate program (hosted tool set is frozen: npm package only)
     get_affiliate: localOnly("affiliate", "read"),
+    // recap (hosted tool set is frozen: npm package only)
+    get_recap: localOnly("recap", "read"),
     // credits (agent payments: never hosted)
     get_credit_balance: localOnly("credits", "read"),
     purchase_credit_pack: localOnly("credits", "sensitive"),

package/dist/tools/recap.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { IrisClient } from "../client.js";
+export declare function registerRecapTools(server: McpServer, client: IrisClient): void;

package/dist/tools/recap.js

@@ -0,0 +1,12 @@
+import { formatMcpError } from "../cli-utils.js";
+export function registerRecapTools(server, client) {
+    server.tool("get_recap", "the user's last 30 days of outreach as counts: messages sent, conversations (one contact in one campaign), how many wrote back, the reply rate as a whole percent, and messages sent per channel. the responder's automatic replies and comment-trigger DMs are left out. counts only: no names or message text. read-only; a public share link is created in the app at /recap. requires read scope.", {}, async () => {
+        try {
+            const result = await client.get("/recap");
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return formatMcpError(error);
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jclvsh/iris",
-	"version": "0.24.0",
+	"version": "0.25.0",
 	"mcpName": "io.github.JCLVSH/iris",
 	"description": "MCP server for the Iris API",
 	"repository": {