@trylighthouse/mcp-server 0.1.1 → 0.1.2

package/build/index.js

@@ -126,7 +126,7 @@ server.registerTool("lighthouse_crm_get_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"]).describe("Record type (required)"),
+        entity_type: z.enum(["company", "person", "deal", "task"]).describe("Record type (required)"),
     },
 }, async (params) => {
     try {
@@ -143,9 +143,9 @@ server.registerTool("lighthouse_crm_create_attribute", {
         "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"]).describe("Record type this field belongs to"),
+        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"]).optional().describe("For record/multi_record fields: which record type to link to"),
+        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()
@@ -165,7 +165,7 @@ server.registerTool("lighthouse_crm_update_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"]).describe("Record type (required)"),
+        entity_type: z.enum(["company", "person", "deal", "task"]).describe("Record type (required)"),
         label: z.string().optional().describe("New display label"),
     },
 }, async (params) => {
@@ -183,7 +183,7 @@ server.registerTool("lighthouse_crm_delete_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"]).describe("Record type (required)"),
+        entity_type: z.enum(["company", "person", "deal", "task"]).describe("Record type (required)"),
     },
 }, async (params) => {
     try {
@@ -215,7 +215,7 @@ server.registerTool("lighthouse_crm_list_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"]).describe("Record type"),
+        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) => {
@@ -231,7 +231,7 @@ 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"]).describe("Record type"),
+        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)"),
@@ -250,7 +250,7 @@ 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"]).describe("Record type"),
+        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"),
     },
@@ -272,7 +272,7 @@ server.registerTool("lighthouse_crm_search_records", {
         "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"]).describe("Record type"),
+        type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
         filters: z
             .record(z.unknown())
             .optional()
@@ -308,7 +308,7 @@ 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"]).describe("Record type"),
+        type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
         id: z.string().uuid().describe("Record ID"),
     },
 }, async (params) => {
@@ -325,7 +325,7 @@ server.registerTool("lighthouse_crm_create_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"]).describe("Record type"),
+        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())
@@ -348,7 +348,7 @@ 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"]).describe("Record type"),
+        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)"),
@@ -369,7 +369,7 @@ server.registerTool("lighthouse_crm_delete_record", {
     title: "Delete CRM Record",
     description: "Permanently delete a CRM record.",
     inputSchema: {
-        type: z.enum(["company", "person", "deal"]).describe("Record type"),
+        type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
         id: z.string().uuid().describe("Record ID"),
     },
 }, async (params) => {
@@ -387,7 +387,9 @@ server.registerTool("lighthouse_crm_create_list", {
     description: "Create a new CRM list to organize records.",
     inputSchema: {
         name: z.string().describe("List name"),
-        type: z.enum(["company", "person", "deal"]).describe("Record type for this list"),
+        type: z.enum(["company", "person", "deal", "task"]).describe("Record type for this list"),
+        sharing: z.enum(["private", "workspace"]).default("private").optional().describe("Visibility: 'private' or 'workspace'"),
+        color: z.string().optional().describe("Hex color code for the list"),
     },
 }, async (params) => {
     try {
@@ -432,6 +434,8 @@ server.registerTool("lighthouse_crm_update_list", {
     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 {
@@ -486,7 +490,7 @@ server.registerTool("lighthouse_crm_add_to_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"),
+        type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
     },
 }, async (params) => {
     try {
@@ -521,8 +525,8 @@ 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 (optional — omit to list all notes)"),
-        record_type: z.enum(["company", "person", "deal"]).optional().describe("Record type (required if record_id is provided)"),
+        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),
     },
@@ -547,7 +551,7 @@ server.registerTool("lighthouse_crm_create_note", {
         "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"]).describe("Record type"),
+        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
@@ -746,7 +750,7 @@ 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"),
+        entity_type: z.enum(["company", "person", "deal", "task"]).optional().describe("Filter by record type"),
     },
 }, async (params) => {
     try {
@@ -767,7 +771,7 @@ server.registerTool("lighthouse_crm_create_view", {
         "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"),
+        entity_type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
         filters: z
             .record(z.unknown())
             .optional()
@@ -1012,7 +1016,9 @@ const WIDGET_CONFIG_DESCRIPTION = "Widget config object. Structure depends on re
 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.",
+        "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 {
@@ -1026,7 +1032,7 @@ server.registerTool("lighthouse_reports_list_dashboards", {
 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.",
+        "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"),
@@ -1050,7 +1056,9 @@ server.registerTool("lighthouse_reports_create_dashboard", {
 });
 server.registerTool("lighthouse_reports_get_dashboard", {
     title: "Get Dashboard",
-    description: "Get a single dashboard by ID with all its widgets.",
+    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"),
     },
@@ -1065,7 +1073,8 @@ server.registerTool("lighthouse_reports_get_dashboard", {
 });
 server.registerTool("lighthouse_reports_update_dashboard", {
     title: "Update Dashboard",
-    description: "Update a dashboard's name, description, or sharing. Only the dashboard owner can update.",
+    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"),
@@ -1116,7 +1125,8 @@ server.registerTool("lighthouse_reports_refresh_dashboard", {
 // ─── Reports: Widgets ────────────────────────────────────
 server.registerTool("lighthouse_reports_list_widgets", {
     title: "List Dashboard Widgets",
-    description: "Get all widgets for a dashboard.",
+    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"),
     },
@@ -1135,7 +1145,8 @@ server.registerTool("lighthouse_reports_create_widget", {
         "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).",
+        "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"),
@@ -1161,7 +1172,8 @@ server.registerTool("lighthouse_reports_create_widget", {
 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.",
+        "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"),
@@ -1262,7 +1274,8 @@ 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.",
+        "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"),
@@ -1280,7 +1293,8 @@ server.registerTool("lighthouse_crm_share_view_with_teams", {
 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.",
+        "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"),
@@ -1298,7 +1312,8 @@ server.registerTool("lighthouse_crm_revoke_view_from_teams", {
 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.",
+        "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"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trylighthouse/mcp-server",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MCP server for the Lighthouse CRM API",
   "type": "module",
   "bin": {