Bilig WorkPaper

WorkPaper MCP server for editing formula workbooks, recalculating cells, and persisting JSON-backed workbook state.

Run workbook-shaped business rules inside Node.

Bilig gives services, queue workers, tests, MCP servers, and tool integrations a typed WorkPaper object: write inputs, recalculate formulas, read outputs, persist JSON, restore, and verify. It fits pricing models, quote approval, payout checks, import validation, forecasts, and formula-backed workflow steps.

Run the no-project service check from any Node project:

npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door workpaper-service --json

{ "schemaVersion": "bilig-evaluator.v1", "door": "workpaper-service", "verified": true, "evidence": { "editedCell": "Inputs!B2", "dependentCell": "Summary!B2", "before": 24000, "after": 38400, "afterRestore": 38400, "persistedDocumentBytes": 999 } }

For TypeScript services that should own the workbook model:

npm create @bilig/workpaper@latest pricing-workpaper cd pricing-workpaper npm install npm run smoke

For MCP clients or other tool integrations, run the same proof loop through the MCP evaluator before adding host-specific config:

npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --json

Evaluator examples live inexamples/bilig-evaluator-proof. Integration matrix docs and host-specific config files are available when a team needs them, but the public proof starts with WorkPaper service readback. File compatibility diagnostics are a separate path for import/export boundaries, not the default runtime story.

Project site:https://proompteng.github.io/bilig/

npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --json

- Runs locally in Node or in your GitHub Actions runner; no hosted workbook upload is required.
- Does not claim Excel parity. Start withwhere Bilig is not Excel-compatible yetbefore using it for irreversible workflows.
- File import/export diagnostics are available when an imported file is the contract, but they are a separate path from service-owned WorkPaper state.

Advanced adapters are still available when the boundary is already specific:SheetJS,ExcelJS,external workbooks,MCP/tool integrations,@bilig/workbookwhen a runtime needs transport-neutral plan data and command receipts, andruntime provenance.

Use theWorkPaper host handoffwhen a tool host needs workbook reads, writes, recalculation, JSON export, and restore proof. The first check is always the no-key MCP evaluator:

npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --json

That evaluator starts the published WorkPaper tool server, discovers tools, edits an input, reads the dependent formula, exports JSON, restarts, restores, and returnsverified: true. Usellms-install.mdwhen a host wants one install file, and use thetool-host evaluator matrixwhen the host matters more than the package boundary.

The published package also carriesAGENTS.mdandSKILL.mdso hosts inspectingnode_modules/@bilig/workpapercan find the same proof locally. Cloned checkouts keep host-specific config indexed inagent rule chooser: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. The public manifest isdocs/.well-known/agent.json.

npx --yes skills@latest add https://bilig.proompteng.ai --list npx --yes skills@latest add proompteng/bilig --skill bilig-workpaper --list

- Open WebUI WorkPaper MCP:https://proompteng.github.io/bilig/open-webui-workpaper-mcp.html.
- OpenAI Agents SDK with direct tools, stdio MCP, orMCPServerStreamableHttp:https://proompteng.github.io/bilig/openai-agents-sdk-workpaper-tool.html.
- ChatGPT Apps WorkPaper MCP:https://proompteng.github.io/bilig/chatgpt-apps-workpaper-mcp.html.
- n8n self-hosted workflows can use the owned community node package:@bilig/n8n-nodes-workpaper.

npm exec --package @bilig/workpaper@latest -- bilig-formula-clinic ./reduced.xlsx --cells "Summary!B7,Inputs!B2"

Handing a workbook task to an MCP client or host integration? Start with the[host handoff guidebefore opening Excel, LibreOffice, Google Sheets, or a screenshot UI. That section keeps the host handoff prompt for clients that require copy-paste instructions. To prove the package-owned MCP loop without cloning the repo:

npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door workpaper-service --json npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --json npm exec --package @bilig/workpaper@latest -- bilig-mcp-challenge --json

…