@agifyai/leadify-mcp 9.5.0 → 9.7.0

package/README.md

@@ -195,8 +195,12 @@ Conséquences pratiques :
 
 ## Sémantique des événements
 
-Une participation est rattachée à l’entreprise canonique (`Account`), même
-lorsqu’un `lead_id` est fourni au tool. `get_leads.event_filter` et
+Une participation porte sur une entreprise ou sur une personne (PRD-2475,
+serveur PRD-2473). Un `account_id` ou le `lead_id` d’un prospect Entreprise
+écrit, comme avant, sur l’entreprise canonique (`Account`). Le `lead_id` d’un
+prospect Personne, ou un `person_id` (`canonicalIdentity.id` d’un prospect Personne, `kind: PERSON`), écrit une
+participation propre à la personne canonique : elle la suit dans tous ses
+groupes. Les outils d’events d’entreprise fonctionnent comme avant. `get_leads.event_filter` et
 `list_event_participations` ajoutent explicitement `VERIFIED` lorsque le statut
 n’est pas fourni. Pour relire des faits `UNVERIFIED`, `DISPUTED` ou `REFUTED`,
 l’agent doit demander ces statuts explicitement. Une donnée incertaine ou
@@ -211,6 +215,31 @@ des sélecteurs courants sans effacer son historique. Les champs legacy
 restent disponibles pour compatibilité/export, mais ne sont jamais synchronisés
 depuis ce modèle.
 
+Événements d’une personne :
+
+- Rôles d’une personne : `REGISTERED` (inscrit), `ATTENDED` (présent),
+  `INVITED` (invité), `SPEAKER`, `ORGANIZER`, `OTHER`. Les trois premiers sont
+  refusés pour une entreprise. Inscrit, présent et invité sont trois faits
+  distincts : une inscription ne prouve jamais une présence.
+- Une liste d’inscrits fournie par le client est une preuve valable de
+  l’inscription, y compris pour une personne désinscrite ensuite ou inscrite
+  plusieurs fois : rôle `REGISTERED` et `client_document { file_name,
+  received_on, provided_by }`, sans adresse web. `VERIFIED` exige une adresse
+  web ou un `client_document`.
+- Un event de l’employeur n’est jamais une participation de la personne. Lue
+  avec le `lead_id` d’une personne, `list_event_participations` rend ses
+  participations propres (`origin: PERSON`) puis celles de son employeur
+  (`origin: EMPLOYER`). Sans `target`, `person_ids` ni `lead_id` de personne,
+  la liste ne rend que les entreprises, comme avant ; `target: PERSON` ou
+  `person_ids` lisent les personnes.
+- `get_leads.event_filter.subject` vaut `EMPLOYER` (défaut, comportement
+  historique) ou `PERSON` (seules les personnes qui portent elles-mêmes la
+  participation, par exemple les inscrits d’un webinar).
+- Les events ont un type facultatif `event_type` : `WEBINAR`, `CONGRESS`,
+  `TRADE_SHOW`, `OTHER` (filtre `event_types` dans `list_events`).
+  `get_event` rend `participationCounts { companies, persons }`.
+- L’absence d’enregistrement ne prouve rien.
+
 Il n’existe plus de score de confiance événementiel : le statut et ses preuves
 portent seuls la validation utile. `Event.description` explique l’audience et
 l’utilité de l’événement ; `activity_summary` explique ce que l’entreprise y
@@ -228,8 +257,11 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | Tool | Description |
 |------|-------------|
 | `test_api_key` | Vérifier que la clé API configurée est valide (health check). |
-| `list_lead_groups` | Lister les groupes accessibles d'une organisation explicitement sélectionnée, en vue compacte. |
-| `get_lead_group` | Consulter les métadonnées compactes d'un groupe accessible par son ID. |
+| `list_lead_groups` | Lister les groupes accessibles d'une organisation explicitement sélectionnée, en vue compacte, avec le sous-menu de chacun (`folderId`, `folder`). `folder_id` garde exactement les groupes d'un sous-menu, `none` ceux qui n'en ont aucun. |
+| `get_lead_group` | Consulter les métadonnées compactes d'un groupe accessible par son ID, avec son sous-menu. |
+| `list_lead_group_folders` | Lister les sous-menus partagés de la barre latérale d'une organisation (nom, emoji, description, groupes). Toute l'équipe voit les mêmes. |
+| `create_lead_group_folder` / `update_lead_group_folder` / `delete_lead_group_folder` | Créer, renommer, changer l'emoji (caractère ou code) ou la description, ajouter ou retirer des groupes, supprimer un sous-menu. La suppression garde les groupes. Droit d'écriture requis. |
+| `move_lead_groups_to_folder` | Ranger des groupes dans un sous-menu, ou les en sortir avec `folder_id: null` ; tous bougent ou aucun. Un groupe est dans un seul sous-menu. |
 | `create_lead_group` | Créer un groupe, choisir son type canonique optionnel et rattacher atomiquement `persona_id` avec l’`offer_id` ACTIVE du même tenant. |
 | `update_lead_group` | Modifier un groupe avec réconciliation du schéma ; lorsque le serveur exige un contexte complet, transmettre ensemble `persona_id` et `offer_id` sans inférer l’offre. |
 | `add_leads` | Import plat générique vers un groupe : ne crée aucune relation d’emploi, aucun rattachement parent ni identité canonique. Ne jamais l’utiliser pour rattacher une Personne à une Company (voir `upsert_person_leads_with_employment`). |
@@ -241,17 +273,17 @@ Leadify et ne doit jamais être envoyée par un agent MCP.
 | `preview_move_leads` | Essai à blanc du déplacement de fiches vers un autre groupe de la même organisation : sélection par identifiants, vue ou filtre (500 fiches au plus par appel, lots ensuite), refus par fiche avec motif, doublons dans le groupe cible, champs de schéma et relations à ajouter, blocages et empreinte du plan. |
 | `move_leads` | Appliquer un déplacement prévisualisé ; exige l'empreinte de la prévisualisation et une clé d'idempotence. La fiche garde son identifiant et tout son historique ; jamais de fusion. |
 | `undo_move_leads` / `get_lead_move` | Annuler ou relire une opération de déplacement par son identifiant. |
-| `get_leads` | Rechercher et lister des leads avec filtres, recherche et pagination, dont le critère composé `event_filter`. |
+| `get_leads` | Rechercher et lister des leads avec filtres, recherche et pagination, dont le critère composé `event_filter` (`subject` : employeur ou personne). |
 | `get_lead` | Récupérer les détails complets d'un lead par son ID. |
 | `update_lead` | Mettre à jour un ou plusieurs champs d'un lead existant. |
 | `clear_lead_field` | Effacer irréversiblement une valeur stockée, sans modifier le schéma du groupe. Exige la confirmation explicite `clear_lead_field`. |
-| `list_events` | Lister les événements tenant-scoped ; les événements archivés sont masqués par défaut. |
-| `get_event` | Lire un événement partagé et son état d’archivage. |
-| `create_event` | Créer un événement partagé avec une clé d’idempotence. |
-| `update_event` | Modifier ou archiver sans suppression un événement partagé, avec version attendue. |
-| `list_event_participations` | Lister les participations d’entreprise ; filtre explicitement `VERIFIED` par défaut. |
-| `get_event_participation` | Lire un snapshot courant et son historique ; `VERIFIED` par défaut, statut incertain à demander explicitement. |
-| `record_event_participations` | Valider à blanc ou enregistrer un lot idempotent de 1 à 100 observations/corrections. |
+| `list_events` | Lister les événements tenant-scoped, filtrables par type (`event_types`) ; les événements archivés sont masqués par défaut. |
+| `get_event` | Lire un événement partagé, son type, son état d’archivage et ses nombres d’entreprises et de personnes rattachées. |
+| `create_event` | Créer un événement partagé, avec son type facultatif, et une clé d’idempotence. |
+| `update_event` | Modifier (dont le type) ou archiver sans suppression un événement partagé, avec version attendue. |
+| `list_event_participations` | Lister les participations d’entreprise et de personne, avec leur provenance ; filtres `target`, `person_ids` ; `VERIFIED` par défaut. |
+| `get_event_participation` | Lire un snapshot courant d’entreprise ou de personne et son historique ; `VERIFIED` par défaut, statut incertain à demander explicitement. |
+| `record_event_participations` | Valider à blanc ou enregistrer un lot idempotent de 1 à 100 observations/corrections d’entreprise ou de personne (inscrit, présent, invité, preuve « document du client »). |
 | `preview_reset_sequence_messages` / `execute_reset_sequence_messages` | Prévisualiser puis effacer irréversiblement les messages générés d'un prospect, d'une liste explicite ou d'un groupe explicite. L'exécution exige le digest de preview et une clé d'idempotence. |
 | `preview_reset_ai_fields` / `execute_reset_ai_fields` | Prévisualiser puis effacer irréversiblement les champs IA d'un prospect, d'une liste explicite ou d'un groupe explicite, sans toucher aux contacts, flags manuels, activités ou campagnes. |
 | `delete_leads` | Supprimer définitivement des leads par leurs IDs. |

package/dist/server.js

@@ -12,6 +12,7 @@ import { registerActivityTools } from "./tools/activities.js";
 import { registerDataSourceTools } from "./tools/datasources.js";
 import { registerPersonaTools } from "./tools/personas.js";
 import { registerLeadGroupTools } from "./tools/lead_groups.js";
+import { registerLeadGroupFolderTools } from "./tools/lead_group_folders.js";
 import { registerOrganizationTools } from "./tools/organizations.js";
 import { registerPipelineTools } from "./tools/pipeline.js";
 import { registerContextWorkspaceTools } from "./tools/context_workspace.js";
@@ -34,6 +35,7 @@ export function createServer() {
     registerAuthTools(server);
     registerOrganizationTools(server);
     registerLeadGroupTools(server);
+    registerLeadGroupFolderTools(server);
     registerLeadViewTools(server);
     registerLeadTools(server);
     registerLeadMoveTools(server);

package/dist/tools/events.d.ts

@@ -1,2 +1,8 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+export declare const COMPANY_EVENT_ROLES: readonly ["EXHIBITOR", "SPONSOR", "SPEAKER", "PARTNER", "ORGANIZER", "CONTRIBUTOR", "PARTICIPANT", "UNKNOWN", "OTHER"];
+export declare const PERSON_ONLY_EVENT_ROLES: readonly ["REGISTERED", "ATTENDED", "INVITED"];
+export declare const PERSON_EVENT_ROLES: readonly ["REGISTERED", "ATTENDED", "INVITED", "SPEAKER", "ORGANIZER", "OTHER"];
+export declare const eventRole: z.ZodEnum<["EXHIBITOR", "SPONSOR", "SPEAKER", "PARTNER", "ORGANIZER", "CONTRIBUTOR", "PARTICIPANT", "UNKNOWN", "OTHER", "REGISTERED", "ATTENDED", "INVITED"]>;
+export declare const eventType: z.ZodEnum<["WEBINAR", "CONGRESS", "TRADE_SHOW", "OTHER"]>;
 export declare function registerEventTools(server: McpServer, client?: import("../client.js").LeadifyClient): void;

package/dist/tools/events.js

@@ -7,7 +7,10 @@ const dateOnly = z.string()
     const parsed = new Date(`${value}T00:00:00.000Z`);
     return !Number.isNaN(parsed.getTime()) && parsed.toISOString().slice(0, 10) === value;
 }, "Use a real calendar date in YYYY-MM-DD format.");
-const role = z.enum([
+// Company roles are the nine historical ones. REGISTERED, ATTENDED and
+// INVITED are three distinct facts about a person (PRD-2473 contract):
+// a registration never proves attendance, an invitation proves neither.
+export const COMPANY_EVENT_ROLES = [
     "EXHIBITOR",
     "SPONSOR",
     "SPEAKER",
@@ -17,7 +20,13 @@ const role = z.enum([
     "PARTICIPANT",
     "UNKNOWN",
     "OTHER",
-]);
+];
+export const PERSON_ONLY_EVENT_ROLES = ["REGISTERED", "ATTENDED", "INVITED"];
+export const PERSON_EVENT_ROLES = ["REGISTERED", "ATTENDED", "INVITED", "SPEAKER", "ORGANIZER", "OTHER"];
+export const eventRole = z.enum([...COMPANY_EVENT_ROLES, ...PERSON_ONLY_EVENT_ROLES]);
+const role = eventRole;
+export const eventType = z.enum(["WEBINAR", "CONGRESS", "TRADE_SHOW", "OTHER"]);
+const target = z.enum(["COMPANY", "PERSON"]);
 const status = z.enum(["UNVERIFIED", "VERIFIED", "DISPUTED", "REFUTED"]);
 const nullableLabel = z.string().trim().min(1).max(500).nullable().optional();
 const nullableNarrative = z.string().trim().min(1).max(5_000).nullable().optional();
@@ -35,10 +44,12 @@ const eventFields = {
     official_url: nullableUrl,
     last_verified_on: dateOnly.nullable().optional(),
 };
+const eventTypeDescription = "Event type: WEBINAR, CONGRESS, TRADE_SHOW or OTHER. Omitted means not specified.";
 const createEventShape = {
     organization_id: z.string().trim().min(1),
     slug: z.string().trim().min(1).max(160).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/),
     ...eventFields,
+    event_type: eventType.optional().describe(eventTypeDescription),
     idempotency_key: idempotencyKey,
 };
 const createEventInput = z.object(createEventShape).strict().superRefine((value, context) => {
@@ -59,12 +70,13 @@ const updateEventShape = {
     venue: eventFields.venue,
     official_url: eventFields.official_url,
     last_verified_on: eventFields.last_verified_on,
+    event_type: eventType.nullable().optional().describe("New event type (WEBINAR, CONGRESS, TRADE_SHOW, OTHER), or null to mark it as not specified."),
     archive: z.boolean().optional().default(false),
     expected_version: z.number().int().positive(),
     idempotency_key: idempotencyKey,
 };
 const updateEventInput = z.object(updateEventShape).strict().superRefine((value, context) => {
-    const mutable = ["name", "edition", "description", "starts_on", "ends_on", "city", "country_code", "venue", "official_url", "last_verified_on"];
+    const mutable = ["name", "edition", "description", "starts_on", "ends_on", "city", "country_code", "venue", "official_url", "last_verified_on", "event_type"];
     const supplied = mutable.filter((key) => value[key] !== undefined);
     if (value.archive && supplied.length > 0) {
         context.addIssue({ code: z.ZodIssueCode.custom, path: ["archive"], message: "Archive and field updates must be separate idempotent operations." });
@@ -76,16 +88,23 @@ const updateEventInput = z.object(updateEventShape).strict().superRefine((value,
         context.addIssue({ code: z.ZodIssueCode.custom, path: ["ends_on"], message: "ends_on must be on or after starts_on." });
     }
 });
+const clientDocument = z.object({
+    file_name: z.string().trim().min(1).max(300).describe("Name of the file the client sent, e.g. the registrants spreadsheet."),
+    received_on: dateOnly.describe("Date the file was received, YYYY-MM-DD."),
+    provided_by: z.string().trim().min(1).max(300).describe("Who provided the file (client organization or contact)."),
+}).strict().describe("Proof by a document provided by the client, without a web address. A client's registrants list is valid proof of registration (role REGISTERED), including for a person who later unsubscribed or registered several times. It is not proof of attendance.");
 const participationItem = z.object({
     event_id: z.string().trim().min(1),
-    account_id: z.string().trim().min(1).optional(),
-    lead_id: z.string().trim().min(1).optional(),
-    roles: z.array(role).min(1).max(20),
+    account_id: z.string().trim().min(1).optional().describe("Company target: canonical account id."),
+    lead_id: z.string().trim().min(1).optional().describe("Company lead (writes on its account) or Person lead (writes a personal participation on its canonical person)."),
+    person_id: z.string().trim().min(1).optional().describe("Person target: canonical person id: canonicalIdentity.id of a Person lead (canonicalIdentity.kind PERSON), as returned by get_lead."),
+    roles: z.array(role).min(1).max(20).describe("Company roles: EXHIBITOR, SPONSOR, SPEAKER, PARTNER, ORGANIZER, CONTRIBUTOR, PARTICIPANT, UNKNOWN, OTHER. Person roles: REGISTERED, ATTENDED, INVITED, SPEAKER, ORGANIZER, OTHER. REGISTERED, ATTENDED and INVITED are reserved to persons and are three distinct facts."),
     role_details: z.array(z.string().trim().min(1).max(500)).max(50).optional().default([]),
     stands: z.array(z.string().trim().min(1).max(200)).max(50).optional().default([]),
     source_urls: z.array(z.string().trim().url().max(2048)).max(50).optional().default([]),
+    client_document: clientDocument.optional(),
     source_provider: nullableLabel,
-    activity_summary: nullableNarrative.describe("Readable summary of what the company does, presents or targets at this event."),
+    activity_summary: nullableNarrative.describe("Readable summary of what the company or person does, presents or targets at this event."),
     proof_excerpt: z.string().trim().min(1).max(20_000),
     observed_on: dateOnly,
     verified_on: dateOnly.nullable().optional(),
@@ -93,11 +112,24 @@ const participationItem = z.object({
     correction_reason: z.string().trim().min(1).max(5_000).optional(),
     idempotency_key: idempotencyKey,
 }).strict().superRefine((value, context) => {
-    if (Number(Boolean(value.account_id)) + Number(Boolean(value.lead_id)) !== 1) {
-        context.addIssue({ code: z.ZodIssueCode.custom, message: "Provide exactly one account_id or lead_id." });
+    const targets = [value.account_id, value.lead_id, value.person_id].filter(Boolean).length;
+    if (targets !== 1) {
+        context.addIssue({ code: z.ZodIssueCode.custom, message: "Provide exactly one account_id, lead_id or person_id." });
     }
-    if (value.status === "VERIFIED" && value.source_urls.length === 0) {
-        context.addIssue({ code: z.ZodIssueCode.custom, path: ["source_urls"], message: "VERIFIED requires at least one source URL." });
+    if (value.account_id) {
+        const refused = value.roles.filter((item) => PERSON_ONLY_EVENT_ROLES.includes(item));
+        if (refused.length) {
+            context.addIssue({ code: z.ZodIssueCode.custom, path: ["roles"], message: `Roles reserved to a person cannot be recorded on a company: ${refused.join(", ")}.` });
+        }
+    }
+    if (value.person_id) {
+        const refused = value.roles.filter((item) => !PERSON_EVENT_ROLES.includes(item));
+        if (refused.length) {
+            context.addIssue({ code: z.ZodIssueCode.custom, path: ["roles"], message: `Roles not accepted for a person: ${refused.join(", ")}. Use REGISTERED, ATTENDED, INVITED, SPEAKER, ORGANIZER or OTHER.` });
+        }
+    }
+    if (value.status === "VERIFIED" && value.source_urls.length === 0 && !value.client_document) {
+        context.addIssue({ code: z.ZodIssueCode.custom, path: ["source_urls"], message: "VERIFIED requires at least one source URL or a client_document." });
     }
     if (value.status === "VERIFIED" && !value.verified_on) {
         context.addIssue({ code: z.ZodIssueCode.custom, path: ["verified_on"], message: "VERIFIED requires verified_on." });
@@ -118,10 +150,18 @@ function participationPayload(item) {
         eventId: item.event_id,
         accountId: item.account_id,
         leadId: item.lead_id,
+        personId: item.person_id,
         roles: item.roles,
         roleDetails: item.role_details,
         stands: item.stands,
         sourceUrls: item.source_urls,
+        clientDocument: item.client_document
+            ? {
+                fileName: item.client_document.file_name,
+                receivedOn: item.client_document.received_on,
+                providedBy: item.client_document.provided_by,
+            }
+            : undefined,
         sourceProvider: item.source_provider,
         activitySummary: item.activity_summary,
         proofExcerpt: item.proof_excerpt,
@@ -160,16 +200,17 @@ function filterFactHistory(data, acceptedStatuses) {
     return source;
 }
 export function registerEventTools(server, client = getClient()) {
-    server.tool("list_events", "List tenant-scoped events. Archived events are hidden unless include_archived=true. An event alone is not evidence that a company attended; cite participation only from a matching VERIFIED participation.", {
+    server.tool("list_events", "List tenant-scoped events. Archived events are hidden unless include_archived=true. Filter by event_types (WEBINAR, CONGRESS, TRADE_SHOW, OTHER). An event alone is not evidence that a company or a person took part; cite participation only from a matching VERIFIED participation.", {
         organization_id: z.string().trim().min(1),
         include_archived: z.boolean().optional().default(false),
         search: z.string().trim().min(1).max(200).optional(),
         editions: z.array(z.string().trim().min(1).max(200)).max(100).optional(),
+        event_types: z.array(eventType).min(1).max(4).optional(),
         starts_on_from: dateOnly.optional(),
         starts_on_to: dateOnly.optional(),
         limit: z.number().int().min(1).max(100).optional().default(50),
         cursor: z.string().trim().min(1).optional(),
-    }, async ({ organization_id, include_archived, search, editions, starts_on_from, starts_on_to, limit, cursor }) => {
+    }, async ({ organization_id, include_archived, search, editions, event_types, starts_on_from, starts_on_to, limit, cursor }) => {
         try {
             const params = new URLSearchParams({
                 organizationId: organization_id,
@@ -179,6 +220,7 @@ export function registerEventTools(server, client = getClient()) {
             if (search)
                 params.set("search", search);
             setCsv(params, "editions", editions);
+            setCsv(params, "eventTypes", event_types);
             if (starts_on_from)
                 params.set("startsOnFrom", starts_on_from);
             if (starts_on_to)
@@ -191,7 +233,7 @@ export function registerEventTools(server, client = getClient()) {
             return handleToolError(error);
         }
     });
-    server.tool("get_event", "Get one tenant-scoped event, including its archive state and current participation count. This does not establish that any particular company attended.", {
+    server.tool("get_event", "Get one tenant-scoped event, including its type, archive state and participationCounts { companies, persons }: the number of companies and of persons that carry a participation themselves. A count does not establish that any particular company or person attended, and a person is never counted through their employer.", {
         organization_id: z.string().trim().min(1),
         event_id: z.string().trim().min(1),
     }, async ({ organization_id, event_id }) => {
@@ -202,7 +244,7 @@ export function registerEventTools(server, client = getClient()) {
             return handleToolError(error);
         }
     });
-    server.tool("create_event", "Create one reusable tenant-scoped event. The idempotency key makes an identical retry safe; changing the payload under the same key is rejected. Creating an event does not create company participation evidence.", createEventShape, async (params) => {
+    server.tool("create_event", "Create one reusable tenant-scoped event, optionally typed with event_type (WEBINAR, CONGRESS, TRADE_SHOW, OTHER). The idempotency key makes an identical retry safe; changing the payload under the same key is rejected. Creating an event does not create any company or person participation evidence.", createEventShape, async (params) => {
         try {
             const input = createEventInput.parse(params);
             return toolResult(await client.post("/api/events", compact({
@@ -218,6 +260,7 @@ export function registerEventTools(server, client = getClient()) {
                 venue: input.venue,
                 officialUrl: input.official_url,
                 lastVerifiedOn: input.last_verified_on,
+                eventType: input.event_type,
                 idempotencyKey: input.idempotency_key,
             })));
         }
@@ -225,7 +268,7 @@ export function registerEventTools(server, client = getClient()) {
             return handleToolError(error);
         }
     });
-    server.tool("update_event", "Update or archive one shared event with optimistic versioning and idempotency. Set archive=true as a separate operation with no field changes. This affects every company view that references the event; archiving is non-destructive and keeps all participation evidence.", updateEventShape, async (params) => {
+    server.tool("update_event", "Update or archive one shared event with optimistic versioning and idempotency, including its event_type (WEBINAR, CONGRESS, TRADE_SHOW, OTHER, or null for not specified). Set archive=true as a separate operation with no field changes. This affects every company and person view that references the event; archiving is non-destructive and keeps all participation evidence.", updateEventShape, async (params) => {
         try {
             const input = updateEventInput.parse(params);
             const body = input.archive
@@ -247,6 +290,7 @@ export function registerEventTools(server, client = getClient()) {
                     venue: input.venue,
                     officialUrl: input.official_url,
                     lastVerifiedOn: input.last_verified_on,
+                    eventType: input.event_type,
                     expectedVersion: input.expected_version,
                     idempotencyKey: input.idempotency_key,
                 });
@@ -256,11 +300,13 @@ export function registerEventTools(server, client = getClient()) {
             return handleToolError(error);
         }
     });
-    server.tool("list_event_participations", "List current company-event participation snapshots in one tenant. Defaults explicitly to VERIFIED only. To review uncertain evidence or uncertain historical facts, pass statuses containing UNVERIFIED, DISPUTED or REFUTED; unrequested fact statuses are hidden and counted. Never cite uncertain data, or the absence of a record, as proof of attendance or non-attendance.", {
+    server.tool("list_event_participations", "List current event participation snapshots of companies and persons in one tenant. Without target, person_ids or a Person lead_id, only company participations are returned (historical behavior); pass target=PERSON, person_ids or the lead_id of a Person lead to read persons. Each item carries target (COMPANY or PERSON), accountId, personId, clientDocument and, for a person, personLeads. With the lead_id of a Person lead, the result holds the person's own participations (origin PERSON) and those of their employer (origin EMPLOYER): an employer's event is never a participation of the person. REGISTERED (registered), ATTENDED (attended) and INVITED (invited) are distinct facts: a registration never proves attendance. Defaults explicitly to VERIFIED only. To review uncertain evidence or uncertain historical facts, pass statuses containing UNVERIFIED, DISPUTED or REFUTED; unrequested fact statuses are hidden and counted. Never cite uncertain data, or the absence of a record, as proof of attendance or non-attendance.", {
         organization_id: z.string().trim().min(1),
         event_ids: z.array(z.string().trim().min(1)).max(100).optional(),
         account_ids: z.array(z.string().trim().min(1)).max(100).optional(),
-        lead_id: z.string().trim().min(1).optional(),
+        person_ids: z.array(z.string().trim().min(1)).max(100).optional().describe("Canonical person ids: canonicalIdentity.id of Person leads (kind PERSON)."),
+        target: target.optional().describe("COMPANY or PERSON. Omitted: companies only, unless person_ids or a Person lead_id is given."),
+        lead_id: z.string().trim().min(1).optional().describe("Company lead: its account's participations. Person lead: its own participations (origin PERSON) and its employer's (origin EMPLOYER)."),
         editions: z.array(z.string().trim().min(1).max(200)).max(100).optional(),
         roles: z.array(role).max(20).optional(),
         statuses: z.array(status).min(1).max(10).optional().default(["VERIFIED"]),
@@ -268,8 +314,8 @@ export function registerEventTools(server, client = getClient()) {
         starts_on_to: dateOnly.optional(),
         include_facts: z.boolean().optional().default(false),
         limit: z.number().int().min(1).max(100).optional().default(50),
-        cursor: z.string().trim().min(1).optional(),
-    }, async ({ organization_id, event_ids, account_ids, lead_id, editions, roles, statuses, starts_on_from, starts_on_to, include_facts, limit, cursor }) => {
+        cursor: z.string().trim().min(1).optional().describe("Opaque cursor returned by the previous page; pass it back unchanged."),
+    }, async ({ organization_id, event_ids, account_ids, person_ids, target, lead_id, editions, roles, statuses, starts_on_from, starts_on_to, include_facts, limit, cursor }) => {
         try {
             const params = new URLSearchParams({
                 organizationId: organization_id,
@@ -279,6 +325,9 @@ export function registerEventTools(server, client = getClient()) {
             });
             setCsv(params, "eventIds", event_ids);
             setCsv(params, "accountIds", account_ids);
+            setCsv(params, "personIds", person_ids);
+            if (target)
+                params.set("target", target);
             if (lead_id)
                 params.set("leadId", lead_id);
             setCsv(params, "editions", editions);
@@ -296,7 +345,7 @@ export function registerEventTools(server, client = getClient()) {
             return handleToolError(error);
         }
     });
-    server.tool("get_event_participation", "Get one explicitly selected current participation and its immutable fact history. Access defaults to VERIFIED only; pass statuses explicitly to review UNVERIFIED, DISPUTED or REFUTED facts. Uncertain evidence is not verified attendance, and missing data never means non-participation.", {
+    server.tool("get_event_participation", "Get one explicitly selected current participation of a company or a person and its immutable fact history, with target, accountId, personId, clientDocument and, for a person, personLeads. Access defaults to VERIFIED only; pass statuses explicitly to review UNVERIFIED, DISPUTED or REFUTED facts. REGISTERED is not ATTENDED. Uncertain evidence is not verified attendance, and missing data never means non-participation.", {
         organization_id: z.string().trim().min(1),
         participation_id: z.string().trim().min(1),
         statuses: z.array(status).min(1).max(10).optional().default(["VERIFIED"]),
@@ -320,7 +369,7 @@ export function registerEventTools(server, client = getClient()) {
             return handleToolError(error);
         }
     });
-    server.tool("record_event_participations", "Create participation evidence, add a corroborating source, or correct 1-100 company-event observations. Set validate_only=true for a no-write dry-run. activity_summary is the readable account of what the company does at the event; proof_excerpt remains the exact agent/audit evidence. Each item targets exactly one account_id or resolvable lead_id and has its own idempotency key. Corrections append an immutable fact and require correction_reason; there is no delete operation. VERIFIED requires a source URL, proof excerpt and verification date. Uncertain or absent data cannot be cited as attendance.", {
+    server.tool("record_event_participations", "Create participation evidence, add a corroborating source, or correct 1-100 event observations of companies or persons. Set validate_only=true for a no-write dry-run. Each item targets exactly one account_id, lead_id or person_id and has its own idempotency key. A Company lead or account_id writes a company participation, exactly as before. The lead_id of a Person lead, or a person_id, writes a personal participation on the canonical person: it follows that person across every group. Person roles: REGISTERED, ATTENDED, INVITED, SPEAKER, ORGANIZER, OTHER; REGISTERED, ATTENDED and INVITED are refused for a company. Registered, attended and invited are three distinct facts: a registration never proves attendance. A registrants list provided by the client is valid proof of registration: record role REGISTERED with client_document { file_name, received_on, provided_by } and no URL, including for a person who later unsubscribed or registered several times. An employer's event is never a participation of the person: never record a person from their company's participation. activity_summary is the readable account of what the company or person does at the event; proof_excerpt remains the exact agent/audit evidence. Corrections append an immutable fact and require correction_reason; there is no delete operation. VERIFIED requires a source URL or a client_document, a proof excerpt and a verification date. Uncertain or absent data cannot be cited as attendance, and the absence of a record proves nothing.", {
         organization_id: z.string().trim().min(1),
         batch_id: z.string().trim().min(1).max(255),
         validate_only: z.boolean().optional().default(false),

package/dist/tools/lead_group_folders.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type LeadifyClient } from "../client.js";
+/** Accepts "🇩🇪" or its code "1f1e9-1f1ea"; Leadify stores the code. */
+export declare function emojiCode(value: string): string;
+export declare function registerLeadGroupFolderTools(server: McpServer, client?: Pick<LeadifyClient, "get" | "post" | "put" | "delete">): void;

package/dist/tools/lead_group_folders.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { getClient } from "../client.js";
+import { toolResult, handleToolError } from "../types.js";
+/**
+ * PRD-2480: the shared lead group folders ("sous-menus" of the Leadify
+ * sidebar, PRD-2471). One organization shares them; a group sits in one
+ * folder at most. Every change here is what the whole team sees in Leadify.
+ */
+const UNIFIED = /^[a-f0-9]{2,6}(?:-[a-f0-9]{2,6}){0,15}$/i;
+/** Accepts "🇩🇪" or its code "1f1e9-1f1ea"; Leadify stores the code. */
+export function emojiCode(value) {
+    const trimmed = value.trim();
+    if (UNIFIED.test(trimmed))
+        return trimmed.toLowerCase();
+    return Array.from(trimmed).map((char) => char.codePointAt(0).toString(16)).join("-");
+}
+const emoji = z.string().trim().min(1).max(64)
+    .describe("Emoji shown before the folder name, as the character (🇩🇪) or its code (1f1e9-1f1ea).");
+const groupIds = z.array(z.string().trim().min(1)).max(500);
+const folderId = z.string().trim().min(1).describe("Folder ID from list_lead_group_folders.");
+const path = (id) => `/api/lead-group-folders/${encodeURIComponent(id)}`;
+export function registerLeadGroupFolderTools(server, client = getClient()) {
+    server.tool("list_lead_group_folders", "List the shared folders (sidebar sub-menus such as \"🇩🇪 DACH\") of one organization, each with its " +
+        "name, emoji code, description and the ids of the lead groups it holds. The whole team sees the same " +
+        "folders in Leadify. To list the groups of one folder with their details, use list_lead_groups with folder_id.", {
+        organization_id: z.string().trim().min(1).optional()
+            .describe("Organization ID from discover_leadify_context. Required when the key reaches several organizations."),
+    }, async ({ organization_id }) => {
+        try {
+            const params = organization_id ? new URLSearchParams({ organizationId: organization_id }) : undefined;
+            return toolResult(await client.get("/api/lead-group-folders", params));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("create_lead_group_folder", "Create a shared folder in the Leadify sidebar of one organization, optionally with groups already in it. " +
+        "A group sits in one folder at most: listed groups leave their previous folder. Needs write permission. " +
+        "Visible at once to the whole team.", {
+        organization_id: z.string().trim().min(1).optional()
+            .describe("Organization ID. Required when the key reaches several organizations."),
+        name: z.string().trim().min(1).max(100).describe("Folder name, e.g. DACH."),
+        emoji: emoji.optional(),
+        description: z.string().trim().max(2000).optional(),
+        lead_group_ids: groupIds.optional().describe("Lead groups of this organization to put in the folder."),
+    }, async ({ organization_id, name, emoji: icon, description, lead_group_ids }) => {
+        try {
+            return toolResult(await client.post("/api/lead-group-folders", {
+                ...(organization_id ? { organizationId: organization_id } : {}),
+                name,
+                ...(icon ? { emoji: emojiCode(icon) } : {}),
+                ...(description !== undefined ? { description } : {}),
+                ...(lead_group_ids?.length ? { leadGroupIds: lead_group_ids } : {}),
+            }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("update_lead_group_folder", "Change a shared folder: rename it, set or clear its emoji and description, add groups to it (they leave " +
+        "their previous folder) or take groups out of it. Only the fields given change, so a colleague's other " +
+        "edits are kept. Needs write permission.", {
+        folder_id: folderId,
+        name: z.string().trim().min(1).max(100).optional(),
+        emoji: emoji.nullable().optional().describe("New emoji, or null to remove it."),
+        description: z.string().trim().max(2000).nullable().optional().describe("New description, or null to remove it."),
+        add_lead_group_ids: groupIds.optional().describe("Groups moved into this folder."),
+        remove_lead_group_ids: groupIds.optional().describe("Groups taken out of this folder; they stay outside any folder."),
+    }, async ({ folder_id, name, emoji: icon, description, add_lead_group_ids, remove_lead_group_ids }) => {
+        try {
+            return toolResult(await client.put(path(folder_id), {
+                ...(name !== undefined ? { name } : {}),
+                ...(icon !== undefined ? { emoji: icon === null ? null : emojiCode(icon) } : {}),
+                ...(description !== undefined ? { description } : {}),
+                ...(add_lead_group_ids?.length ? { addLeadGroupIds: add_lead_group_ids } : {}),
+                ...(remove_lead_group_ids?.length ? { removeLeadGroupIds: remove_lead_group_ids } : {}),
+            }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("delete_lead_group_folder", "Delete a shared folder. Its groups are kept and simply leave the folder; no lead or group is deleted. " +
+        "Needs write permission.", { folder_id: folderId }, async ({ folder_id }) => {
+        try {
+            return toolResult(await client.delete(path(folder_id)));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("move_lead_groups_to_folder", "Put lead groups in a shared folder, or take them out of any folder with folder_id null. All groups move " +
+        "or none does. Needs write permission.", {
+        lead_group_ids: groupIds.min(1).describe("Lead groups to file, all from the same organization."),
+        folder_id: folderId.nullable().describe("Target folder ID, or null to take the groups out of any folder."),
+    }, async ({ lead_group_ids, folder_id }) => {
+        try {
+            return toolResult(await client.put("/api/lead-group-folders/assignments", { leadGroupIds: lead_group_ids, folderId: folder_id }));
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+}

package/dist/tools/leads.js

@@ -1,17 +1,16 @@
 import { z } from "zod";
 import { getClient } from "../client.js";
 import { toolResult, handleToolError } from "../types.js";
+import { eventRole } from "./events.js";
 const DEFAULT_LEAD_FIELDS = ["firstName", "lastName", "email", "company", "jobTitle", "linkedin"];
 const eventFilterSchema = z.object({
     event_ids: z.array(z.string().trim().min(1)).max(100).optional(),
     editions: z.array(z.string().trim().min(1).max(200)).max(100).optional(),
-    roles: z.array(z.enum([
-        "EXHIBITOR", "SPONSOR", "SPEAKER", "PARTNER", "ORGANIZER",
-        "CONTRIBUTOR", "PARTICIPANT", "UNKNOWN", "OTHER",
-    ])).max(20).optional(),
+    roles: z.array(eventRole).max(20).optional(),
     statuses: z.array(z.enum(["UNVERIFIED", "VERIFIED", "DISPUTED", "REFUTED"])).min(1).max(10).optional(),
     starts_on_from: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
     starts_on_to: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+    subject: z.enum(["EMPLOYER", "PERSON"]).optional().describe("EMPLOYER (default, historical behavior): leads whose company carries the participation. PERSON: only Person leads that carry the participation themselves, e.g. the registrants of a webinar. An employer's event is never a participation of the person."),
 }).strict().superRefine((value, context) => {
     if (value.starts_on_from && value.starts_on_to && value.starts_on_to < value.starts_on_from) {
         context.addIssue({ code: z.ZodIssueCode.custom, path: ["starts_on_to"], message: "starts_on_to must be on or after starts_on_from." });
@@ -169,7 +168,9 @@ export function registerLeadTools(server, client = getClient()) {
         "full-text search, saved views, and compact field projections. Returns lead ID plus " +
         "common identity fields by default. Pass `fields` for a workflow-specific projection " +
         "and `include_schema=true` only when the schema is explicitly needed. event_filter " +
-        "uses one correlated company participation and defaults explicitly to VERIFIED; " +
+        "uses one correlated participation and defaults explicitly to VERIFIED; subject=PERSON " +
+        "keeps only persons who carry the participation themselves, subject=EMPLOYER (default) " +
+        "matches through the company. A registration (REGISTERED) is not attendance (ATTENDED); " +
         "uncertain or absent data must never be cited as attendance or non-attendance.", {
         group_id: z.string().describe("ID of the lead group to query."),
         view_id: z
@@ -202,7 +203,7 @@ export function registerLeadTools(server, client = getClient()) {
             "operator to value. Operators: equals, not_equals, contains, not_contains, " +
             "gte, lte, is_true, is_false, is_null, is_not_null. " +
             'Example: {"industry": {"contains": "tech"}, "company": {"is_not_null": "true"}}'),
-        event_filter: eventFilterSchema.optional().describe("Structured company-event participation filter. Values within one list use OR; event, edition, role, status and date dimensions use AND against the same participation. statuses defaults to [VERIFIED]. Pass uncertain statuses explicitly for review. There is no confidence score, negative operator or absence filter."),
+        event_filter: eventFilterSchema.optional().describe("Structured event participation filter. subject chooses whose participation counts: EMPLOYER (default, the company's) or PERSON (the person's own). Values within one list use OR; event, edition, role, status and date dimensions use AND against the same participation. statuses defaults to [VERIFIED]. Pass uncertain statuses explicitly for review. There is no confidence score, negative operator or absence filter: the absence of a record proves nothing."),
     }, async ({ group_id, view_id, page, limit, search, fields, include_schema, filters, event_filter }) => {
         try {
             const params = new URLSearchParams();
@@ -231,6 +232,7 @@ export function registerLeadTools(server, client = getClient()) {
                     statuses: checked.statuses ?? ["VERIFIED"],
                     ...(checked.starts_on_from ? { startsOnFrom: checked.starts_on_from } : {}),
                     ...(checked.starts_on_to ? { startsOnTo: checked.starts_on_to } : {}),
+                    ...(checked.subject ? { subject: checked.subject } : {}),
                 }));
             }
             const data = await client.get("/get-leads", params);

package/dist/tools/organizations.d.ts

@@ -1,6 +1,15 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type LeadifyClient } from "../client.js";
 export declare function assertLeadGroupsBelongToOrganization(data: unknown, organizationId: string): Array<Record<string, unknown>>;
+/** PRD-2480: the shared sidebar folder of a group, or null when it sits outside any folder. */
+export declare function leadGroupFolder(group: Record<string, unknown>): {
+    folderId: string | null;
+    folder: {
+        id: unknown;
+        name: unknown;
+        emoji: unknown;
+    } | null;
+};
 /** Keep group reads navigable: never return schema, profiles, or lead data. */
 export declare function compactLeadGroup(group: unknown): Record<string, unknown>;
 export declare function registerOrganizationTools(server: McpServer, client?: Pick<LeadifyClient, "get" | "post" | "put">): void;

package/dist/tools/organizations.js

@@ -22,6 +22,26 @@ export function assertLeadGroupsBelongToOrganization(data, organizationId) {
     }
     return leadGroups;
 }
+/** PRD-2480: the shared sidebar folder of a group, or null when it sits outside any folder. */
+export function leadGroupFolder(group) {
+    const folder = group.folder && typeof group.folder === "object" ? group.folder : null;
+    return {
+        folderId: typeof group.folderId === "string" ? group.folderId : null,
+        folder: folder ? { id: folder.id, name: folder.name, emoji: folder.emoji ?? null } : null,
+    };
+}
+/** One line of a group list: navigation fields and its folder, never schema or leads. */
+function listedLeadGroup(group) {
+    return {
+        id: group.id,
+        name: group.name,
+        organizationId: group.organizationId,
+        leadCount: group._count?.leads ?? 0,
+        published: group.published ?? false,
+        refreshEnabled: group.refreshEnabled ?? false,
+        ...leadGroupFolder(group),
+    };
+}
 /** Keep group reads navigable: never return schema, profiles, or lead data. */
 export function compactLeadGroup(group) {
     const source = group && typeof group === "object" ? group : {};
@@ -42,6 +62,7 @@ export function compactLeadGroup(group) {
         refreshEnabled: source.refreshEnabled ?? false,
         refreshFrequencyDays: source.refreshFrequencyDays ?? null,
         createdAt: source.createdAt ?? null,
+        ...leadGroupFolder(source),
     };
 }
 export function registerOrganizationTools(server, client = getClient()) {
@@ -86,25 +107,22 @@ export function registerOrganizationTools(server, client = getClient()) {
         }
     });
     server.tool("list_lead_groups", "List lead groups visible in one explicitly selected organization. Returns a compact " +
-        "navigation view only: id, name, organizationId, lead count, published and refresh state. " +
+        "navigation view only: id, name, organizationId, lead count, published and refresh state, and the " +
+        "shared sidebar folder (folderId, folder { id, name, emoji }). Pass folder_id to keep exactly the " +
+        "groups of one folder (list_lead_group_folders), or \"none\" for the groups outside any folder. " +
         "Start with discover_leadify_context when no organization_id is known.", {
         organization_id: z.string().describe("Organization ID explicitly selected from list_organizations or discover_leadify_context."),
+        folder_id: z.string().trim().min(1).optional().describe("Keep only the groups of this folder, or \"none\" for groups outside any folder."),
         limit: z.number().int().min(1).max(100).optional().default(50).describe("Maximum groups returned, bounded to 100."),
-    }, async ({ organization_id, limit }) => {
+    }, async ({ organization_id, folder_id, limit }) => {
         try {
-            const params = new URLSearchParams({ organizationId: organization_id });
-            const data = await getClient().get("/api/lead-groups", params);
+            const params = new URLSearchParams({ organizationId: organization_id, ...(folder_id ? { folderId: folder_id } : {}) });
+            const data = await client.get("/api/lead-groups", params);
             const groups = assertLeadGroupsBelongToOrganization(data, organization_id);
             return toolResult({
                 organizationId: organization_id,
-                leadGroups: groups.slice(0, limit).map((group) => ({
-                    id: group.id,
-                    name: group.name,
-                    organizationId: group.organizationId,
-                    leadCount: group._count?.leads ?? 0,
-                    published: group.published ?? false,
-                    refreshEnabled: group.refreshEnabled ?? false,
-                })),
+                ...(folder_id ? { folderId: folder_id } : {}),
+                leadGroups: groups.slice(0, limit).map(listedLeadGroup),
                 total: groups.length,
                 truncated: groups.length > limit,
             });
@@ -115,12 +133,13 @@ export function registerOrganizationTools(server, client = getClient()) {
     });
     server.tool("get_lead_group", "Read the compact metadata of one accessible lead group by ID. Use this after list_lead_groups " +
         "or discover_leadify_context to confirm its type and operational state. Returns only navigation " +
-        "metadata (no lead records, schema, company profile, or persona payload) and reports inaccessible " +
+        "metadata (no lead records, schema, company profile, or persona payload), with its shared sidebar " +
+        "folder (folderId, folder), and reports inaccessible " +
         "groups as not found, without revealing their organization.", {
         lead_group_id: z.string().describe("Lead group ID returned by Leadify discovery or another authorized Leadify response."),
     }, async ({ lead_group_id }) => {
         try {
-            const data = await getClient().get(`/api/lead-group/${encodeURIComponent(lead_group_id)}`);
+            const data = await client.get(`/api/lead-group/${encodeURIComponent(lead_group_id)}`);
             const source = data && typeof data === "object" ? data : {};
             return toolResult({ leadGroup: compactLeadGroup(source.leadGroup) });
         }
@@ -130,13 +149,14 @@ export function registerOrganizationTools(server, client = getClient()) {
     });
     server.tool("discover_leadify_context", "Safe zero-ID entry point for Leadify. With no organization_id, lists accessible organizations " +
         "and never chooses one when several are available. With an explicit organization_id, returns " +
-        "a compact list of its lead groups. Use the returned lead_group_id with lead, campaign, persona " +
+        "a compact list of its lead groups with their folder, and the organization's shared sidebar folders. " +
+        "Use the returned lead_group_id with lead, campaign, persona " +
         "and Context Workspace tools.", {
         organization_id: z.string().optional().describe("Organization selected explicitly after discovery. Omit only for the first step."),
         limit: z.number().int().min(1).max(100).optional().default(50).describe("Maximum lead groups returned after selection."),
     }, async ({ organization_id, limit }) => {
         try {
-            const orgData = await getClient().get("/api/organizations");
+            const orgData = await client.get("/api/organizations");
             const organizations = Array.isArray(orgData.organizations)
                 ? orgData.organizations.map((org) => ({ id: org.id, name: org.name ?? null, slug: org.slug ?? null }))
                 : [];
@@ -149,11 +169,28 @@ export function registerOrganizationTools(server, client = getClient()) {
             if (!organizations.some((org) => org.id === organization_id)) {
                 return toolResult({ organizations, selectionRequired: true, message: "organization_id is not accessible to this key." });
             }
-            const groupsData = await getClient().get("/api/lead-groups", new URLSearchParams({ organizationId: organization_id }));
+            const groupsData = await client.get("/api/lead-groups", new URLSearchParams({ organizationId: organization_id }));
             const groups = assertLeadGroupsBelongToOrganization(groupsData, organization_id);
+            // The folders complete the map; a failure to read them never hides the groups.
+            let folders = null;
+            let foldersError;
+            try {
+                const folderData = await client.get("/api/lead-group-folders", new URLSearchParams({ organizationId: organization_id }));
+                folders = Array.isArray(folderData?.folders)
+                    ? folderData.folders.map((folder) => ({ id: folder.id, name: folder.name, emoji: folder.emoji ?? null, leadGroupIds: folder.leadGroupIds ?? [] }))
+                    : [];
+            }
+            catch (error) {
+                foldersError = error instanceof Error ? error.message : String(error);
+            }
             return toolResult({
                 organization: organizations.find((org) => org.id === organization_id),
-                leadGroups: groups.slice(0, limit).map((group) => ({ id: group.id, name: group.name, organizationId: group.organizationId, leadCount: group._count?.leads ?? 0, published: group.published ?? false })),
+                folders,
+                ...(foldersError ? { foldersError } : {}),
+                leadGroups: groups.slice(0, limit).map((group) => {
+                    const { refreshEnabled: _refreshEnabled, ...listed } = listedLeadGroup(group);
+                    return listed;
+                }),
                 total: groups.length,
                 truncated: groups.length > limit,
                 next: "Choose a lead_group_id, then use get_leads, get_context_workspace, or list_persona_contracts.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agifyai/leadify-mcp",
-  "version": "9.5.0",
+  "version": "9.7.0",
   "description": "MCP server for Leadify lead management API",
   "type": "module",
   "main": "dist/index.js",