@jclvsh/iris 0.2.0

package/dist/tools/channels.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+const CHANNELS = ["email", "instagram", "twitter", "linkedin"];
+export function registerChannelTools(server, client) {
+    server.tool("list_connected_accounts", "list all connected social media accounts. requires channels:read scope.", {}, async () => {
+        try {
+            const result = await client.get("/channels/accounts");
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("check_channel_availability", "check which outreach channels are available and configured. requires channels:read scope.", {}, async () => {
+        try {
+            const result = await client.get("/channels/availability");
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("send_channel_message", "send a message through a specific channel in a conversation. requires channels:write scope.", {
+        channel: z.enum(CHANNELS).describe("outreach channel to use"),
+        conversation_id: z.string().uuid().describe("conversation ID"),
+        recipient_id: z
+            .string()
+            .min(1)
+            .describe("recipient (email address for email channel; platform handle/ID for social channels)"),
+        content: z.string().min(1).max(10000).describe("message content"),
+        subject: z.string().optional().describe("subject (email channel only)"),
+    }, async (args) => {
+        try {
+            const result = await client.post("/channels/send", args);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/contacts.d.ts

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

package/dist/tools/contacts.js

@@ -0,0 +1,149 @@
+import { z } from "zod";
+export function registerContactTools(server, client) {
+    server.tool("list_contacts", "list all contacts with optional search. requires contacts:read scope.", {
+        page: z.number().int().positive().optional().describe("page number (default 1)"),
+        page_size: z.number().int().min(1).max(100).optional().describe("items per page (default 50, max 100)"),
+        search: z.string().optional().describe("search by name, email, or company"),
+    }, async ({ page, page_size, search }) => {
+        try {
+            const params = {};
+            if (page !== undefined)
+                params.page = String(page);
+            if (page_size !== undefined)
+                params.page_size = String(page_size);
+            if (search)
+                params.search = search;
+            const result = await client.get("/contacts", params);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("create_contact", "create a new contact. requires contacts:write scope.", {
+        email: z.string().email().describe("contact email address"),
+        first_name: z.string().max(100).optional().describe("first name"),
+        last_name: z.string().max(100).optional().describe("last name"),
+        company_name: z.string().max(200).optional().describe("company name"),
+        job_title: z.string().max(200).optional().describe("job title"),
+        phone: z.string().max(50).optional().describe("phone number"),
+        website: z.string().url().optional().describe("website URL"),
+        tags: z.array(z.string()).optional().describe("tags for categorization"),
+    }, async (args) => {
+        try {
+            const result = await client.post("/contacts", args);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get_contact", "get a contact by ID. requires contacts:read scope.", {
+        id: z.string().uuid().describe("contact ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.get(`/contacts/${id}`);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("update_contact", "update a contact's details. requires contacts:write scope.", {
+        id: z.string().uuid().describe("contact ID"),
+        email: z.string().email().optional().describe("email address"),
+        first_name: z.string().max(100).optional().describe("first name"),
+        last_name: z.string().max(100).optional().describe("last name"),
+        company_name: z.string().max(200).optional().describe("company name"),
+        job_title: z.string().max(200).optional().describe("job title"),
+        phone: z.string().max(50).optional().describe("phone number"),
+        website: z.string().url().optional().describe("website URL"),
+        tags: z.array(z.string()).optional().describe("tags for categorization"),
+    }, async ({ id, ...body }) => {
+        try {
+            const result = await client.patch(`/contacts/${id}`, body);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("delete_contact", "soft-delete a contact. requires contacts:write scope.", {
+        id: z.string().uuid().describe("contact ID"),
+    }, async ({ id }) => {
+        try {
+            await client.delete(`/contacts/${id}`);
+            return { content: [{ type: "text", text: `contact ${id} deleted` }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("bulk_import_contacts", "import multiple contacts at once, optionally adding them to a campaign. requires contacts:write scope.", {
+        contacts: z
+            .array(z.object({
+            email: z.string().email().describe("contact email"),
+            first_name: z.string().optional().describe("first name"),
+            last_name: z.string().optional().describe("last name"),
+            company_name: z.string().optional().describe("company name"),
+            job_title: z.string().optional().describe("job title"),
+            tags: z.array(z.string()).optional().describe("tags"),
+        }))
+            .min(1)
+            .max(500)
+            .describe("array of contacts to import"),
+        campaign_id: z.string().uuid().optional().describe("campaign ID to add contacts to"),
+    }, async (args) => {
+        try {
+            const result = await client.post("/contacts/bulk", args);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get_contact_usage", "get contact usage limits and current counts for the billing period. requires contacts:read scope.", {}, async () => {
+        try {
+            const result = await client.get("/contacts/usage");
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("list_contact_conversations", "list all conversations for a specific contact. requires contacts:read scope.", {
+        id: z.string().uuid().describe("contact ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.get(`/contacts/${id}/conversations`);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/conversations.d.ts

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

package/dist/tools/conversations.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+const CONVERSATION_STATUSES = ["active", "completed", "failed", "human_review"];
+export function registerConversationTools(server, client) {
+    server.tool("list_conversations", "list conversations with optional filtering. requires conversations:read scope.", {
+        page: z.number().int().positive().optional().describe("page number (default 1)"),
+        page_size: z.number().int().min(1).max(100).optional().describe("items per page (default 50, max 100)"),
+        status: z.enum(CONVERSATION_STATUSES).optional().describe("filter by conversation status"),
+        campaign_id: z.string().uuid().optional().describe("filter by campaign ID"),
+    }, async ({ page, page_size, status, campaign_id }) => {
+        try {
+            const params = {};
+            if (page !== undefined)
+                params.page = String(page);
+            if (page_size !== undefined)
+                params.page_size = String(page_size);
+            if (status)
+                params.status = status;
+            if (campaign_id)
+                params.campaign_id = campaign_id;
+            const result = await client.get("/conversations", params);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get_conversation", "get a conversation by ID with contact and campaign details. requires conversations:read scope.", {
+        id: z.string().uuid().describe("conversation ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.get(`/conversations/${id}`);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get_conversation_messages", "get all messages in a conversation. requires conversations:read scope.", {
+        id: z.string().uuid().describe("conversation ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.get(`/conversations/${id}/messages`);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("mark_conversation_read", "mark a conversation as read. requires conversations:write scope.", {
+        id: z.string().uuid().describe("conversation ID"),
+    }, async ({ id }) => {
+        try {
+            await client.post(`/conversations/${id}/read`);
+            return { content: [{ type: "text", text: `conversation ${id} marked as read` }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get_engagement_metrics", "get overall engagement metrics across all conversations. requires conversations:read scope.", {}, async () => {
+        try {
+            const result = await client.get("/conversations/engagement");
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/discovery.d.ts

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

package/dist/tools/discovery.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+const DISCOVERY_SOURCES = ["google_maps", "instagram", "twitter", "linkedin"];
+export function registerDiscoveryTools(server, client) {
+    server.tool("search_contacts", "search for new contacts using external data sources (Google Maps, social platforms). requires discovery:write scope.", {
+        query: z.string().min(1).max(500).describe("search query"),
+        source: z.enum(DISCOVERY_SOURCES).describe("data source to search"),
+        max_results: z.number().int().min(1).max(100).optional().describe("maximum number of results (default 20)"),
+        campaign_id: z.string().uuid().optional().describe("campaign to add discovered contacts to"),
+    }, async (args) => {
+        try {
+            const result = await client.post("/discovery/search", args);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("search_campaign_contacts", "search for contacts matching a campaign's target profiles. requires discovery:write scope.", {
+        campaign_id: z.string().uuid().describe("campaign ID"),
+        target_profile_id: z.string().uuid().optional().describe("specific target profile to search for"),
+    }, async (args) => {
+        try {
+            const result = await client.post("/discovery/search/campaign", args);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("get_discovery_job", "get the status and results of a discovery job. requires discovery:read scope.", {
+        id: z.string().uuid().describe("discovery job ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.get(`/discovery/jobs/${id}`);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("list_discovery_sources", "list available discovery data sources and their status. requires discovery:read scope.", {}, async () => {
+        try {
+            const result = await client.get("/discovery/sources");
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/keys.d.ts

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

package/dist/tools/keys.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+const SCOPES = [
+    "campaigns:read",
+    "campaigns:write",
+    "contacts:read",
+    "contacts:write",
+    "conversations:read",
+    "conversations:write",
+    "messages:read",
+    "messages:write",
+    "ai:read",
+    "ai:write",
+    "discovery:read",
+    "discovery:write",
+    "analytics:read",
+    "billing:read",
+    "channels:read",
+    "channels:write",
+    "notifications:read",
+    "notifications:write",
+    "webhooks:read",
+    "webhooks:write",
+    "keys:read",
+    "keys:write",
+];
+export function registerKeyTools(server, client) {
+    server.tool("get_current_api_key", "get details about the currently authenticated API key. requires keys:read scope.", {}, async () => {
+        try {
+            const result = await client.get("/keys/me");
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("list_api_keys", "list all API keys for the account. requires keys:read scope.", {
+        page: z.number().int().positive().optional().describe("page number (default 1)"),
+        page_size: z.number().int().min(1).max(100).optional().describe("items per page (default 50, max 100)"),
+    }, async ({ page, page_size }) => {
+        try {
+            const params = {};
+            if (page !== undefined)
+                params.page = String(page);
+            if (page_size !== undefined)
+                params.page_size = String(page_size);
+            const result = await client.get("/keys", params);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("create_api_key", "create a new API key. requires keys:write scope.", {
+        name: z.string().min(1).max(100).describe("key name for identification"),
+        scopes: z
+            .array(z.enum(SCOPES))
+            .optional()
+            .describe('permission scopes (e.g. ["campaigns:read", "contacts:write"]). defaults to all scopes'),
+        expires_at: z.string().optional().describe("expiration date in ISO 8601 format"),
+    }, async (args) => {
+        try {
+            const result = await client.post("/keys", args);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("revoke_api_key", "revoke (delete) an API key. requires keys:write scope.", {
+        id: z.string().uuid().describe("API key ID to revoke"),
+    }, async ({ id }) => {
+        try {
+            await client.delete(`/keys/${id}`);
+            return { content: [{ type: "text", text: `API key ${id} revoked` }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/messages.d.ts

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

package/dist/tools/messages.js

@@ -0,0 +1,99 @@
+import { z } from "zod";
+export function registerMessageTools(server, client) {
+    server.tool("list_pending_messages", "list messages awaiting approval before sending. requires messages:read scope.", {
+        page: z.number().int().positive().optional().describe("page number (default 1)"),
+        page_size: z.number().int().min(1).max(100).optional().describe("items per page (default 50, max 100)"),
+        campaign_id: z.string().uuid().optional().describe("filter by campaign ID"),
+    }, async ({ page, page_size, campaign_id }) => {
+        try {
+            const params = {};
+            if (page !== undefined)
+                params.page = String(page);
+            if (page_size !== undefined)
+                params.page_size = String(page_size);
+            if (campaign_id)
+                params.campaign_id = campaign_id;
+            const result = await client.get("/messages/pending", params);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("approve_message", "approve a pending message for sending. requires messages:write scope.", {
+        id: z.string().uuid().describe("message ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.post(`/messages/${id}/approve`);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("reject_message", "reject a pending message with an optional reason. requires messages:write scope.", {
+        id: z.string().uuid().describe("message ID"),
+        reason: z.string().max(500).optional().describe("reason for rejection"),
+    }, async ({ id, reason }) => {
+        try {
+            const result = await client.post(`/messages/${id}/reject`, reason ? { reason } : undefined);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("retry_message", "retry sending a failed message. requires messages:write scope.", {
+        id: z.string().uuid().describe("message ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.post(`/messages/${id}/retry`);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("submit_message_feedback", "submit feedback on an AI-generated message to improve future generations. requires messages:write scope.", {
+        id: z.string().uuid().describe("message ID"),
+        feedback: z.string().min(1).max(2000).describe("feedback text"),
+    }, async ({ id, feedback }) => {
+        try {
+            const result = await client.post(`/messages/${id}/feedback`, { feedback });
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("bulk_message_action", "approve or reject multiple messages at once. requires messages:write scope.", {
+        action: z.enum(["approve", "reject"]).describe("action to perform"),
+        ids: z.array(z.string().uuid()).min(1).max(100).describe("message IDs to act on"),
+    }, async (args) => {
+        try {
+            const result = await client.post("/messages/bulk", args);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/notifications.d.ts

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

package/dist/tools/notifications.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+export function registerNotificationTools(server, client) {
+    server.tool("list_notifications", "list user notifications. requires notifications:read scope.", {
+        page: z.number().int().positive().optional().describe("page number (default 1)"),
+        page_size: z.number().int().min(1).max(100).optional().describe("items per page (default 50, max 100)"),
+    }, async ({ page, page_size }) => {
+        try {
+            const params = {};
+            if (page !== undefined)
+                params.page = String(page);
+            if (page_size !== undefined)
+                params.page_size = String(page_size);
+            const result = await client.get("/notifications", params);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("update_notification", "update a notification (e.g., mark as read). requires notifications:write scope.", {
+        id: z.string().uuid().describe("notification ID"),
+        read: z.boolean().optional().describe("mark as read or unread"),
+    }, async ({ id, ...body }) => {
+        try {
+            const result = await client.patch(`/notifications/${id}`, body);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("delete_notification", "delete a notification. requires notifications:write scope.", {
+        id: z.string().uuid().describe("notification ID"),
+    }, async ({ id }) => {
+        try {
+            await client.delete(`/notifications/${id}`);
+            return { content: [{ type: "text", text: `notification ${id} deleted` }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("mark_all_notifications_read", "mark all notifications as read. requires notifications:write scope.", {}, async () => {
+        try {
+            await client.post("/notifications/read-all");
+            return { content: [{ type: "text", text: "all notifications marked as read" }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}

package/dist/tools/webhooks.d.ts

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