Files
08abe9e704 .NET: Add Foundry Toolbox MCP skills discovery sample (#6134)
* feat: add Agent_Step26_FoundryToolboxMcpSkills sample

Add a new sample demonstrating MCP-based skills discovery from a Foundry
Toolbox endpoint using AgentSkillsProviderBuilder and AIContextProviders.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: address PR review comments for Step26 sample

- Add Foundry-Features: Toolboxes=V1Preview header to MCP transport
  options, matching the Step25 pattern
- Document skill://index.json prerequisite in README

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Update dotnet/samples/02-agents/AgentsWithFoundry/Agent_Step26_FoundryToolboxMcpSkills/Program.cs

Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
2026-05-28 12:41:33 +00:00
..

Foundry Toolbox MCP Skills

This sample uses AgentSkillsProviderBuilder to discover MCP-based skills from a Foundry Toolbox endpoint and inject them as AIContextProviders so the agent can discover and use them at runtime.

What this sample demonstrates

  • Connecting to a Foundry toolbox's MCP endpoint via Streamable HTTP transport
  • Injecting a fresh Azure AI bearer token (https://ai.azure.com/.default) on every MCP request
  • Using AgentSkillsProviderBuilder.UseMcpSkills(client) to discover skills from the toolbox
  • Injecting the discovered skills into AIProjectClient.AsAIAgent(...) via AIContextProviders

Prerequisites

  • A Microsoft Foundry project with a toolbox already configured
  • The toolbox MCP endpoint must expose skill://index.json with skill-md entries (SEP-2640). If the resource is absent, the sample runs but the skills provider will be empty.
  • Azure CLI installed and authenticated (az login)

Set the following environment variables:

$env:AZURE_AI_PROJECT_ENDPOINT="https://your-foundry-service.services.ai.azure.com/api/projects/your-foundry-project"
$env:AZURE_AI_MODEL_DEPLOYMENT_NAME="gpt-5.4-mini"
$env:FOUNDRY_TOOLBOX_MCP_SERVER_URL="https://your-foundry-service.services.ai.azure.com/api/projects/your-project/toolboxes/your-toolbox/mcp?api-version=v1"

Run the sample

dotnet run