@jclvsh/iris 0.2.4 → 0.4.0

package/dist/client.js

@@ -1,3 +1,32 @@
+function safeStringify(value) {
+    if (Array.isArray(value)) {
+        const parts = value
+            .map((entry) => {
+            if (typeof entry === "string")
+                return entry;
+            if (entry && typeof entry === "object") {
+                const msg = entry.msg;
+                if (typeof msg === "string")
+                    return msg;
+            }
+            try {
+                return JSON.stringify(entry);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((p) => typeof p === "string" && p.length > 0);
+        if (parts.length > 0)
+            return parts.join("; ");
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
 export class IrisClient {
     apiKey;
     baseUrl;
@@ -77,7 +106,13 @@ export class IrisClient {
         try {
             const body = await response.json();
             if (body?.error) {
-                const parts = [body.error.message || "unknown error"];
+                const rawMessage = body.error.message;
+                const messageStr = typeof rawMessage === "string" && rawMessage.trim() !== ""
+                    ? rawMessage
+                    : rawMessage != null
+                        ? safeStringify(rawMessage)
+                        : "unknown error";
+                const parts = [messageStr];
                 if (body.error.code)
                     parts.unshift(`[${body.error.code}]`);
                 if (body.error.field)

package/dist/commands/channels.js

@@ -28,7 +28,7 @@ export function registerChannelCommands(program, client) {
     channels
         .command("send")
         .description("send a message through a specific channel in a conversation")
-        .requiredOption("--channel <channel>", "channel: email, instagram, twitter, linkedin")
+        .requiredOption("--channel <channel>", "channel: email, instagram, twitter")
         .requiredOption("--conversation-id <id>", "conversation ID")
         .requiredOption("--recipient-id <id>", "recipient (email for email channel; platform handle/ID for social)")
         .requiredOption("-c, --content <text>", "message content")

package/dist/commands/conversations.js

@@ -11,7 +11,7 @@ export function registerConversationCommands(program, client) {
         .option("-s, --page-size <n>", "items per page (max 100)", "50")
         .option("--status <status>", "filter by status")
         .option("--campaign-id <id>", "filter by campaign")
-        .option("--channel <channel>", "filter by channel: email, instagram, twitter, linkedin")
+        .option("--channel <channel>", "filter by channel: email, instagram, twitter")
         .action(async (opts) => {
         try {
             const params = {};

package/dist/commands/keys.js

@@ -29,7 +29,7 @@ export function registerKeyCommands(program, client) {
         .command("create")
         .description("create a new API key (requires admin scope)")
         .requiredOption("-n, --name <name>", "key name")
-        .option("--scopes <list>", "comma-separated scopes: campaigns:read, campaigns:write, contacts:read, contacts:write, messages:read, messages:write, conversations:read, conversations:write, discovery:write, ai:write, notifications:read, notifications:write, webhooks:read, webhooks:write", parseList)
+        .option("--scopes <list>", "comma-separated scopes: read, write, delete, generate, send, admin (defaults to all)", parseList)
         .action(async (opts) => {
         try {
             const body = { name: opts.name };

package/dist/commands/messages.js

@@ -7,7 +7,7 @@ export function registerMessageCommands(program, client) {
         .option("-p, --page <n>", "page number", "1")
         .option("-s, --page-size <n>", "items per page (max 100)", "50")
         .option("--campaign-id <id>", "filter by campaign")
-        .option("--channel <channel>", "filter by channel: email, instagram, twitter, linkedin")
+        .option("--channel <channel>", "filter by channel: email, instagram, twitter")
         .option("--status <status>", "queue status (default: pending_approval)")
         .action(async (opts) => {
         try {

package/dist/tools/ai.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export function registerAiTools(server, client) {
-    server.tool("generate_content", "generate AI content for a specific contact conversation (email draft, follow-up, reply). requires ai:write scope.", {
+    server.tool("generate_content", "generate AI content for a specific contact conversation (email draft, follow-up, reply). requires generate scope.", {
         contact_id: z.string().uuid().describe("contact ID"),
         conversation_id: z.string().uuid().describe("conversation ID"),
         generation_type: z
@@ -19,7 +19,7 @@ export function registerAiTools(server, client) {
             };
         }
     });
-    server.tool("generate_campaign_content", "generate AI content at the campaign level (email templates, subject lines). requires ai:write scope.", {
+    server.tool("generate_campaign_content", "generate AI content at the campaign level (email templates, subject lines). requires generate scope.", {
         campaign_id: z.string().uuid().describe("campaign ID"),
         content_type: z
             .enum(["email_template", "subject_lines", "campaign_brief"])
@@ -36,7 +36,7 @@ export function registerAiTools(server, client) {
             };
         }
     });
-    server.tool("analyze_response", "analyze an inbound message using AI to determine sentiment, intent, and suggested actions. requires ai:write scope.", {
+    server.tool("analyze_response", "analyze an inbound message using AI to determine sentiment, intent, and suggested actions. requires generate scope.", {
         conversation_id: z.string().uuid().describe("conversation ID"),
         message_content: z.string().min(1).max(10000).describe("message content to analyze"),
     }, async (args) => {
@@ -51,7 +51,7 @@ export function registerAiTools(server, client) {
             };
         }
     });
-    server.tool("get_ai_usage", "get AI generation usage limits and current counts for the billing period. requires ai:read scope.", {}, async () => {
+    server.tool("get_ai_usage", "get AI generation usage limits and current counts for the billing period. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/ai/usage");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -63,7 +63,7 @@ export function registerAiTools(server, client) {
             };
         }
     });
-    server.tool("get_ai_suggestions", "get AI-powered suggestions for a conversation (next steps, reply ideas). requires ai:read scope.", {
+    server.tool("get_ai_suggestions", "get AI-powered suggestions for a conversation (next steps, reply ideas). requires read scope.", {
         conversation_id: z.string().uuid().describe("conversation ID"),
     }, async ({ conversation_id }) => {
         try {

package/dist/tools/analytics.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export function registerAnalyticsTools(server, client) {
-    server.tool("get_analytics_overview", "get a high-level overview of all campaign analytics. requires analytics:read scope.", {}, async () => {
+    server.tool("get_analytics_overview", "get a high-level overview of all campaign analytics. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/analytics/overview");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -12,7 +12,7 @@ export function registerAnalyticsTools(server, client) {
             };
         }
     });
-    server.tool("get_campaign_analytics", "get detailed analytics for a specific campaign. requires analytics:read scope.", {
+    server.tool("get_campaign_analytics", "get detailed analytics for a specific campaign. requires read scope.", {
         id: z.string().uuid().describe("campaign ID"),
     }, async ({ id }) => {
         try {
@@ -26,7 +26,7 @@ export function registerAnalyticsTools(server, client) {
             };
         }
     });
-    server.tool("get_performance_metrics", "get email performance metrics over time. requires analytics:read scope.", {
+    server.tool("get_performance_metrics", "get email performance metrics over time. requires read scope.", {
         days: z
             .number()
             .int()
@@ -52,7 +52,7 @@ export function registerAnalyticsTools(server, client) {
             };
         }
     });
-    server.tool("get_response_time", "get average response time analytics. requires analytics:read scope.", {
+    server.tool("get_response_time", "get average response time analytics. requires read scope.", {
         campaign_id: z.string().uuid().optional().describe("filter by campaign ID"),
     }, async ({ campaign_id }) => {
         try {
@@ -69,7 +69,7 @@ export function registerAnalyticsTools(server, client) {
             };
         }
     });
-    server.tool("get_contact_types", "get breakdown of contacts by type/source. requires analytics:read scope.", {}, async () => {
+    server.tool("get_contact_types", "get breakdown of contacts by type/source. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/analytics/contact-types");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

package/dist/tools/billing.js

@@ -1,5 +1,5 @@
 export function registerBillingTools(server, client) {
-    server.tool("get_billing_plans", "get all available billing plans with pricing and feature limits. requires billing:read scope.", {}, async () => {
+    server.tool("get_billing_plans", "get all available billing plans with pricing and feature limits. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/billing/plans");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

package/dist/tools/campaigns.js

@@ -13,7 +13,7 @@ const TARGET_PROFILE_TYPES = [
     "other",
 ];
 export function registerCampaignTools(server, client) {
-    server.tool("list_campaigns", "list all campaigns with optional filtering by status. requires campaigns:read scope.", {
+    server.tool("list_campaigns", "list all campaigns with optional filtering by status. requires 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(CAMPAIGN_STATUSES).optional().describe("filter by campaign status"),
@@ -36,7 +36,7 @@ export function registerCampaignTools(server, client) {
             };
         }
     });
-    server.tool("create_campaign", "create a new outreach campaign. requires campaigns:write scope.", {
+    server.tool("create_campaign", "create a new outreach campaign. requires write scope.", {
         name: z.string().min(1).max(100).describe("campaign name"),
         objective_type: z.enum(OBJECTIVE_TYPES).describe("campaign objective type"),
         product_name: z.string().max(200).optional().describe("product name (for product_promotion objective)"),
@@ -54,7 +54,7 @@ export function registerCampaignTools(server, client) {
             };
         }
     });
-    server.tool("get_campaign", "get a campaign by ID with stats. requires campaigns:read scope.", {
+    server.tool("get_campaign", "get a campaign by ID with stats. requires read scope.", {
         id: z.string().uuid().describe("campaign ID"),
     }, async ({ id }) => {
         try {
@@ -68,7 +68,7 @@ export function registerCampaignTools(server, client) {
             };
         }
     });
-    server.tool("update_campaign", "update a campaign's details. requires campaigns:write scope.", {
+    server.tool("update_campaign", "update a campaign's details. requires write scope.", {
         id: z.string().uuid().describe("campaign ID"),
         name: z.string().min(1).max(100).optional().describe("new campaign name"),
         status: z.enum(CAMPAIGN_STATUSES).optional().describe("new campaign status"),
@@ -87,7 +87,7 @@ export function registerCampaignTools(server, client) {
             };
         }
     });
-    server.tool("delete_campaign", "soft-delete a campaign (sets status to deleted). requires campaigns:write scope.", {
+    server.tool("delete_campaign", "soft-delete a campaign (sets status to deleted). requires write scope.", {
         id: z.string().uuid().describe("campaign ID"),
     }, async ({ id }) => {
         try {
@@ -101,7 +101,7 @@ export function registerCampaignTools(server, client) {
             };
         }
     });
-    server.tool("list_campaign_contacts", "list contacts in a campaign with optional status filter. requires campaigns:read scope.", {
+    server.tool("list_campaign_contacts", "list contacts in a campaign with optional status filter. requires read scope.", {
         id: z.string().uuid().describe("campaign ID"),
         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)"),
@@ -128,7 +128,7 @@ export function registerCampaignTools(server, client) {
             };
         }
     });
-    server.tool("get_campaign_usage", "get usage limits and current counts for a campaign. requires campaigns:read scope.", {
+    server.tool("get_campaign_usage", "get usage limits and current counts for a campaign. requires read scope.", {
         id: z.string().uuid().describe("campaign ID"),
     }, async ({ id }) => {
         try {
@@ -142,7 +142,7 @@ export function registerCampaignTools(server, client) {
             };
         }
     });
-    server.tool("analyze_campaign", "trigger AI analysis of a campaign to generate target profiles and recommendations. requires campaigns:write scope.", {
+    server.tool("analyze_campaign", "trigger AI analysis of a campaign to generate target profiles and recommendations. requires write scope.", {
         id: z.string().uuid().describe("campaign ID"),
     }, async ({ id }) => {
         try {
@@ -156,7 +156,7 @@ export function registerCampaignTools(server, client) {
             };
         }
     });
-    server.tool("list_target_profiles", "list target profiles for a campaign. requires campaigns:read scope.", {
+    server.tool("list_target_profiles", "list target profiles for a campaign. requires read scope.", {
         id: z.string().uuid().describe("campaign ID"),
     }, async ({ id }) => {
         try {
@@ -170,7 +170,7 @@ export function registerCampaignTools(server, client) {
             };
         }
     });
-    server.tool("create_target_profile", "create a target profile for a campaign. requires campaigns:write scope.", {
+    server.tool("create_target_profile", "create a target profile for a campaign. requires write scope.", {
         id: z.string().uuid().describe("campaign ID"),
         name: z.string().min(1).max(200).describe("profile name"),
         profile_type: z.enum(TARGET_PROFILE_TYPES).describe("type of target profile"),
@@ -178,7 +178,7 @@ export function registerCampaignTools(server, client) {
         industries: z.array(z.string()).optional().describe("target industries"),
         discovery_keywords: z.array(z.string()).optional().describe("keywords for contact discovery"),
         recommended_channels: z
-            .array(z.enum(["email", "instagram", "twitter", "linkedin"]))
+            .array(z.enum(["email", "instagram", "twitter"]))
             .optional()
             .describe("recommended outreach channels"),
     }, async ({ id, ...body }) => {
@@ -193,7 +193,7 @@ export function registerCampaignTools(server, client) {
             };
         }
     });
-    server.tool("delete_target_profile", "delete a target profile from a campaign. requires campaigns:write scope.", {
+    server.tool("delete_target_profile", "delete a target profile from a campaign. requires write scope.", {
         id: z.string().uuid().describe("campaign ID"),
         profile_id: z.string().uuid().describe("target profile ID"),
     }, async ({ id, profile_id }) => {

package/dist/tools/channels.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
-const CHANNELS = ["email", "instagram", "twitter", "linkedin"];
+const CHANNELS = ["email", "instagram", "twitter"];
 export function registerChannelTools(server, client) {
-    server.tool("list_connected_accounts", "list all connected social media accounts. requires channels:read scope.", {}, async () => {
+    server.tool("list_connected_accounts", "list all connected social media accounts. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/channels/accounts");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -13,7 +13,7 @@ export function registerChannelTools(server, client) {
             };
         }
     });
-    server.tool("check_channel_availability", "check which outreach channels are available and configured. requires channels:read scope.", {}, async () => {
+    server.tool("check_channel_availability", "check which outreach channels are available and configured. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/channels/availability");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -25,7 +25,7 @@ export function registerChannelTools(server, client) {
             };
         }
     });
-    server.tool("send_channel_message", "send a message through a specific channel in a conversation. requires channels:write scope.", {
+    server.tool("send_channel_message", "send a message through a specific channel in a conversation. requires send scope.", {
         channel: z.enum(CHANNELS).describe("outreach channel to use"),
         conversation_id: z.string().uuid().describe("conversation ID"),
         recipient_id: z

package/dist/tools/contacts.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export function registerContactTools(server, client) {
-    server.tool("list_contacts", "list all contacts with optional search. requires contacts:read scope.", {
+    server.tool("list_contacts", "list all contacts with optional search. requires 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"),
@@ -23,7 +23,7 @@ export function registerContactTools(server, client) {
             };
         }
     });
-    server.tool("create_contact", "create a new contact. requires contacts:write scope.", {
+    server.tool("create_contact", "create a new contact. requires 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"),
@@ -44,7 +44,7 @@ export function registerContactTools(server, client) {
             };
         }
     });
-    server.tool("get_contact", "get a contact by ID. requires contacts:read scope.", {
+    server.tool("get_contact", "get a contact by ID. requires read scope.", {
         id: z.string().uuid().describe("contact ID"),
     }, async ({ id }) => {
         try {
@@ -58,7 +58,7 @@ export function registerContactTools(server, client) {
             };
         }
     });
-    server.tool("update_contact", "update a contact's details. requires contacts:write scope.", {
+    server.tool("update_contact", "update a contact's details. requires 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"),
@@ -80,7 +80,7 @@ export function registerContactTools(server, client) {
             };
         }
     });
-    server.tool("delete_contact", "soft-delete a contact. requires contacts:write scope.", {
+    server.tool("delete_contact", "soft-delete a contact. requires write scope.", {
         id: z.string().uuid().describe("contact ID"),
     }, async ({ id }) => {
         try {
@@ -94,7 +94,7 @@ export function registerContactTools(server, client) {
             };
         }
     });
-    server.tool("bulk_import_contacts", "import multiple contacts at once, optionally adding them to a campaign. requires contacts:write scope.", {
+    server.tool("bulk_import_contacts", "import multiple contacts at once, optionally adding them to a campaign. requires write scope.", {
         contacts: z
             .array(z.object({
             email: z.string().email().describe("contact email"),
@@ -120,7 +120,7 @@ export function registerContactTools(server, client) {
             };
         }
     });
-    server.tool("get_contact_usage", "get contact usage limits and current counts for the billing period. requires contacts:read scope.", {}, async () => {
+    server.tool("get_contact_usage", "get contact usage limits and current counts for the billing period. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/contacts/usage");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -132,7 +132,7 @@ export function registerContactTools(server, client) {
             };
         }
     });
-    server.tool("list_contact_conversations", "list all conversations for a specific contact. requires contacts:read scope.", {
+    server.tool("list_contact_conversations", "list all conversations for a specific contact. requires read scope.", {
         id: z.string().uuid().describe("contact ID"),
     }, async ({ id }) => {
         try {

package/dist/tools/conversations.js

@@ -1,7 +1,7 @@
 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.", {
+    server.tool("list_conversations", "list conversations with optional filtering. requires 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"),
@@ -27,7 +27,7 @@ export function registerConversationTools(server, client) {
             };
         }
     });
-    server.tool("get_conversation", "get a conversation by ID with contact and campaign details. requires conversations:read scope.", {
+    server.tool("get_conversation", "get a conversation by ID with contact and campaign details. requires read scope.", {
         id: z.string().uuid().describe("conversation ID"),
     }, async ({ id }) => {
         try {
@@ -41,7 +41,7 @@ export function registerConversationTools(server, client) {
             };
         }
     });
-    server.tool("get_conversation_messages", "get all messages in a conversation. requires conversations:read scope.", {
+    server.tool("get_conversation_messages", "get all messages in a conversation. requires read scope.", {
         id: z.string().uuid().describe("conversation ID"),
     }, async ({ id }) => {
         try {
@@ -55,7 +55,7 @@ export function registerConversationTools(server, client) {
             };
         }
     });
-    server.tool("mark_conversation_read", "mark a conversation as read. requires conversations:write scope.", {
+    server.tool("mark_conversation_read", "mark a conversation as read. requires write scope.", {
         id: z.string().uuid().describe("conversation ID"),
     }, async ({ id }) => {
         try {
@@ -69,7 +69,7 @@ export function registerConversationTools(server, client) {
             };
         }
     });
-    server.tool("get_engagement_metrics", "get overall engagement metrics across all conversations. requires conversations:read scope.", {}, async () => {
+    server.tool("get_engagement_metrics", "get overall engagement metrics across all conversations. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/conversations/engagement");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

package/dist/tools/discovery.js

@@ -1,11 +1,52 @@
 import { z } from "zod";
-const DISCOVERY_SOURCES = ["google_maps", "instagram", "twitter", "linkedin"];
+const DISCOVERY_SOURCES = ["google_maps", "instagram", "twitter", "tiktok", "reddit"];
+const PROFILE_TYPES = [
+    "local_business",
+    "content_creator",
+    "influencer",
+    "b2b_professional",
+    "ecommerce",
+    "saas_company",
+    "agency",
+    "freelancer",
+    "other",
+];
 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"),
+    server.tool("search_contacts", "kick off a multi-source contact discovery job (Apify-backed). returns a job_id and contacts when ready (waits up to 90s; if status=queued, poll get_discovery_job). closed source list: google_maps, instagram, twitter, tiktok, reddit. requires generate scope.", {
+        keywords: z
+            .array(z.string().min(1))
+            .min(1)
+            .describe("non-empty array of search keywords (e.g. ['boutique hotel', 'rooftop venue'])"),
+        location: z
+            .string()
+            .optional()
+            .describe("location for geo-scoped goals (local_business / venue / brick-and-mortar). omit for global goals (creators, b2b, saas)."),
+        radius_miles: z.number().positive().optional().default(25).describe("search radius in miles (default 25)"),
+        max_results: z
+            .number()
+            .int()
+            .min(10)
+            .max(500)
+            .optional()
+            .describe("max contacts to return (10-500, default 50; server clamps to plan cap)"),
+        sources: z
+            .array(z.enum(DISCOVERY_SOURCES))
+            .optional()
+            .describe("override the default per-profile_type source mix. valid: google_maps, instagram, twitter, tiktok, reddit. omit to let the orchestrator pick."),
+        profile_type: z
+            .enum(PROFILE_TYPES)
+            .optional()
+            .describe("ICP profile type — drives default source mix when sources is omitted"),
+        campaign_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe("campaign to attach discovered contacts to on finalize"),
+        enrich_emails: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("run waterfall email enrichment (BetterContact → FullEnrich → ZeroBounce). default true."),
     }, async (args) => {
         try {
             const result = await client.post("/discovery/search", args);
@@ -18,7 +59,7 @@ export function registerDiscoveryTools(server, client) {
             };
         }
     });
-    server.tool("search_campaign_contacts", "search for contacts matching a campaign's target profiles. requires discovery:write scope.", {
+    server.tool("search_campaign_contacts", "search for contacts matching a campaign's target profiles. requires generate 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) => {
@@ -33,7 +74,7 @@ export function registerDiscoveryTools(server, client) {
             };
         }
     });
-    server.tool("get_discovery_job", "get the status and results of a discovery job. requires discovery:read scope.", {
+    server.tool("get_discovery_job", "get the status, progress, and contacts of a discovery job. status values: pending, running, completed, failed. contacts populated only when status=completed. requires read scope.", {
         id: z.string().uuid().describe("discovery job ID"),
     }, async ({ id }) => {
         try {
@@ -47,7 +88,7 @@ export function registerDiscoveryTools(server, client) {
             };
         }
     });
-    server.tool("list_discovery_sources", "list available discovery data sources and their status. requires discovery:read scope.", {}, async () => {
+    server.tool("list_discovery_sources", "list available discovery data sources and their status. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/discovery/sources");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

package/dist/tools/keys.js

@@ -1,30 +1,7 @@
 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",
-];
+const SCOPES = ["read", "write", "delete", "generate", "send", "admin"];
 export function registerKeyTools(server, client) {
-    server.tool("get_current_api_key", "get details about the currently authenticated API key. requires keys:read scope.", {}, async () => {
+    server.tool("get_current_api_key", "get details about the currently authenticated API key.", {}, async () => {
         try {
             const result = await client.get("/keys/me");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -36,7 +13,7 @@ export function registerKeyTools(server, client) {
             };
         }
     });
-    server.tool("list_api_keys", "list all API keys for the account. requires keys:read scope.", {
+    server.tool("list_api_keys", "list all API keys for the account. requires admin 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 }) => {
@@ -56,12 +33,12 @@ export function registerKeyTools(server, client) {
             };
         }
     });
-    server.tool("create_api_key", "create a new API key. requires keys:write scope.", {
+    server.tool("create_api_key", "create a new API key. requires admin 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'),
+            .describe('permission scopes (any of: read, write, delete, generate, send, admin). defaults to all scopes'),
         expires_at: z.string().optional().describe("expiration date in ISO 8601 format"),
     }, async (args) => {
         try {
@@ -75,7 +52,7 @@ export function registerKeyTools(server, client) {
             };
         }
     });
-    server.tool("revoke_api_key", "revoke (delete) an API key. requires keys:write scope.", {
+    server.tool("revoke_api_key", "revoke (delete) an API key. requires admin scope.", {
         id: z.string().uuid().describe("API key ID to revoke"),
     }, async ({ id }) => {
         try {

package/dist/tools/messages.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export function registerMessageTools(server, client) {
-    server.tool("list_pending_messages", "list messages awaiting approval before sending. requires messages:read scope.", {
+    server.tool("list_pending_messages", "list messages awaiting approval before sending. requires 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"),
@@ -23,7 +23,7 @@ export function registerMessageTools(server, client) {
             };
         }
     });
-    server.tool("approve_message", "approve a pending message for sending. requires messages:write scope.", {
+    server.tool("approve_message", "approve a pending message for sending. requires send scope.", {
         id: z.string().uuid().describe("message ID"),
     }, async ({ id }) => {
         try {
@@ -37,7 +37,7 @@ export function registerMessageTools(server, client) {
             };
         }
     });
-    server.tool("reject_message", "reject a pending message with an optional reason. requires messages:write scope.", {
+    server.tool("reject_message", "reject a pending message with an optional reason. requires send scope.", {
         id: z.string().uuid().describe("message ID"),
         reason: z.string().max(500).optional().describe("reason for rejection"),
     }, async ({ id, reason }) => {
@@ -52,7 +52,7 @@ export function registerMessageTools(server, client) {
             };
         }
     });
-    server.tool("retry_message", "retry sending a failed message. requires messages:write scope.", {
+    server.tool("retry_message", "retry sending a failed message. requires send scope.", {
         id: z.string().uuid().describe("message ID"),
     }, async ({ id }) => {
         try {
@@ -66,7 +66,7 @@ export function registerMessageTools(server, client) {
             };
         }
     });
-    server.tool("submit_message_feedback", "submit feedback on an AI-generated message to improve future generations. requires messages:write scope.", {
+    server.tool("submit_message_feedback", "submit feedback on an AI-generated message to improve future generations. requires send scope.", {
         id: z.string().uuid().describe("message ID"),
         feedback: z.string().min(1).max(2000).describe("feedback text"),
     }, async ({ id, feedback }) => {
@@ -81,7 +81,7 @@ export function registerMessageTools(server, client) {
             };
         }
     });
-    server.tool("bulk_message_action", "approve or reject multiple messages at once. requires messages:write scope.", {
+    server.tool("bulk_message_action", "approve or reject multiple messages at once. requires send 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) => {

package/dist/tools/notifications.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export function registerNotificationTools(server, client) {
-    server.tool("list_notifications", "list user notifications. requires notifications:read scope.", {
+    server.tool("list_notifications", "list user notifications. requires 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 }) => {
@@ -20,7 +20,7 @@ export function registerNotificationTools(server, client) {
             };
         }
     });
-    server.tool("update_notification", "update a notification (e.g., mark as read). requires notifications:write scope.", {
+    server.tool("update_notification", "update a notification (e.g., mark as read). requires write scope.", {
         id: z.string().uuid().describe("notification ID"),
         read: z.boolean().optional().describe("mark as read or unread"),
     }, async ({ id, ...body }) => {
@@ -35,7 +35,7 @@ export function registerNotificationTools(server, client) {
             };
         }
     });
-    server.tool("delete_notification", "delete a notification. requires notifications:write scope.", {
+    server.tool("delete_notification", "delete a notification. requires write scope.", {
         id: z.string().uuid().describe("notification ID"),
     }, async ({ id }) => {
         try {
@@ -49,7 +49,7 @@ export function registerNotificationTools(server, client) {
             };
         }
     });
-    server.tool("mark_all_notifications_read", "mark all notifications as read. requires notifications:write scope.", {}, async () => {
+    server.tool("mark_all_notifications_read", "mark all notifications as read. requires write scope.", {}, async () => {
         try {
             await client.post("/notifications/read-all");
             return { content: [{ type: "text", text: "all notifications marked as read" }] };

package/dist/tools/webhooks.js

@@ -20,7 +20,7 @@ const WEBHOOK_EVENTS = [
     "discovery.failed",
 ];
 export function registerWebhookTools(server, client) {
-    server.tool("list_webhooks", "list all configured webhooks. requires webhooks:read scope.", {
+    server.tool("list_webhooks", "list all configured webhooks. requires admin 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 }) => {
@@ -40,7 +40,7 @@ export function registerWebhookTools(server, client) {
             };
         }
     });
-    server.tool("create_webhook", "create a new webhook endpoint. requires webhooks:write scope.", {
+    server.tool("create_webhook", "create a new webhook endpoint. requires admin scope.", {
         url: z
             .string()
             .url()
@@ -60,7 +60,7 @@ export function registerWebhookTools(server, client) {
             };
         }
     });
-    server.tool("get_webhook", "get a webhook by ID. requires webhooks:read scope.", {
+    server.tool("get_webhook", "get a webhook by ID. requires admin scope.", {
         id: z.string().uuid().describe("webhook ID"),
     }, async ({ id }) => {
         try {
@@ -74,7 +74,7 @@ export function registerWebhookTools(server, client) {
             };
         }
     });
-    server.tool("update_webhook", "update a webhook's configuration. requires webhooks:write scope.", {
+    server.tool("update_webhook", "update a webhook's configuration. requires admin scope.", {
         id: z.string().uuid().describe("webhook ID"),
         url: z
             .string()
@@ -96,7 +96,7 @@ export function registerWebhookTools(server, client) {
             };
         }
     });
-    server.tool("delete_webhook", "delete a webhook. requires webhooks:write scope.", {
+    server.tool("delete_webhook", "delete a webhook. requires admin scope.", {
         id: z.string().uuid().describe("webhook ID"),
     }, async ({ id }) => {
         try {
@@ -110,7 +110,7 @@ export function registerWebhookTools(server, client) {
             };
         }
     });
-    server.tool("test_webhook", "send a test event to a webhook endpoint to verify it's working. requires webhooks:write scope.", {
+    server.tool("test_webhook", "send a test event to a webhook endpoint to verify it's working. requires admin scope.", {
         id: z.string().uuid().describe("webhook ID"),
     }, async ({ id }) => {
         try {
@@ -124,7 +124,7 @@ export function registerWebhookTools(server, client) {
             };
         }
     });
-    server.tool("rotate_webhook_secret", "rotate the signing secret for a webhook. the new secret is returned in the response. requires webhooks:write scope.", {
+    server.tool("rotate_webhook_secret", "rotate the signing secret for a webhook. the new secret is returned in the response. requires admin scope.", {
         id: z.string().uuid().describe("webhook ID"),
     }, async ({ id }) => {
         try {
@@ -138,7 +138,7 @@ export function registerWebhookTools(server, client) {
             };
         }
     });
-    server.tool("list_webhook_deliveries", "list delivery history for a webhook. requires webhooks:read scope.", {
+    server.tool("list_webhook_deliveries", "list delivery history for a webhook. requires admin scope.", {
         id: z.string().uuid().describe("webhook ID"),
         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)"),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jclvsh/iris",
-	"version": "0.2.4",
+	"version": "0.4.0",
 	"description": "MCP server for the Iris API",
 	"type": "module",
 	"main": "dist/index.js",