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.
Fetch full page when method has multiple overloads or you need complete parameter details.
Error Troubleshooting
Use microsoft_code_sample_search to find working code samples and compare with your implementation. For specific errors, use microsoft_docs_search and microsoft_docs_fetch:
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"
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
Before generating code using Microsoft SDKs, verify it's correct:
Confirm method or package exists — microsoft_docs_search(query: "[ClassName] [MethodName] [Namespace]")
Fetch full details (for overloads/complex params) — microsoft_docs_fetch(url: "...")
Find working sample — microsoft_code_sample_search(query: "[task]", language: "[lang]")
For simple lookups, step 1 alone may suffice. For complex API usage, complete all three steps.
CLI Alternative
If the Learn MCP server is not available, use the mslearn CLI from the command line instead:
# Run directly (no install needed)
npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs"
# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "BlobClient UploadAsync Azure.Storage.Blobs"
