microsoft / microsoft/GitHub-Copilot-for-Azure

azure-prepare: MCP recipe not discovered when user asks to create MCP server

Open
#997 1 comment 0 reactions 1 assignee View on GitHub

@paulyuk is already working on this.

Since Feb 23, 2026.

enhancement skills
Dominant language
Python
Stars
250
Forks
204
Avg merge
1d 12h
Merged PRs (30d)
67

Description

Problem

When a user asks to "make this an MCP server", the agent does not automatically discover and use the MCP recipe at references/services/functions/templates/recipes/mcp/.

What Happened
  1. User asked: "make this an MCP server and redeploy"
  2. Agent installed external @modelcontextprotocol/sdk package and improvised implementation
  3. Agent did NOT consult the existing MCP recipe with documented JSON-RPC 2.0 pattern
  4. Only after user questioned the approach did agent search and find the recipe
Expected Behavior

Agent should automatically route to the MCP recipe when user mentions:

  • "MCP server"
  • "MCP tools"
  • "Model Context Protocol"
  • "AI agent tools"
Root Cause

The MCP recipe exists and is comprehensive, but there's no explicit routing in the main SKILL.md to direct agents to it based on keywords. The guidance is buried in:

  • references/services/functions/templates/recipes/mcp/README.md
  • references/services/functions/templates/selection.md (line 10-13)
Suggested Fix

Add a Quick Routing table near the top of azure-prepare/SKILL.md that maps keywords to specific recipes:

## Quick Routing (Check FIRST)

| User Mentions | Go Directly To |
|---------------|----------------|
| MCP, MCP server, AI agent tools | [MCP Recipe](references/services/functions/templates/recipes/mcp/README.md) |
| Event Hubs, stream processing | [Event Hubs Recipe](references/services/functions/templates/recipes/eventhubs/README.md) |
| Service Bus, queues, topics | [Service Bus Recipe](references/services/functions/templates/recipes/servicebus/README.md) |
| Durable Functions, orchestration | [Durable Recipe](references/services/functions/templates/recipes/durable/README.md) |

This would catch keyword-triggered scenarios BEFORE the agent starts the full planning workflow.

Impact
  • Agents improvise solutions instead of using tested patterns
  • Users get non-standard implementations
  • Wasted deployment cycles fixing mistakes
Files Involved
  • plugin/skills/azure-prepare/SKILL.md - needs routing addition
  • plugin/skills/azure-prepare/references/services/functions/templates/recipes/mcp/README.md - existing recipe (good)
  • plugin/skills/azure-prepare/references/services/functions/templates/selection.md - has MCP detection logic but not prominently linked

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.