Bilig WorkPaper
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
Formula-backed WorkPaper tools for workbook readback, input edits, and JSON persistence.
| Author | io.github.proompteng |
|---|---|
| Access | mixed |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 314 ms |
| Last measured | 2026-10-26 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"Bilig WorkPaper": {
"url": "https://bilig.proompteng.ai/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (8)
list_sheetsread-onlyDiscover sheet names and used dimensions before reading or editing a WorkPaper. Returns metadata only; use read_range or read_cell for values.
Hints: read-only yes · destructive no · idempotent yes · open-world no
read_rangeread-onlyRead calculated values plus serialized formulas/inputs for an A1 range. Use for audit readback after edits; use read_cell for one address.
Parameters:
range(required) — string — A1 range such as Summary!A1:B5. If omitted from the range, pass sheetName separately.sheetName— string — Default sheet name when range omits a sheet name, for example Summary.
Hints: read-only yes · destructive no · idempotent yes · open-world no
read_cellread-onlyRead one cell with calculated value, display text, formula text, formula diagnostics, and serialized content. Use after set_cell_contents to verify readback.
Parameters:
sheetName(required) — string — Existing sheet name.address(required) — string — Single A1 cell address such as B3.
Hints: read-only yes · destructive no · idempotent yes · open-world no
set_cell_contentsWrite raw content to one cell and recalculate dependents in memory only. Start with --writable when the edit should persist to JSON.
Parameters:
sheetName(required) — string — Existing sheet name, for example Inputs.address(required) — string — Single A1 cell address such as B3. Ranges are not accepted.value(required) — string — Raw cell content. Formula strings must start with =; plain strings are stored as literals. Strict MCP hosts such as Semantic Kernel require a single parameter type, so pass evaluated numbers/booleans as formulas such as =0.4 or =TRUE(). The server still accepts JSON number, boolean, or null arguments from clients that support them.
Hints: read-only no · destructive no · idempotent yes · open-world no
set_cell_contents_and_readbackWrite 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.
Parameters:
sheetName(required) — string — Existing sheet name for the cell to edit, for example Inputs.address(required) — string — Single A1 cell address to edit, such as B3. Ranges are not accepted.value(required) — string — Raw cell content. Formula strings must start with =; plain strings are stored as literals. Strict MCP hosts require a single parameter type, so pass evaluated numbers/booleans as formulas such as =0.4 or =TRUE(). The server still accepts JSON number, boolean, or null arguments from clients that support them.readbackRange(required) — string — Dependent A1 range to read before and after the edit, for example Summary!A1:B5.readbackSheetName— string — Default sheet name when readbackRange omits a sheet name.
Hints: read-only no · destructive no · idempotent yes · open-world no
get_cell_display_valueread-onlyReturn the formatted display string for one cell. Use when an agent needs what a user would see, not the raw numeric value.
Parameters:
sheetName(required) — string — Existing sheet name.address(required) — string — Single A1 cell address such as B3.
Hints: read-only yes · destructive no · idempotent yes · open-world no
export_workpaper_documentread-onlyExport the current WorkPaper JSON document for persistence, review, or handoff to another agent. Does not write files by itself.
Parameters:
includeConfig— boolean — Include workbook configuration metadata in the exported JSON. Defaults to true.
Hints: read-only yes · destructive no · idempotent yes · open-world no
validate_formularead-onlyValidate formula syntax with the WorkPaper parser before writing it to a cell. This checks syntax only; use set_cell_contents plus readback to evaluate.
Parameters:
formula(required) — string — Formula string including the leading =, for example =SUM(Inputs!B2:B4).
Hints: read-only yes · destructive no · idempotent yes · open-world no
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.