New lab - APIM integration with Foundry Toolbox

[georgeollis]

Purpose

• Introduce a brand-new ai-foundry-toolbox lab that deploys and governs a shared Foundry Toolbox with two MCP servers:
  • vet-clinic MCP server
  • pet-insurance MCP server
• Include brand-new MCP server implementations with tools for veterinary and pet insurance workflows (including):
  • coverage checks
  • pre-authorization requests
  • claim status lookups
  • claim document submission
• Provision new lab infrastructure to deploy both Function Apps and wire APIM diagnostics/tracing to Application Insights.
• Add notebook examples that show clear tool-call traces and multiple end-to-end scenarios through APIM.

Does this introduce a breaking change?

[ ] Yes
[x] No

Pull Request Type

What kind of change does this Pull Request introduce?

[ ] Bugfix
[x] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[x] Documentation content changes
[ ] Other... Please describe:

How to Test

• Get the code

git clone [repo-address]
cd [repo-name]
git checkout [branch-name]
uv sync

• Test the code

1. Open labs/ai-foundry-toolbox/ai-foundry-toolbox.ipynb.
2. Run notebook cells in order (or Run All) through at least Section 8.
3. Verify deployment succeeds for:
   - APIM + Foundry + App Insights resources
   - Function App for vet-clinic MCP server
   - Function App for pet-insurance MCP server
4. Verify toolbox creation includes both server labels:
   - vet
   - insurance
5. Verify direct toolbox discovery lists both vet___* and insurance___* tools.
6. Verify APIM proxy discovery works with subscription key.
7. Run the multi-scenario chat examples and confirm tool call traces are printed.

What to Check

Verify that the following are valid:

• This PR introduces the ai-foundry-toolbox lab as a new end-to-end implementation.
• New MCP server folders exist:
  • labs/ai-foundry-toolbox/mcp-servers/vet-clinic
  • labs/ai-foundry-toolbox/mcp-servers/pet-insurance
• Folder naming is consistent across notebook/docs:
  • vet-clinic
  • pet-insurance
• Bicep deploys both Function Apps and required storage containers/role assignments.
• APIM diagnostics for inference/toolbox APIs are configured to send telemetry to Application Insights.
• Notebook scenarios demonstrate clear tool-call traces with arguments and result previews.
• README reflects the two-server toolbox workflow.

Other Information

• Scope intentionally limited to ai-foundry-toolbox work.
• This PR represents a new lab delivery (infrastructure + notebook workflow + MCP servers + documentation) rather than incremental changes to an existing lab.

[georgeollis]

@microsoft-github-policy-service agree company="Microsoft"