Skip to content

docs: add Bilig WorkPaper MCP example#7725

Open
gregkonush wants to merge 3 commits into
microsoft:mainfrom
gregkonush:bilig-workpaper-mcp-example
Open

docs: add Bilig WorkPaper MCP example#7725
gregkonush wants to merge 3 commits into
microsoft:mainfrom
gregkonush:bilig-workpaper-mcp-example

Conversation

@gregkonush
Copy link
Copy Markdown

@gregkonush gregkonush commented May 21, 2026

Why are these changes needed?

Adds a small autogen-ext MCP workbench example for a third-party stdio MCP server. The example uses Bilig WorkPaper to show an AutoGen workflow that can:

  • launch an MCP server with McpWorkbench
  • discover workbook tools
  • read workbook input and summary ranges
  • update an input cell
  • verify recalculated formula readback
  • confirm JSON persistence

The default path is a no-key smoke test. The optional --agent path uses AssistantAgent with the same MCP workbench and fails early with clear dependency/API-key guidance when optional agent dependencies or OPENAI_API_KEY are missing.

Related Bilig evaluator

Bilig has a copy-paste agent/MCP evaluator page for the same workbook proof pattern used here: tool discovery, cell mutation, formula readback, JSON export, and restore proof.
https://proompteng.github.io/bilig/eval-agent-mcp.html

Related issue number

N/A. Documentation/example-only contribution.

Checks

Passing local validation:

python -m py_compile python/packages/autogen-ext/examples/bilig_workpaper_mcp_example.py
ruff format --check python/packages/autogen-ext/examples/bilig_workpaper_mcp_example.py
ruff check python/packages/autogen-ext/examples/bilig_workpaper_mcp_example.py
uv run --with autogen-core --with 'autogen-ext[mcp]' python python/packages/autogen-ext/examples/bilig_workpaper_mcp_example.py
npm view @bilig/workpaper version
npm exec --yes --package @bilig/workpaper@latest -- bilig-agent-challenge --json

npm view @bilig/workpaper version returned 0.119.0 in the 2026-05-29 refresh. The package proof command returned verified: true with formula readback, export, and restore checks passing.

The MCP smoke path verified ARR changed from 60000 to 96000 after setting Inputs!B3 to 0.4, expected customers changed to 8, persistence was true, restored readback matched, and the WorkPaper JSON was exported.

Expected guard-path validation:

env -u OPENAI_API_KEY uv run --with autogen-core --with 'autogen-ext[mcp]' python python/packages/autogen-ext/examples/bilig_workpaper_mcp_example.py --agent

That command exits with Error: Set OPENAI_API_KEY before running the optional --agent demo., which is the intended failure mode for the optional LLM-backed path without credentials.

@gregkonush gregkonush force-pushed the bilig-workpaper-mcp-example branch 4 times, most recently from 1518bdf to 146115d Compare May 21, 2026 10:58
@gregkonush
Copy link
Copy Markdown
Author

@microsoft-github-policy-service agree

@gregkonush gregkonush force-pushed the bilig-workpaper-mcp-example branch from 39e61d1 to d936d83 Compare May 25, 2026 03:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant