xlsx-for-ai 3.0.11 → 3.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +2 -0
  2. package/mcp.js +41 -41
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # xlsx-for-ai
2
2
 
3
+ *Short name: **xfa** — works in prompts (e.g. "use xfa to read this file") and matches the internal `xfa_*` / `XFA_*` brand surface.*
4
+
3
5
  **The missing reliability layer that makes spreadsheet reasoning production-grade for LLMs.**
4
6
 
5
7
  A thin npm client over a hosted API. Install once, add to your agent config, and your agent gets 50 production-grade tools for reading, writing, diffing, redacting, healing, and cryptographically attesting `.xlsx` files — engine complexity runs server-side, engine IP stays private.
package/mcp.js CHANGED
@@ -31,7 +31,7 @@ const TOOLS = [
31
31
  {
32
32
  name: 'xlsx_read',
33
33
  description:
34
- 'read an .xlsx file by path and return a rendered markdown/JSON/SQL representation.\n\n' +
34
+ 'xfa — read an .xlsx file by path and return a rendered markdown/JSON/SQL representation.\n\n' +
35
35
  'The path resolves on the SERVER\'s filesystem. In a LOCAL-CLI deployment (npx xlsx-for-ai-mcp) the server IS the user\'s machine, so /Users/..., /home/..., or ~-prefixed paths work directly. In a remote/hosted deployment the server runs on a different host — ingest user-provided files via the upload-handle flow first, then use xlsx_read_handle.\n\n' +
36
36
  'DEFAULT returns ALL sheets — do not re-call per-sheet. Pass sheet="<name>" only to filter. format="md" (markdown table, default), "json", or "sql". Synonyms: "markdown"→"md", "text"→"md".\n\n' +
37
37
  'USE WHEN: the user gives a path the SERVER can reach (LOCAL CLI absolute or ~-prefixed; remote: a path on the hosted machine).\n\n' +
@@ -39,7 +39,7 @@ const TOOLS = [
39
39
  inputSchema: {
40
40
  type: 'object',
41
41
  properties: {
42
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
42
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
43
43
  format: {
44
44
  type: 'string',
45
45
  enum: ['md', 'json', 'sql'],
@@ -64,7 +64,7 @@ const TOOLS = [
64
64
  inputSchema: {
65
65
  type: 'object',
66
66
  properties: {
67
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
67
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
68
68
  },
69
69
  required: ['file_path'],
70
70
  },
@@ -80,7 +80,7 @@ const TOOLS = [
80
80
  inputSchema: {
81
81
  type: 'object',
82
82
  properties: {
83
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
83
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
84
84
  sheet: { type: 'string', description: 'Limit to one sheet (default: all).' },
85
85
  },
86
86
  required: ['file_path'],
@@ -97,8 +97,8 @@ const TOOLS = [
97
97
  inputSchema: {
98
98
  type: 'object',
99
99
  properties: {
100
- file_path_a: { type: 'string', description: 'Path to the base .xlsx file.' },
101
- file_path_b: { type: 'string', description: 'Path to the changed .xlsx file.' },
100
+ file_path_a: { type: 'string', description: 'Absolute path to the base .xlsx file. Pass the path string AS-IS — do NOT base64-encode the file; the client reads it.' },
101
+ file_path_b: { type: 'string', description: 'Absolute path to the changed .xlsx file. Pass the path string AS-IS — do NOT base64-encode the file; the client reads it.' },
102
102
  sheet: { type: 'string', description: 'Limit diff to one sheet (default: all).' },
103
103
  },
104
104
  required: ['file_path_a', 'file_path_b'],
@@ -181,7 +181,7 @@ const TOOLS = [
181
181
  },
182
182
  spec_path: {
183
183
  type: 'string',
184
- description: 'Path to a .json file carrying the spec (alternative to inline spec for large workbooks).',
184
+ description: 'Absolute path to a .json file carrying the spec (alternative to inline spec for large workbooks). Pass the path string AS-IS — do NOT base64-encode; the client reads it.',
185
185
  },
186
186
  out_path: {
187
187
  type: 'string',
@@ -189,7 +189,7 @@ const TOOLS = [
189
189
  },
190
190
  base_file_b64: {
191
191
  type: 'string',
192
- description: 'Optional base64 of an existing .xlsx to edit-in-place. When omitted, a fresh workbook is created.',
192
+ description: 'NARROW EXCEPTION — xlsx_write ONLY accepts a base64-encoded base workbook here for edit-in-place. Every OTHER tool in this connector takes a file PATH (`file_path`), not bytes. When omitted, a fresh workbook is created.',
193
193
  },
194
194
  },
195
195
  // out_path is the typical caller's choice but not strictly required —
@@ -212,7 +212,7 @@ const TOOLS = [
212
212
  inputSchema: {
213
213
  type: 'object',
214
214
  properties: {
215
- file_path: { type: 'string', description: 'Absolute path to the source .xlsx file.' },
215
+ file_path: { type: 'string', description: 'Absolute path to the source .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O.' },
216
216
  out_path: { type: 'string', description: 'Destination for the redacted .xlsx file.' },
217
217
  },
218
218
  required: ['file_path', 'out_path'],
@@ -238,7 +238,7 @@ const TOOLS = [
238
238
  inputSchema: {
239
239
  type: 'object',
240
240
  properties: {
241
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
241
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
242
242
  sheet: { type: 'string', description: 'Sheet name (default: first sheet).' },
243
243
  header_row: { type: 'integer', description: 'Header row (1-based). 0 = treat row 1 as data, no header.' },
244
244
  max_rows: { type: 'integer', description: 'Max data rows to scan (default 10000).' },
@@ -258,7 +258,7 @@ const TOOLS = [
258
258
  inputSchema: {
259
259
  type: 'object',
260
260
  properties: {
261
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
261
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
262
262
  predicates: {
263
263
  type: 'array',
264
264
  minItems: 1,
@@ -292,7 +292,7 @@ const TOOLS = [
292
292
  inputSchema: {
293
293
  type: 'object',
294
294
  properties: {
295
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
295
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
296
296
  group_by: { type: 'array', items: { type: 'string' }, minItems: 1, description: 'Columns to group by.' },
297
297
  aggs: {
298
298
  type: 'array',
@@ -328,7 +328,7 @@ const TOOLS = [
328
328
  inputSchema: {
329
329
  type: 'object',
330
330
  properties: {
331
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
331
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
332
332
  },
333
333
  required: ['file_path'],
334
334
  },
@@ -344,7 +344,7 @@ const TOOLS = [
344
344
  inputSchema: {
345
345
  type: 'object',
346
346
  properties: {
347
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
347
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
348
348
  by: {
349
349
  type: 'array',
350
350
  minItems: 1,
@@ -376,7 +376,7 @@ const TOOLS = [
376
376
  inputSchema: {
377
377
  type: 'object',
378
378
  properties: {
379
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
379
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
380
380
  column: { type: 'string', description: 'Column to count values in.' },
381
381
  sheet: { type: 'string' },
382
382
  header_row: { type: 'integer' },
@@ -398,7 +398,7 @@ const TOOLS = [
398
398
  inputSchema: {
399
399
  type: 'object',
400
400
  properties: {
401
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
401
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
402
402
  sheet: { type: 'string', description: 'Filter to one sheet (default: all sheets).' },
403
403
  include_results: { type: 'boolean', description: 'Include cached results column (default true).' },
404
404
  limit: { type: 'integer', description: 'Max formulas to return (default 1000, max 5000).' },
@@ -418,7 +418,7 @@ const TOOLS = [
418
418
  inputSchema: {
419
419
  type: 'object',
420
420
  properties: {
421
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
421
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
422
422
  sheet: { type: 'string', description: 'Filter to one sheet (default: all sheets).' },
423
423
  include_columns: { type: 'boolean', description: 'Include column names per table (default true).' },
424
424
  },
@@ -436,7 +436,7 @@ const TOOLS = [
436
436
  inputSchema: {
437
437
  type: 'object',
438
438
  properties: {
439
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
439
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
440
440
  index: { type: 'array', items: { type: 'string' }, minItems: 1, description: 'Row-axis grouping columns.' },
441
441
  columns: { type: 'array', items: { type: 'string' }, description: 'Column-axis grouping columns (optional).' },
442
442
  values: { type: 'array', items: { type: 'string' }, minItems: 1, description: 'Columns to aggregate.' },
@@ -460,7 +460,7 @@ const TOOLS = [
460
460
  inputSchema: {
461
461
  type: 'object',
462
462
  properties: {
463
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
463
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
464
464
  formulas: {
465
465
  type: 'array',
466
466
  items: { type: 'string' },
@@ -488,7 +488,7 @@ const TOOLS = [
488
488
  inputSchema: {
489
489
  type: 'object',
490
490
  properties: {
491
- file_path: { type: 'string', description: 'Absolute path to the source spreadsheet file (any supported format).' },
491
+ file_path: { type: 'string', description: 'Absolute path to the source spreadsheet file (any supported format). Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O.' },
492
492
  to: {
493
493
  type: 'string',
494
494
  enum: [
@@ -516,7 +516,7 @@ const TOOLS = [
516
516
  inputSchema: {
517
517
  type: 'object',
518
518
  properties: {
519
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
519
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
520
520
  mode: {
521
521
  type: 'string',
522
522
  enum: ['diagnose', 'execute'],
@@ -577,7 +577,7 @@ const TOOLS = [
577
577
  inputSchema: {
578
578
  type: 'object',
579
579
  properties: {
580
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
580
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
581
581
  },
582
582
  required: ['file_path'],
583
583
  },
@@ -594,7 +594,7 @@ const TOOLS = [
594
594
  inputSchema: {
595
595
  type: 'object',
596
596
  properties: {
597
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
597
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
598
598
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
599
599
  },
600
600
  required: ['file_path'],
@@ -612,7 +612,7 @@ const TOOLS = [
612
612
  inputSchema: {
613
613
  type: 'object',
614
614
  properties: {
615
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
615
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
616
616
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
617
617
  },
618
618
  required: ['file_path'],
@@ -630,7 +630,7 @@ const TOOLS = [
630
630
  inputSchema: {
631
631
  type: 'object',
632
632
  properties: {
633
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
633
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
634
634
  },
635
635
  required: ['file_path'],
636
636
  },
@@ -647,7 +647,7 @@ const TOOLS = [
647
647
  inputSchema: {
648
648
  type: 'object',
649
649
  properties: {
650
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
650
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
651
651
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
652
652
  },
653
653
  required: ['file_path'],
@@ -665,7 +665,7 @@ const TOOLS = [
665
665
  inputSchema: {
666
666
  type: 'object',
667
667
  properties: {
668
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
668
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
669
669
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
670
670
  },
671
671
  required: ['file_path'],
@@ -682,7 +682,7 @@ const TOOLS = [
682
682
  inputSchema: {
683
683
  type: 'object',
684
684
  properties: {
685
- file_path: { type: 'string', description: 'Absolute path to the .xlsx / .xlsm file.' },
685
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx / .xlsm file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O.' },
686
686
  },
687
687
  required: ['file_path'],
688
688
  },
@@ -699,7 +699,7 @@ const TOOLS = [
699
699
  inputSchema: {
700
700
  type: 'object',
701
701
  properties: {
702
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
702
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
703
703
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
704
704
  },
705
705
  required: ['file_path'],
@@ -716,7 +716,7 @@ const TOOLS = [
716
716
  inputSchema: {
717
717
  type: 'object',
718
718
  properties: {
719
- file_path: { type: 'string', description: 'Absolute path to the .xlsx / .xlsm / .xlsb file.' },
719
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx / .xlsm / .xlsb file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O.' },
720
720
  },
721
721
  required: ['file_path'],
722
722
  },
@@ -733,7 +733,7 @@ const TOOLS = [
733
733
  inputSchema: {
734
734
  type: 'object',
735
735
  properties: {
736
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
736
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
737
737
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
738
738
  },
739
739
  required: ['file_path'],
@@ -750,7 +750,7 @@ const TOOLS = [
750
750
  inputSchema: {
751
751
  type: 'object',
752
752
  properties: {
753
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
753
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
754
754
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
755
755
  },
756
756
  required: ['file_path'],
@@ -768,7 +768,7 @@ const TOOLS = [
768
768
  inputSchema: {
769
769
  type: 'object',
770
770
  properties: {
771
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
771
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
772
772
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
773
773
  },
774
774
  required: ['file_path'],
@@ -785,7 +785,7 @@ const TOOLS = [
785
785
  inputSchema: {
786
786
  type: 'object',
787
787
  properties: {
788
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
788
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
789
789
  },
790
790
  required: ['file_path'],
791
791
  },
@@ -802,7 +802,7 @@ const TOOLS = [
802
802
  inputSchema: {
803
803
  type: 'object',
804
804
  properties: {
805
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
805
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
806
806
  },
807
807
  required: ['file_path'],
808
808
  },
@@ -818,7 +818,7 @@ const TOOLS = [
818
818
  inputSchema: {
819
819
  type: 'object',
820
820
  properties: {
821
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
821
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
822
822
  },
823
823
  required: ['file_path'],
824
824
  },
@@ -834,7 +834,7 @@ const TOOLS = [
834
834
  inputSchema: {
835
835
  type: 'object',
836
836
  properties: {
837
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
837
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
838
838
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
839
839
  },
840
840
  required: ['file_path'],
@@ -851,7 +851,7 @@ const TOOLS = [
851
851
  inputSchema: {
852
852
  type: 'object',
853
853
  properties: {
854
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
854
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
855
855
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
856
856
  },
857
857
  required: ['file_path'],
@@ -868,7 +868,7 @@ const TOOLS = [
868
868
  inputSchema: {
869
869
  type: 'object',
870
870
  properties: {
871
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
871
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
872
872
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
873
873
  },
874
874
  required: ['file_path'],
@@ -885,7 +885,7 @@ const TOOLS = [
885
885
  inputSchema: {
886
886
  type: 'object',
887
887
  properties: {
888
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
888
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
889
889
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
890
890
  },
891
891
  required: ['file_path'],
@@ -903,7 +903,7 @@ const TOOLS = [
903
903
  inputSchema: {
904
904
  type: 'object',
905
905
  properties: {
906
- file_path: { type: 'string', description: 'Absolute path to the .xlsx file.' },
906
+ file_path: { type: 'string', description: 'Absolute path to the .xlsx file. Pass the path string AS-IS — do NOT read, open, or base64-encode the file; the client handles all file I/O. The base64 surface in this connector is OUTPUT-only (_meta.file_b64).' },
907
907
  sheet: { type: 'string', description: 'Optional: restrict to a specific sheet.' },
908
908
  detailed: { type: 'boolean', description: 'If true, return per-cell breakdown (capped at 1000 cells). Default false (per-sheet rollup).' },
909
909
  },
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "xlsx-for-ai",
3
3
  "mcpName": "io.github.senoff/xlsx-for-ai",
4
- "version": "3.0.11",
4
+ "version": "3.0.15",
5
5
  "description": "The MCP server that makes LLMs reliable on real-world Excel spreadsheets. Thin npm client over a hosted API — read, write, diff, redact, and supervise .xlsx files from any MCP-aware agent.",
6
6
  "main": "index.js",
7
7
  "bin": {