Repository Public Research preview
1{2 "schemaVersion": "1.0",3 "name": "@spboucher/xlsx-audit-mcp",4 "version": "1.0.1",5 "type": "mcp-server",6 "description": "MCP server that audits Excel workbooks without Excel: errors, hard-coded numbers, broken formula patterns, circular references, controls, stale values, comparison with a reference and a rubric-based grading aid. Read-only, dependency-free reader.",7 "license": "MIT",8 "keywords": [9 "excel",10 "xlsx",11 "spreadsheet",12 "audit",13 "formulas",14 "financial-model",15 "grading",16 "mcp",17 "data-quality"18 ],19 "compatibility": [20 {21 "client": "claude-code",22 "platform": "any"23 },24 {25 "client": "codex",26 "platform": "any"27 },28 {29 "client": "cursor",30 "platform": "any"31 },32 {33 "client": "generic-mcp",34 "platform": "any"35 }36 ],37 "permissions": [38 "filesystem:read",39 "filesystem:write"40 ],41 "mcp": {42 "transport": "stdio",43 "command": "node",44 "args": [45 "server.mjs"46 ],47 "env": [48 {49 "name": "XLSX_AUDIT_ROOT",50 "description": "Only directory the server may read workbooks from and write reports to (default: working directory).",51 "required": false,52 "secret": false53 },54 {55 "name": "XLSX_AUDIT_MAX_FILE_MB",56 "description": "Largest workbook file accepted, in megabytes (default 50).",57 "required": false,58 "secret": false59 },60 {61 "name": "XLSX_AUDIT_MAX_UNZIPPED_MB",62 "description": "Cap on decompressed size, per part and in total, in megabytes (default 128 per part, 384 in total).",63 "required": false,64 "secret": false65 },66 {67 "name": "XLSX_AUDIT_MAX_CELLS",68 "description": "Largest number of non-empty cells loaded from one workbook (default 2000000).",69 "required": false,70 "secret": false71 }72 ],73 "tools": [74 {75 "name": "workbook_summary",76 "description": "Sheets, used ranges, formula and error counts, names, functions used, share of formulas outside the evaluated subset."77 },78 {79 "name": "read_range",80 "description": "Read cells page by page: value, type, formula, number format, value source."81 },82 {83 "name": "list_formulas",84 "description": "Formulas with R1C1 pattern, precedents and dependents counts; or grouped by pattern."85 },86 {87 "name": "find_errors",88 "description": "Error cells and broken references, root causes separated from propagated errors."89 },90 {91 "name": "find_hardcoded",92 "description": "Numeric constants inside formulas and typed numbers where a formula is expected."93 },94 {95 "name": "formula_consistency",96 "description": "Cells breaking the formula pattern of their row or column, with the expected formula."97 },98 {99 "name": "find_circular",100 "description": "Circular references across sheets, each loop printed cell by cell."101 },102 {103 "name": "trace_precedents",104 "description": "Where a number comes from, level by level and across sheets."105 },106 {107 "name": "trace_dependents",108 "description": "What a cell feeds, level by level and across sheets."109 },110 {111 "name": "check_controls",112 "description": "Read the model's own controls: failing, typed, and the overall check cell."113 },114 {115 "name": "recalc_check",116 "description": "Recompute the supported subset and compare with stored values; states what could not be recomputed."117 },118 {119 "name": "compare_workbooks",120 "description": "Submission against reference: right by formula, typed constant, wrong, missing; structural differences."121 },122 {123 "name": "grade_submission",124 "description": "Rubric-based grading evidence with partial and carried-forward credit. An aid: a human decides."125 },126 {127 "name": "export_report",128 "description": "Full audit as Markdown or JSON, inline or written to a new file that never overwrites."129 }130 ]131 },132 "examples": [133 {134 "title": "Audit a workbook with planted defects (Claude Code)",135 "client": "claude-code",136 "image": "examples/claude-code.png",137 "alt": "Terminal screenshot of a Claude Code session using xlsx-audit-mcp: the prompt, the tool or script calls, and the agent's answer.",138 "prompt": "Audit defects.xlsx with the xlsx-audit MCP tools: summary, error cells with root causes, hard-coded constants inside formulas, and formulas that break the pattern of their row or column. Give cell references. At most 16 lines.",139 "caption": "Error cells with root causes, constants buried in formulas, an overwritten formula and a broken row pattern, each with its cell reference. Real session, Claude Code 2.1.322 with Fable 5.2, with version 1.0.0 installed from this registry; inputs are test fixtures.",140 "capturedAt": "2026-11-10"141 },142 {143 "title": "Audit a workbook with planted defects (Codex)",144 "client": "codex",145 "image": "examples/codex.png",146 "alt": "Terminal screenshot of a Codex session using xlsx-audit-mcp: the prompt, the tool or script calls, and the agent's answer.",147 "prompt": "Audit defects.xlsx with the xlsx-audit MCP tools: summary, error cells with root causes, hard-coded constants inside formulas, and formulas that break the pattern of their row or column. Give cell references. At most 16 lines.",148 "caption": "Error cells with root causes, constants buried in formulas, an overwritten formula and a broken row pattern, each with its cell reference. Real session, Codex CLI 0.167.1 with GPT-6.1-Sol, with version 1.0.0 installed from this registry; inputs are test fixtures.",149 "capturedAt": "2026-11-10"150 }151 ]152}153