# Microsoft Code Reference

Find working code samples, verify API signatures, and fix Microsoft SDK errors using...

- Repository: https://github.com/MicrosoftDocs/mcp (1964 stars)
- Category: Testing
- License: CC-BY-4.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add MicrosoftDocs/mcp --skill microsoft-code-reference -g -a claude-code -y`
Codex: `npx skills add MicrosoftDocs/mcp --skill microsoft-code-reference -g -a codex -y`
Cursor: `npx skills add MicrosoftDocs/mcp --skill microsoft-code-reference -g -a cursor -y`
Gemini CLI: `npx skills add MicrosoftDocs/mcp --skill microsoft-code-reference -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add MicrosoftDocs/mcp`

## Description

Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs. Use whenever the user is writing, debugging, or reviewing code that touches any Microsoft SDK, .NET library, Azure client library, or Microsoft API, even if they don't ask for a "reference." Catches hallucinated methods, wrong signatures, and deprecated patterns. If the task involves producing or fixing Microsoft-related code, this is the right skill.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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` (for overloads, full signatures) |

## Finding Code Samples

Use `microsoft_code_sample_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 `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`:

The rest: https://github.com/MicrosoftDocs/mcp/blob/HEAD/skills/microsoft-code-reference/SKILL.md