Bilig WorkPaper is the MCP server for @bilig/headless. It gives coding agents
and local MCP clients a formula-backed workbook surface: read a summary, change
an input cell, recalculate formulas, and return the before/after values instead
of a screenshot.
Use this page when you are checking whether a directory listing points to the real package, or when you want the shortest install command for Claude Desktop, Cursor, VS Code, Codex, or another stdio MCP client.
npm exec --package @bilig/headless -- bilig-workpaper-mcp
Package metadata:
io.github.proompteng/bilig-workpaperThe server is local-first stdio. It does not need a hosted Bilig account or a
network service to answer tools/list and tools/call.
PulseMCP says server listings are ingested from the official MCP Registry daily
and processed weekly. The Bilig WorkPaper registry entry is already live for
the current @bilig/headless package line, so PulseMCP absence is a directory-ingest delay, not a
missing package or server metadata problem. Starter issue
#384 tracks the next public
verification pass.
The mcpserver.cc submission was accepted for review on May 13, 2026 with
submission UUID bcdce4e1-3b05-4be2-b611-2a2abb8baf79. Search still returned no
published Bilig result immediately after submission, so treat that directory as
pending until the listing appears.
The AgentNDX submission was accepted for review on May 13, 2026 through the
public submit endpoint with the GitHub repository, homepage, MCP protocol, and
WorkPaper MCP description. AgentNDX search returned 0 Bilig results before
submission, so treat it as pending until the reviewed listing appears.
The YuzeHao2023 Awesome-MCP-Servers pull request was opened on May 13, 2026 with a Development Tools entry for the Bilig WorkPaper MCP server. Treat it as pending until the maintainer merges the pull request.
The ToolSDK MCP Registry pull request was opened on May 13, 2026 with a
Developer Tools package entry for @bilig/headless and the
bilig-workpaper-mcp stdio binary. Biome passed on the pull request; the
integration job failed before package validation because the base workflow used
latest pnpm on Node.js 20 and hit node:sqlite before reading the Bilig entry.
The Ever Works awesome-mcp-servers-data pull request was opened on May 13, 2026 with source data for the generated mcpserver.works / Awesome MCP Servers directory. GitHub reports the pull request as mergeable with no repository checks configured, so treat it as pending maintainer review until it is merged and appears in the generated directory.
The mcpserve.com pull request was opened on May 13, 2026 with a
content/servers/bilig-workpaper.md listing for Bilig WorkPaper. GitHub reports
the pull request as mergeable; Netlify preview checks were pending immediately
after creation, so treat it as submitted until the maintainer merges it and the
listing appears on mcpserve.com.
Use the official Registry API when you need a machine-checkable proof:
curl -fsSL \
'https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.proompteng%2Fbilig-workpaper'
A useful result includes:
name: io.github.proompteng/bilig-workpaperidentifier: @bilig/headlesstransport.type: stdiorepository.url: https://github.com/proompteng/biligLatest checked result on May 16, 2026: the official Registry API returned one
latest Bilig WorkPaper entry for the @bilig/headless server package line. The
last documented refresh was published by the repository workflow run at
https://github.com/proompteng/bilig/actions/runs/25956395253.
The package itself carries the matching mcpName field. That is the ownership
signal the registry uses for npm package validation.
From a checkout:
cd examples/headless-workpaper
npm install
npm run agent:mcp-tools
For the packaged stdio server:
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize"}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list"}' |
npm run --silent agent:mcp-stdio
The tool list includes:
read_workpaper_summaryset_workpaper_input_cellThe write path edits one input cell, recalculates dependent formulas, and returns structured readback. That is the behavior a directory listing should describe; Bilig is not a generic spreadsheet screenshot tool.
Bilig WorkPaper is a local stdio MCP server for formula-backed workbook
automation. It lets agents and Node services read workbook summaries, edit input
cells, recalculate formulas, verify readback, and persist WorkPaper JSON through
the published @bilig/headless package.
npm exec --package @bilig/headless -- bilig-workpaper-mcp