#293·skills

Add Microsoft Learn MCP to Azure SDK language plugins

Author: samvaityCreated Apr 24, 2026Updated Apr 24, 2026

Context

The skill-creator skill explicitly recommends using microsoft-docs MCP for fresh documentation:

  • Core Principle #2: Fresh Documentation First
  • Step 1 instructions: Use microsoft-docs MCP to get current API patterns

However, the Azure SDK language plugins currently don't have MCP configurations:

  • ❌ azure-sdk-java
  • ❌ azure-sdk-python
  • ❌ azure-sdk-dotnet
  • ❌ azure-sdk-typescript
  • ❌ azure-sdk-rust

For comparison, these plugins already use MCP:

  • ✅ microsoft-foundry
  • ✅ azure-skills

Question

Should we add Microsoft Learn MCP to the SDK language plugin definitions?

Example for azure-sdk-java/.claude-plugin/plugin.json: With .mcp.json:

json
{
  "mcpServers": {
    "microsoft-learn": {
      "command": "npx",
      "args": ["-y", "@microsoft/learn-cli@latest"]
    }
  }
}

Benefits

  1. Aligns with skill-creator guidance - Enables the "Fresh Documentation First" principle
  2. Prevents stale SDK info - Example: Form Recognizer rebranding could have been caught automatically
  3. Converges documentation efforts - Single source of truth for SDK documentation
  4. Consistent pattern - Same approach as microsoft-foundry plugin

Considerations

Before implementing, we should:

  1. Validate MS Learn docs quality - There was an exercise to ensure docs are clear and consistent, but unclear if completed
  2. Test the pattern - Verify that adding MCP doesn't break existing workflows
  3. Monitor usage - See if this becomes a recurring need across multiple SDK updates

References