@trylighthouse/mcp-server 0.1.8 → 0.1.10

package/build/server.js

@@ -16,7 +16,7 @@ export function createServer(apiKey) {
     const api = new LighthouseAPI(apiKey);
     const server = new McpServer({
         name: "lighthouse",
-        version: "0.1.7",
+        version: "0.1.10",
     });
     // ─────────────────────────────────────────────────────────
     // FILTER FORMAT REFERENCE (used in tool descriptions)
@@ -112,8 +112,8 @@ export function createServer(apiKey) {
             "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"])
+            record_type: z
+                .enum(["company", "person", "deal", "task"])
                 .describe("Record type to get attributes for"),
         },
     }, async (params) => {
@@ -127,14 +127,14 @@ export function createServer(apiKey) {
     });
     server.registerTool("lighthouse_crm_get_attribute", {
         title: "Get CRM Attribute",
-        description: "Get a single custom field definition by its field_permalink.",
+        description: "Get a single custom field definition. Response returns 'permalink', 'is_custom', 'data_type', 'links_to'.",
         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)"),
+            permalink: z.string().describe("Field permalink (unique key) of the attribute"),
+            record_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}`);
+            const res = await api.get(`/attributes/${params.record_type}/${params.permalink}`);
             return text(res);
         }
         catch (e) {
@@ -147,9 +147,9 @@ export function createServer(apiKey) {
             "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"),
+            record_type: z.enum(["company", "person", "deal"]).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"),
+            links_to: 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()
@@ -168,14 +168,14 @@ export function createServer(apiKey) {
         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)"),
+            permalink: z.string().describe("Field permalink of the attribute to update"),
+            record_type: z.enum(["company", "person", "deal"]).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);
+            const { permalink, record_type, ...body } = params;
+            const res = await api.patch(`/attributes/${record_type}/${permalink}`, body);
             return text(res);
         }
         catch (e) {
@@ -186,12 +186,12 @@ export function createServer(apiKey) {
         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)"),
+            permalink: z.string().describe("Field permalink of the attribute to delete"),
+            record_type: z.enum(["company", "person", "deal"]).describe("Record type (required)"),
         },
     }, async (params) => {
         try {
-            const res = await api.delete(`/attributes/${params.entity_type}/${params.field_permalink}`);
+            const res = await api.delete(`/attributes/${params.record_type}/${params.permalink}`);
             return text(res);
         }
         catch (e) {
@@ -219,12 +219,12 @@ export function createServer(apiKey) {
         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"),
+            record_type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            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}`);
+            const res = await api.get(`/options/${params.record_type}/${params.permalink}`);
             return text(res);
         }
         catch (e) {
@@ -235,15 +235,15 @@ export function createServer(apiKey) {
         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"),
+            record_type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            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);
+            const { record_type, permalink, ...body } = params;
+            const res = await api.post(`/options/${record_type}/${permalink}`, body);
             return text(res);
         }
         catch (e) {
@@ -254,13 +254,13 @@ export function createServer(apiKey) {
         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"),
+            record_type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
+            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}`);
+            const res = await api.delete(`/options/${params.record_type}/${params.permalink}/${params.value}`);
             return text(res);
         }
         catch (e) {
@@ -273,10 +273,10 @@ export function createServer(apiKey) {
         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. " +
+            "for the record_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"),
+            record_type: z.enum(["company", "person", "deal", "task"]).describe("Record type"),
             filters: z
                 .record(z.unknown())
                 .optional()
@@ -295,7 +295,7 @@ export function createServer(apiKey) {
         },
     }, async (params) => {
         try {
-            const res = await api.post(`/records/${params.type}/search`, {
+            const res = await api.post(`/records/${params.record_type}/search`, {
                 filters: params.filters,
                 sort: params.sort,
                 limit: params.limit,
@@ -713,7 +713,7 @@ export function createServer(apiKey) {
             })
                 .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}"),
+            attributes: z.record(z.any()).optional().describe("Custom task field values as {permalink: value}"),
         },
     }, async (params) => {
         try {
@@ -748,7 +748,7 @@ export function createServer(apiKey) {
             })
                 .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}"),
+            attributes: z.record(z.any()).optional().describe("Custom task field values as {permalink: value}"),
         },
     }, async (params) => {
         try {
@@ -781,7 +781,7 @@ export function createServer(apiKey) {
         description: "Get all saved CRM views, or list views scoped to a specific list. " +
             "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"),
+            record_type: z.enum(["company", "person", "deal"]).optional().describe("Filter by record type"),
             list_id: z.string().uuid().optional().describe("Filter views by list ID. When provided, returns only views scoped to that list."),
         },
     }, async (params) => {
@@ -804,7 +804,7 @@ export function createServer(apiKey) {
             "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"),
+            record_type: z.enum(["company", "person", "deal"]).describe("Record type"),
             filters: z
                 .record(z.unknown())
                 .optional()
@@ -814,7 +814,7 @@ export function createServer(apiKey) {
             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."),
-            list_id: z.string().uuid().optional().describe("List ID to scope this view to a specific list. The entity_type must match the list type."),
+            list_id: z.string().uuid().optional().describe("List ID to scope this view to a specific list. The record_type must match the list type."),
         },
     }, async (params) => {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trylighthouse/mcp-server",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "MCP server for the Lighthouse CRM API",
   "type": "module",
   "main": "./build/server.js",