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.
無需輸入參數。

io.github.proompteng由 GitHub 帳號 proompteng 發布v1.1.0更新於 Oct 25, 2026
Formula-backed WorkPaper tools for workbook readback, input edits, and JSON persistence.
一個無介面的 WorkPaper 執行環境,讓助理讀取、編輯並重算以公式為基礎的工作簿儲存格,並將工作簿匯出為 JSON。
Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.github.proompteng%2Fbilig-workpaper/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"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.
來源:README.md,提交 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.
無需輸入參數。
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.
range必填sheetNameRead 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.
address必填sheetName必填Set 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.
value必填address必填sheetName必填Set 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.
value必填address必填sheetName必填readbackRange必填readbackSheetNameGet 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.
address必填sheetName必填Export 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.
formula必填已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
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