diff --git a/docs/guides/bilig-workpaper-mcp-cookbook.mdx b/docs/guides/bilig-workpaper-mcp-cookbook.mdx new file mode 100644 index 00000000000..e68fc114608 --- /dev/null +++ b/docs/guides/bilig-workpaper-mcp-cookbook.mdx @@ -0,0 +1,168 @@ +--- +title: "Formula Workbook Readback with Bilig WorkPaper MCP and Continue" +description: "Use Continue with Bilig WorkPaper MCP to edit workbook inputs, recalculate formulas, and verify computed JSON readback without Excel UI automation." +sidebarTitle: "Bilig WorkPaper MCP" +--- + +import { OSAutoDetect } from '/snippets/OSAutoDetect.jsx' +import CLIInstall from '/snippets/cli-install.mdx' + + + + + A Continue agent workflow that connects to Bilig WorkPaper MCP, edits an input + cell, recalculates workbook formulas, and checks verified JSON readback instead + of driving Excel or trusting stale cached values. + + +## Prerequisites + +Before starting, ensure you have: + +- Continue installed with **Agent** mode available +- A model configured for tool use +- Node.js 22+ installed locally +- A Bilig WorkPaper MCP endpoint + +For all options, first: + + + + + + + + Open Continue in your IDE or run the CLI: + + ```bash + cn + ``` + + MCP tools are available from Agent mode. + + + + + The hosted Bilig endpoint below is useful for trying the flow with a sample + workbook. Use your own Bilig MCP server when working with private workbook + files or business data. + + +## Configure Bilig WorkPaper MCP + +Create a workspace MCP server file: + +```yaml title=".continue/mcpServers/bilig-workpaper.yaml" +name: Bilig WorkPaper +version: 0.0.1 +schema: v1 + +mcpServers: + - name: Bilig WorkPaper + type: streamable-http + url: https://bilig.proompteng.ai/mcp + connectionTimeout: 30 +``` + +Then restart Continue or reload your workspace so the MCP server is discovered. + + + Continue also supports local stdio MCP servers. If you run Bilig against local + WorkPaper files, replace the `streamable-http` block with your local + `bilig-workpaper-mcp` command. + + +## Try a Verified Formula Readback + +Use prompts that ask the agent to show the write, recalculation, and readback in +one response. That makes the tool call auditable and avoids hiding the computed +state behind prose. + + + Confirm Continue can see the MCP server. + +**Prompt:** + +```text +List the tools exposed by the Bilig WorkPaper MCP server. +``` + + + + Change a workbook input and ask for verified output. + +**Prompt:** + +```text +Set Inputs!B3 to 0.5 in the Bilig WorkPaper workbook. +Recalculate the workbook and return the verified readback JSON. +Include the edited cell, before and after values, and whether persisted readback matched. +``` + + + + Ask Continue to summarize what changed without losing the proof. + +**Prompt:** + +```text +Using the verified Bilig readback, explain which formula outputs changed. +Keep the JSON proof in the answer and call out any failed checks. +``` + + +## Where This Pattern Helps + +Bilig WorkPaper is useful when a coding agent needs spreadsheet-style business +logic as a tool contract: + +- Pricing and quote approval formulas +- Payout or commission calculations +- Import validation workbooks +- Forecast and scenario models +- Regression tests for formula-backed workflows + +The important part is not just formula evaluation. The agent can write an input, +recalculate, read computed outputs, and return a compact proof that the persisted +workbook state still matches the result. + +## Troubleshooting + + + + Check that the file is under `.continue/mcpServers/`, includes `name`, + `version`, and `schema`, and that you restarted Continue after adding it. + MCP tools are available in Agent mode. + + + + Do not send private workbook data to the hosted sample endpoint. Run your own + Bilig WorkPaper MCP server and point Continue at that local or private URL. + + + + Ask for a concrete tool action: set a specific sheet and cell, recalculate, + and return the verified readback JSON. Also confirm your selected model + supports tool calls. + + + +## Resources + + + + Source code, package links, examples, and WorkPaper docs. + + + + Package containing the WorkPaper runtime and MCP command. + + + + Continue's MCP setup and transport reference. + + + + More examples for using MCP servers with Continue. + + diff --git a/docs/guides/overview.mdx b/docs/guides/overview.mdx index fc601ca63ec..6a09cd5a041 100644 --- a/docs/guides/overview.mdx +++ b/docs/guides/overview.mdx @@ -78,6 +78,10 @@ Step-by-step guides for integrating Model Context Protocol (MCP) servers with Co Build AI-powered data pipelines with dlt MCP for pipeline inspection, schema management, and debugging + + Edit workbook inputs, recalculate formulas, and verify computed JSON readback with Bilig WorkPaper MCP + + Use Continue and Klavis AI's Strata MCP to automate communication workflows across Slack and Gmail