docs: add AI-facing input hints to server instructions and tool descriptions

- Server instructions: document checkbox/multiselect auto-normalization
  and multiselect comma limitation
- gf_create_entry/gf_update_entry descriptions mention auto-normalization
- gf_list_field_types summary mode includes entry_input hints for
  checkbox, multiselect, list, name, address, consent, chainedselect

Author: zackkatz

src/field-operations/index.js

@@ -177,12 +177,23 @@ export const fieldOperationHandlers = {
           validation: def.validation
         }));
       } else {
-        // Summary mode (default) — minimal tokens
-        fieldTypes = entries.map(([type, def]) => ({
-          type,
-          label: def.label,
-          category: def.category
-        }));
+        // Summary mode (default) — minimal tokens, with entry input hints
+        const inputHints = {
+          checkbox: 'array: ["val1","val2"] — auto-matched to sub-inputs',
+          multiselect: 'array: ["val1","val2"] — commas in values get split',
+          select: 'string: "value"',
+          radio: 'string: "value"',
+          list: 'array: ["a","b"] or [{Col1:"a",Col2:"b"}] for multi-col',
+          name: 'dot-notation: {"1.3":"First","1.6":"Last"}',
+          address: 'dot-notation: {"2.1":"Street","2.3":"City","2.4":"State","2.5":"ZIP"}',
+          consent: 'dot-notation: {"5.1":"1","5.2":"text","5.3":"revision"}',
+          chainedselect: 'dot-notation: {"1.1":"Level1","1.2":"Level2"}',
+        };
+        fieldTypes = entries.map(([type, def]) => {
+          const entry = { type, label: def.label, category: def.category };
+          if (inputHints[type]) entry.entry_input = inputHints[type];
+          return entry;
+        });
       }
 
       return {

src/index.js

@@ -42,7 +42,7 @@ const server = new Server(
     capabilities: {
       tools: {}
     },
-    instructions: 'GravityKit MCP server for Gravity Forms. All responses strip null and empty values by default for minimal token usage. Pass compact=false on any tool to get full raw data. Entry tools also strip plugin-added meta keys; use compact=false to include them.'
+    instructions: 'GravityKit MCP server for Gravity Forms. Checkbox/multiselect arrays auto-normalized: pass ["val1","val2"] and values are matched to correct sub-inputs. Text labels also work. Multiselect limitation: values containing commas get split by GF REST API. Responses strip null/empty by default; pass compact=false for full raw data.'
   }
 );
 
@@ -327,7 +327,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'gf_create_entry',
-        description: 'Create an entry',
+        description: 'Create an entry. Checkbox/multiselect arrays auto-normalized.',
         annotations: { idempotentHint: false, openWorldHint: true },
         inputSchema: {
           type: 'object',
@@ -347,7 +347,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'gf_update_entry',
-        description: 'Update an entry',
+        description: 'Update an entry. Checkbox/multiselect arrays auto-normalized; unmentioned fields preserved.',
         annotations: { idempotentHint: false, openWorldHint: true },
         inputSchema: {
           type: 'object',