list_sheets
List WorkPaper Sheets
Discover sheet names and used dimensions before reading or editing a WorkPaper. Returns metadata only; use read_range or read_cell for values.
Takes no parameters.

io.github.proomptengPublished by GitHub account proomptengv1.1.0Updated Oct 25, 2026
Formula-backed WorkPaper tools for workbook readback, input edits, and JSON persistence.
A headless WorkPaper runtime that lets an assistant read, edit and recalculate formula-backed workbook cells and export the workbook as JSON.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.proompteng%2Fbilig-workpaper/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"bilig-workpaper": {
"type": "http",
"url": "https://bilig.proompteng.ai/mcp"
}
}
}[CI] [npm] [Node.js] [OpenSSF Scorecard] [License: MIT]
Keep the workbook model. Run the rule in Node.
Bilig is a TypeScript-native, headless WorkPaper runtime for Node.js services, tests, and AI agents. Set inputs, recalculate formulas, read computed outputs, persist WorkPaper JSON, restore it, and verify the result—without driving Excel or a browser grid.
Docs · Quick start · TypeScript API · MCP · Examples · Discussions
[A WorkPaper input edit recalculating a formula, then surviving JSON restore]
[!NOTE] Bilig is a headless workbook runtime, not a visual spreadsheet app or a claim of full Excel compatibility. If an
.xlsxfile is your contract, start with the compatibility report.
Prove the published package before installing it:
The evaluator edits Inputs!B2, recalculates Summary!B2, saves the WorkPaper,
restores it, and compares the restored value:
verified: true means the write, formula readback, JSON export, and restored
readback all passed. It is stronger evidence than a successful write call.
For ordinary operations, use set(), setMany(), readMany(), display(),
and saveJson(). Use editManyAndReadback() when multiple inputs must be
committed and verified as one edit. The complete public API is documented in
packages/workpaper/README.md.
The lifecycle is deliberately small:
inputs → formula recalculation → typed readback → JSON persistence → restore verification
Use Bilig for pricing, quote approval, payouts, forecasts, validation rules, formula-backed workflows, and tests where a service or tool should own the model. Choose a spreadsheet application or hosted spreadsheet API when you need visual editing, collaboration, macros, interactive pivots or charts, or desktop fidelity.
Agents should first ask which system owns state, then run the smallest matching proof. For a tool host or MCP client:
The MCP evaluator proves tool discovery, mutation, recalculated readback, JSON export, disk persistence, process restart, and restored readback. For a local, writable WorkPaper:
Use that local stdio path for private or persistent project state. The hosted
https://bilig.proompteng.ai/mcp endpoint is request-local and only intended
for stateless connector discovery and smoke tests; do not send private workbook
data to it.
The server exposes list_sheets, read_range, read_cell,
set_cell_contents, set_cell_contents_and_readback,
get_cell_display_value, export_workpaper_document, and validate_formula.
It also publishes MCP resources and prompts so capable hosts can discover the
workflow before editing cells.
Machine-readable entry points:
The published package also carries AGENTS.md and SKILL.md, so an agent can
discover the same proof contract from node_modules. Install or inspect the
public skill with either source:
Use the agent rule chooser or the
host handoff prompt.
The repository includes CLAUDE.md,
.claude/skills/bilig-workpaper/SKILL.md,
.claude/commands/bilig-workpaper-proof.md,
.cursor/rules/bilig-workpaper.mdc, .devin/rules/bilig-workpaper.md,
.windsurf/rules/bilig-workpaper.md, .clinerules/bilig-workpaper.md,
.continue/rules/bilig-workpaper.md, .zed/settings.json, opencode.jsonc,
and .opencode/agents/bilig-workpaper.md.
Run an evaluator first, then use the recipe owned by your host:
MCPServerStdio, and MCPServerStreamableHttp.generateText() and streamText() tool loops.@bilig/n8n-nodes-workpaper community node.The workbook-compatibility and xlsx-cache evaluator doors use bundled demo
workbooks to smoke-test the published package; they do not inspect your file.
Do not treat any evaluator as proof of desktop Excel parity.
Start with one maintained example, not the whole monorepo:
examples/headless-workpaper: pricing,
invoice, budget, fulfillment, subscription, persistence, and agent examples.examples/serverless-workpaper-api:
quote approval through Hono, Next.js, and persistence adapters.examples/xlsx-recalculation-node: import,
recalculate, export, reimport, and verify an XLSX workbook.examples/recalc-bridge-workflows: focused
bridges for existing SheetJS, xlsx-populate, and ExcelJS workflows.Useful decision guides:
QUERY and SORTNThe AI SDK generateText() smoke lives at
ai-sdk-generate-text-tool-smoke.ts.
The OpenAI example is documented in
openai-responses-workpaper-tool-call.
For a reduced formula or import bug:
Bilig can import and export workbook files, but cached formula values inside an
.xlsx are diagnostics—not an accuracy oracle. Inspect the file before trusting
it:
The first command is a package smoke test over a bundled demo. The next two inspect the named file. The compatibility report identifies unsupported functions, external links, macros, pivots, volatile formulas, and other risks; it does not certify Excel compatibility. When correctness matters, compare against a workbook freshly recalculated by Excel. See the compatibility limits and Excel oracle walkthrough.
The public WorkPaper package requires Node.js >=24. Local monorepo development uses
Node.js 24+, Bun, and [email protected].
Published releases include npm registry signatures and provenance attestations:
Choose one long-running development server:
Install and validate the repository with:
Architecture lives in docs/architecture.md. Read
CONTRIBUTING.md before opening a pull request; first-time
contributors can start with the new contributor guide
and starter issues. All participation follows the
CODE_OF_CONDUCT.md.
SUPPORT.md for the evidence that makes a report actionable.SECURITY.md for private vulnerability reporting. Never
attach private workbook data, credentials, or tokens to a public issue.If Bilig fits one of your services or agent workflows, star the repository to follow releases and help other Node developers find it. Tell us what proof or formula is still missing.
Source: README.md at commit 49db26b
List WorkPaper Sheets
Discover sheet names and used dimensions before reading or editing a WorkPaper. Returns metadata only; use read_range or read_cell for values.
Takes no parameters.
Read WorkPaper Range
Read calculated values plus serialized formulas/inputs for an A1 range. Use for audit readback after edits; use read_cell for one address.
rangerequiredsheetNameRead WorkPaper Cell
Read one cell with calculated value, display text, formula text, formula diagnostics, and serialized content. Use after set_cell_contents to verify readback.
addressrequiredsheetNamerequiredSet WorkPaper Cell Contents
Write raw content to one cell and recalculate dependents in memory only. Start with --writable when the edit should persist to JSON.
valuerequiredaddressrequiredsheetNamerequiredSet WorkPaper Cell Contents And Read Back
Write raw content to one cell, recalculate dependents, read a dependent range in the same tool call, and return persistence proof. Use this for stateless MCP clients such as hosted Open WebUI integrations.
valuerequiredaddressrequiredsheetNamerequiredreadbackRangerequiredreadbackSheetNameGet WorkPaper Cell Display Value
Return the formatted display string for one cell. Use when an agent needs what a user would see, not the raw numeric value.
addressrequiredsheetNamerequiredExport WorkPaper Document
Export the current WorkPaper JSON document for persistence, review, or handoff to another agent. Does not write files by itself.
includeConfigValidate WorkPaper Formula
Validate formula syntax with the WorkPaper parser before writing it to a cell. This checks syntax only; use set_cell_contents plus readback to evaluate.
formularequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door workpaper-service --json{ "schemaVersion": "bilig-evaluator.v1", "door": "workpaper-service", "evidence": { "editedCell": "Inputs!B2", "dependentCell": "Summary!B2", "before": 24000, "after": 38400, "afterRestore": 38400 }, "verified": true}npm install @bilig/workpaperimport { buildA1WorkPaper } from '@bilig/workpaper'
const pricing = buildA1WorkPaper({ Inputs: [ ['Metric', 'Value'], ['Units', 20], ['Price', 1200], ], Summary: [ ['Metric', 'Value'], ['Revenue', '=Inputs!B2*Inputs!B3'], ],})
const proof = pricing.editAndReadback('Inputs!B2', 32, { readbackRange: 'Summary!B2',})
console.log(proof.afterReadback.displayValues[0]?.[0]) // 38400console.log(proof.verified) // true
pricing.dispose()npm exec --yes --package @bilig/workpaper@latest -- bilig-agent-start --jsonnpm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --jsonnpm exec --yes --package @bilig/workpaper@latest -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writablenpx --yes skills@latest add https://bilig.proompteng.ai --listnpx --yes skills@latest add proompteng/bilig --skill bilig-workpaper --listpnpm --dir examples/headless-workpaper run agent:ai-sdk-generate-textpnpm --dir examples/headless-workpaper run agent:ai-sdk-stream-textpnpm --dir examples/headless-workpaper run agent:openai-responsespnpm --dir examples/headless-workpaper run agent:mcp-xlsx-risk-preflightpnpm --dir examples/serverless-workpaper-api run hono-routepnpm --dir examples/serverless-workpaper-api run next-server-actionpnpm --dir examples/serverless-workpaper-api run next-server-action-formdatanpm exec --yes --package @bilig/workpaper@latest -- bilig-formula-clinic ./reduced.xlsx --cells "Summary!B7,Inputs!B2"npm exec --yes --package @bilig/xlsx-formula-recalc@latest -- bilig-evaluate --door workbook-compatibility --jsonnpm exec --yes --package @bilig/xlsx-formula-recalc@latest -- workbook-compatibility-report workbook.xlsx --jsonnpm exec --yes --package @bilig/xlsx-formula-recalc@latest -- xlsx-cache-doctor workbook.xlsx --jsonnpm view @bilig/workpaper version dist.attestations dist.signatures --jsonnpm audit signaturespnpm dev:webpnpm dev:web-localpnpm installpnpm buildpnpm lintpnpm typecheckpnpm testpnpm run ci