microsoft-code-reference

name	microsoft-code-reference
description	Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs.
compatibility	Requires Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp)

Microsoft Code Reference

Tools

Need	Tool	Example
API method/class lookup	microsoft_docs_search	"BlobClient UploadAsync Azure.Storage.Blobs"
Working code sample	microsoft_code_sample_search	query: "upload blob managed identity", language: "python"
Full API reference	microsoft_docs_fetch	Fetch URL from microsoft_docs_search result

When to Verify

Always verify when:

• Method name seems "too convenient" (UploadFile vs actual Upload)
• Mixing SDK versions (v11 CloudBlobClient vs v12 BlobServiceClient)
• Package name doesn't follow conventions (Azure.* for .NET, azure-* for Python)
• Using an API for the first time

Validation Workflow

1. Confirm method exists — microsoft_docs_search(query: "[ClassName] [MethodName] [Namespace]")
2. Fetch full details (for overloads) — microsoft_docs_fetch(url: "...")
3. Find working sample — microsoft_code_sample_search(query: "[task]", language: "[lang]")

Error Troubleshooting

Error Type	Query
Method not found	"[ClassName] methods [Namespace]"
Type not found	"[TypeName] NuGet package namespace"
Wrong signature	"[ClassName] [MethodName] overloads" → fetch full page
Deprecated warning	"[OldType] migration v12"
Auth failure	"DefaultAzureCredential troubleshooting"
403 Forbidden	"[ServiceName] RBAC permissions"