@trylighthouse/mcp-server 0.1.3 → 0.1.4

package/build/server.js

@@ -0,0 +1,1397 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { LighthouseAPI } from "./api.js";
+function text(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function err(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+/**
+ * Creates an MCP server wired to a Lighthouse API client.
+ * For stdio (local/npm): apiKey is read from LIGHTHOUSE_API_KEY env var.
+ * For HTTP (deployed): apiKey is passed from the query param per session.
+ */
+export function createServer(apiKey) {
+    const api = new LighthouseAPI(apiKey);
+    const server = new McpServer({
+        name: "lighthouse",
+        version: "0.1.4",
+    });
+    // ─────────────────────────────────────────────────────────
+    // FILTER FORMAT REFERENCE (used in tool descriptions)
+    // ─────────────────────────────────────────────────────────
+    //
+    // Shared filter structure (CRM & Discovery):
+    //   { "operator":"AND"|"OR", "conditions":[...], "groups":[...] }
+    //   conditions: [{ "field":"<key>", "operator":"<op>", "value":<val> }]
+    //   groups: nested filter blocks with their own operator/conditions/groups
+    //
+    // Value formats:
+    //   - text operators (contains, eq, etc.): string value
+    //   - number operators (gt, lt, eq, etc.): numeric value
+    //   - CRM between (number): { "from": <num>, "to": <num> } OR [min, max]
+    //   - CRM between (date):   { "from": "YYYY-MM-DD", "to": "YYYY-MM-DD" }
+    //   - Discovery between:    { "min": <num>, "max": <num> }
+    //   - contains_any / not_contains_any / contains_all: array of values e.g. ["US","GB"]
+    //   - empty / not_empty: no value needed (omit value key)
+    //   - boolean eq: true or false
+    //   - date (before, after, on): ISO date string "2024-01-15"
+    //
+    // CRM operators (from FilterBuilder.jsx):
+    //   text/url:              contains, not_contains, starts_with, ends_with, eq, neq, empty, not_empty
+    //   number/currency/rating: gt, gte, lt, lte, eq, neq, empty, not_empty
+    //   date/datetimez:        before, after, on
+    //   select/status/user:    contains_any, not_contains_any, empty, not_empty
+    //   multi_select/category/multi_user/multi_record: contains_any, not_contains_any, contains_all, empty, not_empty
+    //   record:                contains_any, not_contains_any, empty, not_empty
+    //   domain/email/phone:    contains_any, not_contains_any, contains_all, empty, not_empty
+    //   list_entries:          contains_any, not_contains_any, contains_all
+    //
+    // Discovery operators (from resourceFilterConfig.js):
+    //   short_text:            contains, is
+    //   long_text:             contains, not_contains, empty, not_empty
+    //   text/url:              contains, not_contains, starts_with, ends_with, eq, neq, empty, not_empty
+    //   number/currency:       between, gt, gte, lt, lte, eq, neq, empty, not_empty
+    //   range:                 between, gt, lt, empty, not_empty
+    //   date:                  after, before
+    //   select:                contains_any, not_contains_any, empty, not_empty
+    //   multi_select/investor_multi_select/work_experience_multi_select/education_multi_select/signal_select/language_select: contains_any, not_contains_any, contains_all, empty, not_empty
+    //   funding_type_multi_select: contains_any, not_contains_any, empty, not_empty
+    //   multi_user:            contains_any, not_contains_any, contains_all, empty, not_empty
+    //   boolean/checkbox:      eq
+    //   json:                  contains, not_contains, empty, not_empty
+    // ─────────────────────────────────────────────────────────
+    const CRM_FILTER_DESCRIPTION = "CRM filter object. Format: " +
+        '{"operator":"AND","conditions":[{"field":"<key>","operator":"<op>","value":<val>}],"groups":[]}. ' +
+        "IMPORTANT: First call lighthouse_crm_get_attributes to discover available field keys and types. " +
+        "Operators by field type — " +
+        "text/url: contains, not_contains, starts_with, ends_with, eq, neq, empty, not_empty; " +
+        "number/currency/rating: gt, gte, lt, lte, eq, neq, empty, not_empty; " +
+        "date: before, after, on; " +
+        "select/status/user: contains_any, not_contains_any, empty, not_empty; " +
+        "multi_select/category/multi_user/multi_record: contains_any, not_contains_any, contains_all, empty, not_empty; " +
+        "record: contains_any, not_contains_any, empty, not_empty; " +
+        "domain/email/phone: contains_any, not_contains_any, contains_all, empty, not_empty; " +
+        "list_entries: contains_any, not_contains_any, contains_all. " +
+        "Value formats: text ops → string; number ops → number; between (number) → {\"from\": min, \"to\": max}; " +
+        "between (date) → {\"from\": \"YYYY-MM-DD\", \"to\": \"YYYY-MM-DD\"}; " +
+        "contains_any/not_contains_any/contains_all → array of values; " +
+        "empty/not_empty → omit value; date ops → ISO date string. " +
+        "Groups allow nested AND/OR filter blocks with their own operator/conditions/groups. " +
+        "Do NOT use discovery field keys here — CRM fields come from lighthouse_crm_get_attributes.";
+    const CRM_SORT_DESCRIPTION = 'CRM sort array. Format: [{"field":"<key>","direction":"asc"|"desc"}]. ' +
+        "Field keys must match a sortable CRM attribute (text, number, date, select, status, currency, rating).";
+    const DISCOVERY_FILTER_DESCRIPTION = "Discovery filter object. Format: " +
+        '{"operator":"AND","conditions":[{"field":"<filter_id>","operator":"<op>","value":<val>}],"groups":[]}. ' +
+        "IMPORTANT: First call lighthouse_discovery_get_attributes to discover available filter_id values and types. " +
+        "Fields use prefixed keys (company_name, company_headcount, person_country, etc.). " +
+        "Operators by field type — " +
+        "short_text: contains, is; " +
+        "long_text: contains, not_contains, empty, not_empty; " +
+        "text/url: contains, not_contains, starts_with, ends_with, eq, neq, empty, not_empty; " +
+        "number/currency: between, gt, gte, lt, lte, eq, neq, empty, not_empty; " +
+        "range: between, gt, lt, empty, not_empty; " +
+        "date: after, before; " +
+        "select: contains_any, not_contains_any, empty, not_empty; " +
+        "multi_select/investor_multi_select/work_experience_multi_select/education_multi_select/signal_select/language_select: contains_any, not_contains_any, contains_all, empty, not_empty; " +
+        "funding_type_multi_select: contains_any, not_contains_any, empty, not_empty; " +
+        "multi_user: contains_any, not_contains_any, contains_all, empty, not_empty; " +
+        "boolean/checkbox: eq; " +
+        "json: contains, not_contains, empty, not_empty. " +
+        "Value formats: text ops → string; number ops → number; between → {\"min\": <num>, \"max\": <num>}; " +
+        "contains_any/not_contains_any/contains_all → array of values; empty/not_empty → omit value; boolean eq → true/false. " +
+        "Do NOT use CRM attribute keys here — discovery fields come from lighthouse_discovery_get_attributes.";
+    const DISCOVERY_SORT_DESCRIPTION = 'Discovery sort object. Format: {"by":"<field_name>","dir":"asc"|"desc"}. ' +
+        "Common sort fields: founded_on, total_funding_amount_usd, score. Default: score descending.";
+    // ─── CRM: Attributes ────────────────────────────────────
+    server.registerTool("lighthouse_crm_get_attributes", {
+        title: "Get CRM Attributes",
+        description: "Get custom field definitions for a CRM record type. " +
+            "ALWAYS call this before building filters for search_records, list_records, or creating/updating views. " +
+            "Returns field keys, types, and options needed to construct valid filter conditions. " +
+            "This queries YOUR WORKSPACE's custom fields (CRM data you manage).",
+        inputSchema: {
+            entity_type: z
+                .enum(["company", "person", "deal"])
+                .describe("Record type to get attributes for"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get("/attributes", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_get_attribute", {
+        title: "Get CRM Attribute",
+        description: "Get a single custom field definition by its field_permalink.",
+        inputSchema: {
+            field_permalink: z.string().describe("Field permalink (unique key) of the attribute"),
+            entity_type: z.enum(["company", "person", "deal", "task"]).describe("Record type (required)"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/attributes/${params.entity_type}/${params.field_permalink}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_create_attribute", {
+        title: "Create CRM Attribute",
+        description: "Create a new custom field in your CRM workspace. " +
+            "Types: text, number, currency, percentage, date, datetimez, select, multi_select, status, checkbox, url, email, phone, rating, record, multi_record, user, multi_user.",
+        inputSchema: {
+            label: z.string().describe("Display label for the field"),
+            entity_type: z.enum(["company", "person", "deal", "task"]).describe("Record type this field belongs to"),
+            data_type: z.string().describe("Field type (text, number, currency, percentage, date, datetimez, select, multi_select, status, checkbox, url, email, phone, rating, record, multi_record, user, multi_user)"),
+            record_type: z.enum(["company", "person", "deal", "task"]).optional().describe("For record/multi_record fields: which record type to link to"),
+            options: z
+                .array(z.record(z.unknown()))
+                .optional()
+                .describe("For select/multi_select/status fields: array of {value, label} option objects"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.post("/attributes", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_update_attribute", {
+        title: "Update CRM Attribute",
+        description: "Update a custom field's label or configuration.",
+        inputSchema: {
+            field_permalink: z.string().describe("Field permalink of the attribute to update"),
+            entity_type: z.enum(["company", "person", "deal", "task"]).describe("Record type (required)"),
+            label: z.string().optional().describe("New display label"),
+        },
+    }, async (params) => {
+        try {
+            const { field_permalink, entity_type, ...body } = params;
+            const res = await api.patch(`/attributes/${entity_type}/${field_permalink}`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_delete_attribute", {
+        title: "Delete CRM Attribute",
+        description: "Delete (archive) a custom field. Only custom fields can be deleted, not system fields.",
+        inputSchema: {
+            field_permalink: z.string().describe("Field permalink of the attribute to delete"),
+            entity_type: z.enum(["company", "person", "deal", "task"]).describe("Record type (required)"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.delete(`/attributes/${params.entity_type}/${params.field_permalink}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_get_color_palette", {
+        title: "Get Color Palette",
+        description: "Get the available color palette for select/multi_select/status field options. " +
+            "Returns an array of {hex_code, label} objects. " +
+            "Use this to discover valid hex color codes when creating or updating select options.",
+        inputSchema: {},
+    }, async () => {
+        try {
+            const res = await api.get("/attributes/colors");
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── CRM: Options (select field values) ─────────────────
+    server.registerTool("lighthouse_crm_list_options", {
+        title: "List CRM Field Options",
+        description: "Get select/multi_select field options. " +
+            "Use this to discover available values for select fields before setting them on records.",
+        inputSchema: {
+            entity_type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            field_permalink: z.string().describe("Field permalink of the select/multi_select field"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/options/${params.entity_type}/${params.field_permalink}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_create_option", {
+        title: "Create CRM Field Option",
+        description: "Add a new option to a select/multi_select field. The option value is auto-generated from the label. Returns the updated list of options for the field.",
+        inputSchema: {
+            entity_type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            field_permalink: z.string().describe("Field permalink of the select/multi_select field"),
+            label: z.string().describe("Option display label"),
+            color: z.string().optional().describe("Option color (hex code from palette, auto-assigned if omitted)"),
+        },
+    }, async (params) => {
+        try {
+            const { entity_type, field_permalink, ...body } = params;
+            const res = await api.post(`/options/${entity_type}/${field_permalink}`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_delete_option", {
+        title: "Delete CRM Field Option",
+        description: "Delete an option value from a select/multi_select field. Cannot delete system default options.",
+        inputSchema: {
+            entity_type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            field_permalink: z.string().describe("Field permalink of the select/multi_select field"),
+            value: z.string().describe("Option value to delete"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.delete(`/options/${params.entity_type}/${params.field_permalink}/${params.value}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── CRM: Records ────────────────────────────────────────
+    server.registerTool("lighthouse_crm_search_records", {
+        title: "Search CRM Records",
+        description: "Search and filter records in YOUR CRM workspace (companies, people, or deals you've added). " +
+            "Supports filters, sorting, pagination, and saved views. " +
+            "NEVER guess field keys — ALWAYS call lighthouse_crm_get_attributes first to get the exact field keys " +
+            "for the entity_type, then use those keys in your filter conditions. " +
+            "NOT for discovering new companies/people — use lighthouse_discovery_* tools for that.",
+        inputSchema: {
+            type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            filters: z
+                .record(z.unknown())
+                .optional()
+                .describe(CRM_FILTER_DESCRIPTION),
+            sort: z
+                .array(z.record(z.unknown()))
+                .optional()
+                .describe(CRM_SORT_DESCRIPTION),
+            limit: z.number().min(1).max(100).default(25).describe("Records per page (max 100)"),
+            offset: z.number().min(0).default(0).describe("Number of records to skip"),
+            view_id: z
+                .string()
+                .uuid()
+                .optional()
+                .describe("Load saved filters/sort from a view. User-provided filters override view filters."),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.post(`/records/${params.type}/search`, {
+                filters: params.filters,
+                sort: params.sort,
+                limit: params.limit,
+                offset: params.offset,
+                view_id: params.view_id,
+            });
+            return text(res);
+        }
+        catch (e) {
+            return err(`Search failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_get_record", {
+        title: "Get CRM Record",
+        description: "Get a single CRM record by ID with all fields and relationships.",
+        inputSchema: {
+            type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            id: z.string().uuid().describe("Record ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/records/${params.type}/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_create_record", {
+        title: "Create CRM Record",
+        description: "Create a new CRM record. Required fields: " +
+            "company (name, domain), person (first_name, last_name), deal (name).",
+        inputSchema: {
+            type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            data: z.record(z.unknown()).describe("Record fields (name, domain, first_name, last_name, etc.)"),
+            attributes: z
+                .record(z.unknown())
+                .optional()
+                .describe("Custom field values keyed by field_permalink (from lighthouse_crm_get_attributes)"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.post(`/records/${params.type}`, {
+                data: params.data,
+                attributes: params.attributes,
+            });
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_update_record", {
+        title: "Update CRM Record",
+        description: "Update an existing CRM record's fields.",
+        inputSchema: {
+            type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            id: z.string().uuid().describe("Record ID"),
+            data: z.record(z.unknown()).describe("Fields to update"),
+            attributes: z.record(z.unknown()).optional().describe("Custom field values to update (keyed by field_permalink)"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.patch(`/records/${params.type}/${params.id}`, {
+                data: params.data,
+                attributes: params.attributes,
+            });
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_delete_record", {
+        title: "Delete CRM Record",
+        description: "Permanently delete a CRM record.",
+        inputSchema: {
+            type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            id: z.string().uuid().describe("Record ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.delete(`/records/${params.type}/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── CRM: Lists ──────────────────────────────────────────
+    server.registerTool("lighthouse_crm_create_list", {
+        title: "Create CRM List",
+        description: "Create a new CRM list to organize records. Defaults to 'private' visibility. " +
+            "To share with specific teams after creation, use lighthouse_crm_share_list_with_teams. " +
+            "Requires lists.edit permission.",
+        inputSchema: {
+            name: z.string().describe("List name"),
+            type: z.enum(["company", "person", "deal"]).describe("Record type for this list"),
+            sharing: z.enum(["private", "workspace"]).default("private").optional().describe("Visibility: 'private' (default) or 'workspace'"),
+            color: z.string().optional().describe("Hex color code for the list"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.post("/lists", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_list_lists", {
+        title: "List CRM Lists",
+        description: "Get all CRM lists in your workspace.",
+        inputSchema: {},
+    }, async (params) => {
+        try {
+            const res = await api.get("/lists", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_get_list", {
+        title: "Get CRM List",
+        description: "Get a single CRM list by ID with its configuration.",
+        inputSchema: {
+            id: z.string().uuid().describe("List ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/lists/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_update_list", {
+        title: "Update CRM List",
+        description: "Update a CRM list's name or configuration.",
+        inputSchema: {
+            id: z.string().uuid().describe("List ID"),
+            name: z.string().optional().describe("New list name"),
+            sharing: z.enum(["private", "workspace"]).optional().describe("New visibility setting"),
+            color: z.string().optional().describe("New hex color code"),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...body } = params;
+            const res = await api.patch(`/lists/${id}`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_delete_list", {
+        title: "Delete CRM List",
+        description: "Permanently delete a CRM list.",
+        inputSchema: {
+            id: z.string().uuid().describe("List ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.delete(`/lists/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_get_list_records", {
+        title: "Get List Records",
+        description: "Get records in a CRM list with optional filtering, sorting, and view support. " +
+            "Same filter format as search_records.",
+        inputSchema: {
+            id: z.string().uuid().describe("List ID"),
+            filters: z.record(z.unknown()).optional().describe(CRM_FILTER_DESCRIPTION),
+            sort: z.array(z.record(z.unknown())).optional().describe(CRM_SORT_DESCRIPTION),
+            limit: z.number().min(1).max(100).default(25),
+            offset: z.number().min(0).default(0),
+            view_id: z.string().uuid().optional().describe("Load saved filters/sort from a view. User-provided filters override view filters."),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...query } = params;
+            const res = await api.get(`/lists/${id}/records`, query);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_add_to_list", {
+        title: "Add Record to List",
+        description: "Add a CRM record to a list.",
+        inputSchema: {
+            list_id: z.string().uuid().describe("List ID"),
+            record_id: z.string().uuid().describe("Record ID to add"),
+            type: z.enum(["company", "person", "deal"]).describe("Record type"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.post(`/lists/${params.list_id}/records`, {
+                record_id: params.record_id,
+                type: params.type,
+            });
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_remove_from_list", {
+        title: "Remove Record from List",
+        description: "Remove a record from a CRM list.",
+        inputSchema: {
+            list_id: z.string().uuid().describe("List ID"),
+            record_id: z.string().uuid().describe("Record ID to remove"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.delete(`/lists/${params.list_id}/records/${params.record_id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── Sharing: List Teams ──────────────────────────────────
+    server.registerTool("lighthouse_crm_share_list_with_teams", {
+        title: "Share List with Teams",
+        description: "Grant team-level access to a CRM list. Only the list owner can share. " +
+            "Use lighthouse_workspace_list_teams to find team IDs first. " +
+            "Requires lists.share permission. " +
+            "Returns formatted list: {id, name, type, sharing, color, count, owner, shared_with_teams, created_at, updated_at}.",
+        inputSchema: {
+            id: z.string().uuid().describe("List ID"),
+            team_ids: z.array(z.string().uuid()).describe("Array of team UUIDs to grant access to"),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...body } = params;
+            const res = await api.post(`/lists/${id}/teams`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_revoke_list_from_teams", {
+        title: "Revoke List Team Access",
+        description: "Revoke team-level access from a CRM list. Only the list owner can revoke. " +
+            "Requires lists.share permission. " +
+            "Returns formatted list: {id, name, type, sharing, color, count, owner, shared_with_teams, created_at, updated_at}.",
+        inputSchema: {
+            id: z.string().uuid().describe("List ID"),
+            team_ids: z.array(z.string().uuid()).describe("Array of team UUIDs to revoke access from"),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...body } = params;
+            const res = await api.delete(`/lists/${id}/teams`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_update_list_sharing", {
+        title: "Update List Sharing Status",
+        description: "Change a CRM list's sharing visibility. Setting to 'private' also removes all team permissions. " +
+            "Only the list owner can change sharing. Requires lists.share permission. " +
+            "Returns formatted list: {id, name, type, sharing, color, count, owner, shared_with_teams, created_at, updated_at}.",
+        inputSchema: {
+            id: z.string().uuid().describe("List ID"),
+            sharing: z.enum(["private", "workspace"]).describe("New sharing visibility"),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...body } = params;
+            const res = await api.patch(`/lists/${id}/sharing`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── CRM: Notes ──────────────────────────────────────────
+    server.registerTool("lighthouse_crm_list_notes", {
+        title: "List Notes",
+        description: "Get notes for a CRM record.",
+        inputSchema: {
+            record_id: z.string().uuid().optional().describe("Record ID to filter notes by (required)"),
+            record_type: z.enum(["company", "person", "deal", "task"]).optional().describe("Record type: company, person, or deal (required)"),
+            limit: z.number().min(1).max(100).default(25),
+            offset: z.number().min(0).default(0),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get("/notes", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_create_note", {
+        title: "Create Note",
+        description: "Create a note on a CRM record. " +
+            "Content is HTML. For plain text, just pass it as-is. " +
+            "To @mention/tag workspace users in the note, you MUST: " +
+            "1) Call lighthouse_workspace_list_users first to find the user's ID, " +
+            "2) Include their user IDs in the tagged_users array, " +
+            "3) Include a mention span in the HTML content: " +
+            '<span data-type="mention" data-id="USER_UUID" data-label="First Last">@First Last</span>. ' +
+            "Tagged users receive an in-app notification.",
+        inputSchema: {
+            record_id: z.string().uuid().describe("Record ID to attach the note to"),
+            record_type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            title: z.string().describe("Note title"),
+            content: z.string().describe("Note content (plain text or HTML). Use <p> tags for paragraphs. For @mentions, include mention spans (see description)."),
+            tagged_users: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Array of workspace user UUIDs to tag/mention in the note. Must match mention spans in content."),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.post("/notes", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_get_note", {
+        title: "Get Note",
+        description: "Get a single note by ID.",
+        inputSchema: {
+            id: z.string().uuid().describe("Note ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/notes/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_delete_note", {
+        title: "Delete Note",
+        description: "Permanently delete a note.",
+        inputSchema: {
+            id: z.string().uuid().describe("Note ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.delete(`/notes/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── CRM: Tasks ──────────────────────────────────────────
+    server.registerTool("lighthouse_crm_list_tasks", {
+        title: "List Tasks",
+        description: "List CRM tasks with optional filtering and sorting. " +
+            "The filters object supports: " +
+            'filter (CRM-style): {"operator":"AND","conditions":[{"field":"status","operator":"contains_any","value":["pending"]}]}; ' +
+            'sort: [{"field":"due_date","direction":"asc"}]; ' +
+            "Filterable fields: title, status, priority, due_date, description, assigned_to, records (person/company/deal), plus custom fields.",
+        inputSchema: {
+            filters: z
+                .object({
+                filter: z.record(z.any()).optional().describe("CRM filter object with operator/conditions/groups"),
+                sort: z.array(z.record(z.any())).optional().describe('Sort array: [{"field":"due_date","direction":"asc"}]'),
+            })
+                .optional()
+                .describe("Filter and sort options"),
+            limit: z.number().min(1).max(100).default(25),
+            offset: z.number().min(0).default(0),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get("/tasks", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_get_task", {
+        title: "Get Task",
+        description: "Get a single CRM task by ID.",
+        inputSchema: {
+            id: z.string().uuid().describe("Task ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/tasks/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_create_task", {
+        title: "Create Task",
+        description: "Create a CRM task, optionally linked to records and assigned to users. " +
+            "The SQL expects assigned_to as [{id: uuid}] and records as {company: [{id}], person: [{id}], deal: [{id}]}.",
+        inputSchema: {
+            title: z.string().describe("Task title"),
+            description: z.string().optional().describe("Task description"),
+            status: z.string().optional().describe("Task status (e.g. 'pending', 'in_progress', 'completed')"),
+            priority: z.number().int().optional().describe("Priority as integer (e.g. 1=low, 2=medium, 3=high)"),
+            due_date: z.string().optional().describe("Due date (ISO 8601)"),
+            assigned_to: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Array of user UUIDs to assign the task to"),
+            records: z
+                .object({
+                company: z.array(z.string().uuid()).optional(),
+                person: z.array(z.string().uuid()).optional(),
+                deal: z.array(z.string().uuid()).optional(),
+            })
+                .optional()
+                .describe("Records to link: {company: [ids], person: [ids], deal: [ids]}"),
+            attributes: z.record(z.any()).optional().describe("Custom task field values as {field_permalink: value}"),
+        },
+    }, async (params) => {
+        try {
+            const { attributes, assigned_to, records, ...rest } = params;
+            const data = { ...rest };
+            if (assigned_to)
+                data.assigned_to = assigned_to.map((id) => ({ id }));
+            if (records) {
+                data.records = {
+                    company: records.company?.map((id) => ({ id })) || [],
+                    person: records.person?.map((id) => ({ id })) || [],
+                    deal: records.deal?.map((id) => ({ id })) || [],
+                };
+            }
+            const res = await api.post("/tasks", { data, attributes });
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_update_task", {
+        title: "Update Task",
+        description: "Update a CRM task. Provide only fields you want to change. " +
+            "assigned_to replaces all current assignees. records replaces all linked records.",
+        inputSchema: {
+            id: z.string().uuid().describe("Task ID"),
+            title: z.string().optional(),
+            description: z.string().optional(),
+            status: z.string().optional().describe("Task status (e.g. 'pending', 'in_progress', 'completed')"),
+            priority: z.number().int().optional().describe("Priority as integer (e.g. 1=low, 2=medium, 3=high)"),
+            due_date: z.string().optional(),
+            assigned_to: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Array of user UUIDs to assign (replaces current assignees)"),
+            records: z
+                .object({
+                company: z.array(z.string().uuid()).optional(),
+                person: z.array(z.string().uuid()).optional(),
+                deal: z.array(z.string().uuid()).optional(),
+            })
+                .optional()
+                .describe("Records to link (replaces current): {company: [ids], person: [ids], deal: [ids]}"),
+            attributes: z.record(z.any()).optional().describe("Custom task field values as {field_permalink: value}"),
+        },
+    }, async (params) => {
+        try {
+            const { id, attributes, assigned_to, records, ...rest } = params;
+            const data = { ...rest };
+            if (assigned_to)
+                data.assigned_to = assigned_to.map((id) => ({ id }));
+            if (records) {
+                data.records = {
+                    company: records.company?.map((id) => ({ id })) || [],
+                    person: records.person?.map((id) => ({ id })) || [],
+                    deal: records.deal?.map((id) => ({ id })) || [],
+                };
+            }
+            const res = await api.patch(`/tasks/${id}`, { data, attributes });
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_delete_task", {
+        title: "Delete Task",
+        description: "Permanently delete a CRM task.",
+        inputSchema: {
+            id: z.string().uuid().describe("Task ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.delete(`/tasks/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── CRM: Views ──────────────────────────────────────────
+    server.registerTool("lighthouse_crm_list_views", {
+        title: "List CRM Views",
+        description: "Get all saved CRM views. Views store filter/sort configurations that can be loaded in search_records.",
+        inputSchema: {
+            entity_type: z.enum(["company", "person", "deal"]).optional().describe("Filter by record type"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get("/views", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_create_view", {
+        title: "Create CRM View",
+        description: "Create a saved CRM view with filters and sort configuration. " +
+            "Views are for YOUR CRM data only (not discovery). " +
+            "WORKFLOW: 1) Call lighthouse_crm_get_attributes to get field keys, " +
+            "2) Build a filter object using those keys, " +
+            "3) Create the view with the filter. " +
+            "The saved filters will auto-apply when search_records is called with this view_id.",
+        inputSchema: {
+            name: z.string().describe("View name"),
+            entity_type: z.enum(["company", "person", "deal"]).describe("Record type"),
+            filters: z
+                .record(z.unknown())
+                .optional()
+                .describe(CRM_FILTER_DESCRIPTION),
+            sort: z.array(z.record(z.unknown())).optional().describe(CRM_SORT_DESCRIPTION),
+            view_type: z.enum(["table", "kanban"]).default("table").describe("View layout type"),
+            grouped_by: z.string().optional().describe("Field key to group by (required for kanban views)"),
+            sharing: z.enum(["private", "workspace"]).default("private").describe("Visibility"),
+            team_ids: z.array(z.string().uuid()).optional().describe("Team UUIDs to share the view with. Replaces any existing team shares."),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.post("/views", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_update_view", {
+        title: "Update CRM View",
+        description: "Update a saved CRM view's name, filters, sort, or sharing settings. " +
+            "Uses CRM filter format — call lighthouse_crm_get_attributes first if modifying filters.",
+        inputSchema: {
+            id: z.string().uuid().describe("View ID"),
+            name: z.string().optional(),
+            filters: z.record(z.unknown()).optional().describe(CRM_FILTER_DESCRIPTION),
+            sort: z.array(z.record(z.unknown())).optional().describe(CRM_SORT_DESCRIPTION),
+            view_type: z.enum(["table", "kanban"]).optional(),
+            grouped_by: z.string().optional().describe("Field key to group by (required for kanban views)"),
+            sharing: z.enum(["private", "workspace"]).optional(),
+            team_ids: z.array(z.string().uuid()).optional().describe("Team UUIDs to share the view with. Replaces any existing team shares."),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...body } = params;
+            const res = await api.patch(`/views/${id}`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_get_view", {
+        title: "Get CRM View",
+        description: "Get a single saved CRM view by ID.",
+        inputSchema: {
+            id: z.string().uuid().describe("View ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/views/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_delete_view", {
+        title: "Delete CRM View",
+        description: "Permanently delete a saved CRM view.",
+        inputSchema: {
+            id: z.string().uuid().describe("View ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.delete(`/views/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── Workspace: Users ───────────────────────────────────
+    server.registerTool("lighthouse_workspace_me", {
+        title: "Get Current User",
+        description: "Get the current authenticated user's profile (name, email, role, etc.).",
+        inputSchema: {},
+    }, async () => {
+        try {
+            const res = await api.get("/users/me");
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_workspace_list_users", {
+        title: "List Workspace Users",
+        description: "List users in the workspace. Use this to find user IDs for task assignment, note tagging, or filtering by user. " +
+            "Supports search by name/email.",
+        inputSchema: {
+            search: z.string().optional().describe("Search by name or email"),
+            team_id: z.string().uuid().optional().describe("Filter by team ID"),
+            role_id: z.string().uuid().optional().describe("Filter by role ID"),
+            limit: z.number().min(1).max(100).default(25),
+            offset: z.number().min(0).default(0),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get("/users", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_workspace_get_user", {
+        title: "Get Workspace User",
+        description: "Get a specific workspace user's profile by ID.",
+        inputSchema: {
+            id: z.string().uuid().describe("User ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/users/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── Workspace: Teams ───────────────────────────────────
+    server.registerTool("lighthouse_workspace_list_teams", {
+        title: "List Workspace Teams",
+        description: "List all teams in the workspace.",
+        inputSchema: {
+            limit: z.number().min(1).max(100).default(25),
+            offset: z.number().min(0).default(0),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get("/teams", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_workspace_get_team", {
+        title: "Get Workspace Team",
+        description: "Get a specific team by ID with its members.",
+        inputSchema: {
+            id: z.string().uuid().describe("Team ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/teams/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── Discovery: Attributes ───────────────────────────────
+    server.registerTool("lighthouse_discovery_get_attributes", {
+        title: "Get Discovery Attributes",
+        description: "Get available filter fields for Lighthouse's company/people database (discovery). " +
+            "ALWAYS call this before building filters for discovery_search_companies or discovery_search_people. " +
+            "Returns field definitions with filter_id, type, and options. " +
+            "These are NOT your CRM fields — these are Lighthouse's global database fields.",
+        inputSchema: {
+            type: z
+                .enum(["company", "person"])
+                .optional()
+                .describe("Entity type: 'company' or 'person'. If omitted, returns both as { company: [...], person: [...] }."),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get("/discovery/attributes", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── Discovery: Search ───────────────────────────────────
+    server.registerTool("lighthouse_discovery_search_companies", {
+        title: "Search Discovery Companies",
+        description: "Search Lighthouse's global company database to DISCOVER new companies. " +
+            "This searches Lighthouse's enriched database (millions of companies), NOT your CRM. " +
+            "NEVER guess field keys — ALWAYS call lighthouse_discovery_get_attributes with type=company first " +
+            "to get the exact filter_id values, then use those in your filter conditions. " +
+            "Common fields: company_name, company_headcount, company_hq_country, company_total_funding, company_categories.",
+        inputSchema: {
+            filters: z
+                .record(z.unknown())
+                .optional()
+                .describe(DISCOVERY_FILTER_DESCRIPTION),
+            sort: z.record(z.unknown()).optional().describe(DISCOVERY_SORT_DESCRIPTION),
+            skip: z.number().min(0).default(0).describe("Number of results to skip"),
+            limit: z.number().min(1).max(100).default(25).describe("Results per page"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.post("/database/get-companies", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_discovery_search_people", {
+        title: "Search Discovery People",
+        description: "Search Lighthouse's global people database to DISCOVER new people. " +
+            "This searches Lighthouse's enriched database, NOT your CRM. " +
+            "NEVER guess field keys — ALWAYS call lighthouse_discovery_get_attributes with type=person first " +
+            "to get the exact filter_id values, then use those in your filter conditions. " +
+            "Common fields: person_name, person_country, person_highlights, person_current_categories.",
+        inputSchema: {
+            filters: z
+                .record(z.unknown())
+                .optional()
+                .describe(DISCOVERY_FILTER_DESCRIPTION),
+            skip: z.number().min(0).default(0).describe("Number of results to skip"),
+            limit: z.number().min(1).max(100).default(25).describe("Results per page"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.post("/database/get-people", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── Reports: Dashboards ─────────────────────────────────
+    const WIDGET_CONFIG_DESCRIPTION = "Widget config object. Structure depends on report_type: " +
+        "STANDARD: {data_source:'companies'|'deals'|'people', report_type:'standard', " +
+        "dimension:{field:'<field_key>', is_custom_field:boolean, time_grouping?:'day'|'week'|'month'|'quarter'|'year'}, " +
+        "measure:{aggregation:'COUNT'|'SUM'|'AVG'|'MIN'|'MAX', field:'*'|'<field_key>', is_custom_field:boolean}, " +
+        "segment_by?:{field:'<field_key>', is_custom_field:boolean}, " +
+        "filter?:{operator:'AND'|'OR', conditions:[...], groups:[...]}, " +
+        "date_range?:{type:'relative', relative_period:'all_time'|'last_7_days'|'last_30_days'|'last_90_days'|'this_month'|'last_month'|'this_quarter'|'last_quarter'|'this_year'|'last_year'} " +
+        "OR {type:'absolute', start_date:'YYYY-MM-DD', end_date:'YYYY-MM-DD'}, " +
+        "included_stages?:['value1','value2'], show_axis_labels?:boolean, show_zeros?:boolean, sort_by_stage_order?:boolean}. " +
+        "FUNNEL: {report_type:'funnel', entity_type:'company'|'deal'|'person', stage_field:'<field_key>', " +
+        "included_stages?:['stage1','stage2'], date_range?:{...}, filter?:{...}}. " +
+        "HISTORICAL: {report_type:'stage_changes', entity_type:'company'|'deal'|'person', " +
+        "field_permalink:'<field_key>', time_grouping?:'day'|'week'|'month'|'quarter'|'year', date_range?:{...}}. " +
+        "ALWAYS call lighthouse_crm_get_attributes first to discover valid field keys for dimension, measure, and stage_field.";
+    server.registerTool("lighthouse_reports_list_dashboards", {
+        title: "List Dashboards",
+        description: "List all report dashboards accessible to the current user. " +
+            "Returns dashboards you own, workspace-shared dashboards, and team-shared dashboards. " +
+            "Each dashboard includes: id, name, description, sharing (private/workspace), is_owner, " +
+            "owner {id, first_name, last_name, full_name}, widget_count, shared_with_teams, created_at, updated_at.",
+        inputSchema: {},
+    }, async () => {
+        try {
+            const res = await api.get("/dashboards");
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_reports_create_dashboard", {
+        title: "Create Dashboard",
+        description: "Create a new report dashboard. Dashboards contain report widgets (charts, tables, KPIs). " +
+            "Requires reports.create permission. Returns the full dashboard object (same format as get dashboard).",
+        inputSchema: {
+            name: z.string().describe("Dashboard name"),
+            description: z.string().optional().describe("Dashboard description"),
+            sharing: z
+                .enum(["private", "workspace"])
+                .default("private")
+                .describe("Visibility: 'private' (only you) or 'workspace' (all members)"),
+            team_ids: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Team IDs to share this dashboard with"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.post("/dashboards", params);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_reports_get_dashboard", {
+        title: "Get Dashboard",
+        description: "Get a single dashboard by ID with all its widgets. " +
+            "Returns: id, name, description, sharing, is_owner, owner {id, first_name, last_name, full_name}, " +
+            "widget_count, shared_with_teams, widgets [{id, name, widget_type, config, created_at, updated_at}], created_at, updated_at.",
+        inputSchema: {
+            id: z.string().uuid().describe("Dashboard ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/dashboards/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_reports_update_dashboard", {
+        title: "Update Dashboard",
+        description: "Update a dashboard's name, description, or sharing. Only the dashboard owner can update. " +
+            "Returns the full dashboard object (same format as get dashboard).",
+        inputSchema: {
+            id: z.string().uuid().describe("Dashboard ID"),
+            name: z.string().optional().describe("New dashboard name"),
+            description: z.string().optional().describe("New description"),
+            sharing: z.enum(["private", "workspace"]).optional().describe("New visibility setting"),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...body } = params;
+            const res = await api.patch(`/dashboards/${id}`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_reports_delete_dashboard", {
+        title: "Delete Dashboard",
+        description: "Permanently delete a dashboard and all its widgets. Only the dashboard owner can delete.",
+        inputSchema: {
+            id: z.string().uuid().describe("Dashboard ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.delete(`/dashboards/${params.id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_reports_refresh_dashboard", {
+        title: "Refresh Dashboard Data",
+        description: "Refresh/fetch report data for all widgets in a dashboard. " +
+            "Returns a map of { widget_id: report_data } for each widget.",
+        inputSchema: {
+            id: z.string().uuid().describe("Dashboard ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.post(`/dashboards/${params.id}/refresh`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── Reports: Widgets ────────────────────────────────────
+    server.registerTool("lighthouse_reports_list_widgets", {
+        title: "List Dashboard Widgets",
+        description: "Get all widgets for a dashboard. " +
+            "Each widget includes: id, name, widget_type, config, created_at, updated_at.",
+        inputSchema: {
+            id: z.string().uuid().describe("Dashboard ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/dashboards/${params.id}/widgets`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_reports_create_widget", {
+        title: "Create Report Widget",
+        description: "Create a report widget (chart/table/KPI) on a dashboard. " +
+            "WORKFLOW: 1) Call lighthouse_crm_get_attributes to discover field keys for the entity type, " +
+            "2) Build a config object using those keys, 3) Create the widget. " +
+            "Widget types: bar, line, pie, table, kpi, funnel, area. " +
+            "Report types: standard (aggregate by field), funnel (pipeline conversion), stage_changes (historical transitions). " +
+            "Returns: {id, name, widget_type, config, created_at, updated_at}.",
+        inputSchema: {
+            dashboard_id: z.string().uuid().describe("Dashboard ID to add widget to"),
+            name: z.string().describe("Widget/report name"),
+            widget_type: z
+                .enum(["bar", "line", "pie", "table", "kpi", "funnel", "area"])
+                .describe("Visualization type"),
+            config: z.record(z.unknown()).describe(WIDGET_CONFIG_DESCRIPTION),
+            position: z
+                .record(z.unknown())
+                .optional()
+                .describe("Grid position: {x: number, y: number, w: number, h: number}"),
+        },
+    }, async (params) => {
+        try {
+            const { dashboard_id, ...body } = params;
+            const res = await api.post(`/dashboards/${dashboard_id}/widgets`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_reports_update_widget", {
+        title: "Update Report Widget",
+        description: "Update a report widget's name, type, config, or position. " +
+            "Only provide fields you want to change — others are preserved. " +
+            "Returns: {id, name, widget_type, config, created_at, updated_at}.",
+        inputSchema: {
+            dashboard_id: z.string().uuid().describe("Dashboard ID"),
+            widget_id: z.string().uuid().describe("Widget ID"),
+            name: z.string().optional().describe("New widget name"),
+            widget_type: z
+                .enum(["bar", "line", "pie", "table", "kpi", "funnel", "area"])
+                .optional()
+                .describe("New visualization type"),
+            config: z.record(z.unknown()).optional().describe(WIDGET_CONFIG_DESCRIPTION),
+            position: z.record(z.unknown()).optional().describe("New grid position: {x, y, w, h}"),
+        },
+    }, async (params) => {
+        try {
+            const { dashboard_id, widget_id, ...body } = params;
+            const res = await api.patch(`/dashboards/${dashboard_id}/widgets/${widget_id}`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_reports_delete_widget", {
+        title: "Delete Report Widget",
+        description: "Permanently delete a report widget from a dashboard.",
+        inputSchema: {
+            dashboard_id: z.string().uuid().describe("Dashboard ID"),
+            widget_id: z.string().uuid().describe("Widget ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.delete(`/dashboards/${params.dashboard_id}/widgets/${params.widget_id}`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_reports_get_widget_data", {
+        title: "Get Widget Report Data",
+        description: "Fetch the aggregated report data for a specific widget. " +
+            "Returns the computed data based on the widget's config (dimensions, measures, segments, filters). " +
+            "For standard reports: array of {dimension, measure, segment?} rows. " +
+            "For funnel reports: array of {stage, count} rows. " +
+            "For historical reports: array of {period, from_stage, to_stage, transition_count} rows.",
+        inputSchema: {
+            dashboard_id: z.string().uuid().describe("Dashboard ID"),
+            widget_id: z.string().uuid().describe("Widget ID"),
+        },
+    }, async (params) => {
+        try {
+            const res = await api.get(`/dashboards/${params.dashboard_id}/widgets/${params.widget_id}/data`);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── Sharing: Dashboard Teams ─────────────────────────────
+    server.registerTool("lighthouse_reports_share_dashboard_with_teams", {
+        title: "Share Dashboard with Teams",
+        description: "Grant team-level access to a dashboard. Only the dashboard owner can share. " +
+            "Use lighthouse_workspace_list_teams to find team IDs first. " +
+            "Requires reports.edit permission.",
+        inputSchema: {
+            id: z.string().uuid().describe("Dashboard ID"),
+            team_ids: z.array(z.string().uuid()).describe("Array of team UUIDs to grant access to"),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...body } = params;
+            const res = await api.post(`/dashboards/${id}/teams`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_reports_revoke_dashboard_from_teams", {
+        title: "Revoke Dashboard Team Access",
+        description: "Revoke team-level access from a dashboard. Only the dashboard owner can revoke. " +
+            "Requires reports.edit permission.",
+        inputSchema: {
+            id: z.string().uuid().describe("Dashboard ID"),
+            team_ids: z.array(z.string().uuid()).describe("Array of team UUIDs to revoke access from"),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...body } = params;
+            const res = await api.delete(`/dashboards/${id}/teams`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── Sharing: View Teams ──────────────────────────────────
+    server.registerTool("lighthouse_crm_share_view_with_teams", {
+        title: "Share View with Teams",
+        description: "Grant team-level access to a CRM view. Only the view owner can share. " +
+            "Use lighthouse_workspace_list_teams to find team IDs first. " +
+            "Requires views.share permission. " +
+            "Returns formatted view: {id, name, entity_type, view_type, filters, sort, grouped_by, sharing, owner, shared_with_teams, created_at}.",
+        inputSchema: {
+            id: z.string().uuid().describe("View ID"),
+            team_ids: z.array(z.string().uuid()).describe("Array of team UUIDs to grant access to"),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...body } = params;
+            const res = await api.post(`/views/${id}/teams`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_revoke_view_from_teams", {
+        title: "Revoke View Team Access",
+        description: "Revoke team-level access from a CRM view. Only the view owner can revoke. " +
+            "Requires views.share permission. " +
+            "Returns formatted view: {id, name, entity_type, view_type, filters, sort, grouped_by, sharing, owner, shared_with_teams, created_at}.",
+        inputSchema: {
+            id: z.string().uuid().describe("View ID"),
+            team_ids: z.array(z.string().uuid()).describe("Array of team UUIDs to revoke access from"),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...body } = params;
+            const res = await api.delete(`/views/${id}/teams`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("lighthouse_crm_update_view_sharing", {
+        title: "Update View Sharing Status",
+        description: "Change a CRM view's sharing visibility. Setting to 'private' also removes all team permissions. " +
+            "Only the view owner can change sharing. Requires views.share permission. " +
+            "Returns formatted view: {id, name, entity_type, view_type, filters, sort, grouped_by, sharing, owner, shared_with_teams, created_at}.",
+        inputSchema: {
+            id: z.string().uuid().describe("View ID"),
+            sharing: z.enum(["private", "workspace"]).describe("New sharing visibility"),
+        },
+    }, async (params) => {
+        try {
+            const { id, ...body } = params;
+            const res = await api.patch(`/views/${id}/sharing`, body);
+            return text(res);
+        }
+        catch (e) {
+            return err(`Failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    return server;
+}