feat(mcp): add delete_fields bulk tool with checkpoint support

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: ARHAEEM

packages/mcp-server/src/index.js

@@ -682,6 +682,39 @@ REPLACING ALL CHOICES: just pass the new choices without any IDs.`,
       required: ['appId', 'fieldId', 'expectedName'],
     },
   },
+  {
+    name: 'delete_fields',
+    description: 'Delete multiple fields from an Airtable table in a single call. Each entry requires fieldId and expectedName as a safety guard (deletion is refused if names do not match). Fields are processed sequentially and all are attempted even if some fail — partial results are always returned. Optionally writes a JSON checkpoint file after each deletion so the batch can be resumed if interrupted.',
+    annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        appId: { type: 'string', description: 'The Airtable base/application ID' },
+        fields: {
+          type: 'array',
+          description: 'Fields to delete. Each entry must have fieldId and expectedName.',
+          items: {
+            type: 'object',
+            properties: {
+              fieldId:      { type: 'string', description: 'Field/column ID (e.g. "fldXXX")' },
+              expectedName: { type: 'string', description: 'Expected name — deletion is refused if it does not match' },
+            },
+            required: ['fieldId', 'expectedName'],
+          },
+        },
+        force: {
+          type: 'boolean',
+          description: 'When true, delete each field even if it has downstream formula/rollup dependencies. Default: false.',
+        },
+        checkpointFile: {
+          type: 'string',
+          description: 'Absolute path to a JSON file updated after each deletion. Stores remaining fields so the batch can be resumed after a crash.',
+        },
+        debug: debugProp,
+      },
+      required: ['appId', 'fields'],
+    },
+  },
 
   // ── View Tools ──
   {
@@ -1805,6 +1838,43 @@ const handlers = {
     return ok(result, result, debug);
   },
 
+  async delete_fields({ appId, fields, force, checkpointFile, debug }) {
+    if (!Array.isArray(fields) || fields.length === 0) {
+      return err('fields must be a non-empty array of { fieldId, expectedName } objects');
+    }
+
+    const checkpointPath = typeof checkpointFile === 'string' && checkpointFile ? checkpointFile : null;
+
+    const result = await client.deleteFields(appId, fields, {
+      force: !!force,
+      onProgress: checkpointPath
+        ? async ({ index, total, succeeded, failed }) => {
+            const checkpoint = {
+              appId,
+              processedUpTo: index,
+              total,
+              remaining: fields.slice(index + 1),
+              succeededCount: succeeded,
+              failedCount: failed,
+              savedAt: new Date().toISOString(),
+            };
+            await writeFile(checkpointPath, JSON.stringify(checkpoint, null, 2)).catch(() => {});
+          }
+        : undefined,
+    });
+
+    return ok(
+      {
+        succeeded: result.succeeded.length,
+        failed:    result.failed.length,
+        total:     fields.length,
+        ...(result.failed.length > 0 ? { failures: result.failed } : {}),
+      },
+      result,
+      debug,
+    );
+  },
+
   // ── View Mutations ──
 
   async create_view({ appId, tableId, name, type, copyFromViewId, debug }) {

packages/mcp-server/src/tool-config.js

@@ -56,6 +56,7 @@ export const TOOL_CATEGORIES = {
 
   // Field destructive
   delete_field:           'field-destructive',
+  delete_fields:          'field-destructive',
 
   // View mutations (non-destructive)
   create_view:            'view-write',

packages/mcp-server/test/test-tool-config.test.js

@@ -17,7 +17,7 @@ import {
 describe('TOOL_CATEGORIES', () => {
   it('maps all tools to valid categories', () => {
     const tools = Object.keys(TOOL_CATEGORIES);
-    assert.equal(tools.length, 63, `Expected 63 tools, got ${tools.length}`);
+    assert.equal(tools.length, 64, `Expected 64 tools, got ${tools.length}`);
     for (const [tool, cat] of Object.entries(TOOL_CATEGORIES)) {
       assert.ok(CATEGORY_LABELS[cat], `Tool "${tool}" has unknown category "${cat}"`);
     }
@@ -83,9 +83,9 @@ describe('ToolConfigManager', () => {
       assert.equal(mgr.activeProfile, 'full');
     });
 
-    it('enables all 63 tools on full profile', () => {
+    it('enables all 64 tools on full profile', () => {
       const enabled = mgr.enabledToolNames();
-      assert.equal(enabled.size, 63);
+      assert.equal(enabled.size, 64);
     });
 
     it('manage_tools is always enabled', () => {
@@ -121,10 +121,10 @@ describe('ToolConfigManager', () => {
       assert.ok(!enabled.has('create_extension'));
     });
 
-    it('full enables all 63 tools', async () => {
+    it('full enables all 64 tools', async () => {
       await mgr.switchProfile('full');
       const enabled = mgr.enabledToolNames();
-      assert.equal(enabled.size, 63);
+      assert.equal(enabled.size, 64);
     });
   });
 
@@ -194,10 +194,10 @@ describe('ToolConfigManager', () => {
   });
 
   describe('getToolStatus()', () => {
-    it('returns status for all 63 tools', async () => {
+    it('returns status for all 64 tools', async () => {
       await mgr.switchProfile('full');
       const status = mgr.getToolStatus();
-      assert.equal(status.length, 63);
+      assert.equal(status.length, 64);
       assert.ok(status.every(s => s.enabled === true));
     });