smithery.ai

microsoft-code-reference

Look up Microsoft API references, find working code samples, and verify SDK code is correct.

First seen Mar 8, 2026

Installation

$ npx skills add https://smithery.ai

Summary

  • 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.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

CompatibilityWorks best with Microsoft Learn MCP Server (https://learn.microsoft.com/api/mcp). Can also use the mslearn CLI as a fallback.

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,203 B
  • docs SUMMARY.md 383 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 25 installs

SKILL.md

Microsoft Code Reference

Tools

Need Tool Example
API method/class lookup microsoftdocssearch "BlobClient UploadAsync Azure.Storage.Blobs"
Working code sample microsoftcodesample_search query: "upload blob managed identity", language: "python"
Full API reference microsoftdocsfetch Fetch URL from microsoftdocssearch (for overloads, full signatures)

Finding Code Samples

Use microsoftcodesample_search to get official, working examples:

microsoft_code_sample_search(query: "upload file to blob storage", language: "csharp")
microsoft_code_sample_search(query: "authenticate with managed identity", language: "python")
microsoft_code_sample_search(query: "send message service bus", language: "javascript")

When to use:

  • Before writing code—find a working pattern to follow
  • After errors—compare your code against a known-good sample
  • Unsure of initialization/setup—samples show complete context

API Lookups

# Verify method exists (include namespace for precision)
"BlobClient UploadAsync Azure.Storage.Blobs"
"GraphServiceClient Users Microsoft.Graph"

# Find class/interface
"DefaultAzureCredential class Azure.Identity"

# Find correct package
"Azure Blob Storage NuGet package"
"azure-storage-blob pip package"

Fetch full page when method has multiple overloads or you need complete parameter details.

Error Troubleshooting

Use microsoftcodesamplesearch to find working code samples and compare with your implementation. For specific errors, use microsoftdocssearch and microsoftdocs_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:

  1. Confirm method or package existsmicrosoftdocssearch(query: "[ClassName] [MethodName] [Namespace]")
  2. Fetch full details (for overloads/complex params) — microsoftdocsfetch(url: "...")
  3. Find working samplemicrosoftcodesample_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 a terminal or shell (for example, Bash, PowerShell, or cmd) 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"
MCP Tool CLI Command
microsoftdocssearch(query: "...") mslearn search "..."
microsoftcodesample_search(query: "...", language: "...") mslearn code-search "..." --language ...
microsoftdocsfetch(url: "...") mslearn fetch "..."

Pass --json to search or code-search to get raw JSON output for further processing.