ms-learn

name	ms-learn
description	Query official Microsoft documentation for Azure, .NET, Microsoft 365, and all Microsoft technologies. Use for concepts, tutorials, code samples, limits, and best practices from learn.microsoft.com.

Fetch current Microsoft docs instead of relying on training data.

Primary Method: MCP Tools

Microsoft Learn is configured via .mcp.json and provides MCP tools automatically:

Available MCP Tools:

• mcp__microsoft-learn__microsoft_docs_search - Find docs (concepts, tutorials, config, limits)
• mcp__microsoft-learn__microsoft_docs_fetch - Get full page content
• mcp__microsoft-learn__microsoft_code_sample_search - Find official code samples

Usage:

Tool: mcp__microsoft-learn__microsoft_docs_search
Parameters: { "query": "Azure Functions Python v2 programming model" }

Tool: mcp__microsoft-learn__microsoft_docs_fetch
Parameters: { "url": "https://learn.microsoft.com/..." }

Tool: mcp__microsoft-learn__microsoft_code_sample_search
Parameters: { "query": "Cosmos DB", "language": "csharp" }

Fallback: Go CLI

If MCP tools are unavailable, use the mslearn binary in tools/mslearn/:

# Build (one-time)
cd tools/mslearn && make build

# Search docs
./tools/mslearn/mslearn search --query "Azure Functions Python v2"

# Fetch full page
./tools/mslearn/mslearn fetch --url "https://learn.microsoft.com/en-us/azure/azure-functions/functions-overview"

# Search code samples
./tools/mslearn/mslearn samples --query "Cosmos DB" --language python

# Batch queries from JSONL
./tools/mslearn/mslearn batch --file tools/mslearn/queries.jsonl

# Session reuse for multiple queries
./tools/mslearn/mslearn session start
./tools/mslearn/mslearn search --query "test"
./tools/mslearn/mslearn session end

Output formats: --format compact (default), json, jsonl, md

Query Tips

Be specific:

• Include version: .NET 8, EF Core 8
• Include intent: quickstart, tutorial, limits
• Include platform: Linux, Windows

Languages (for code search)

csharp typescript python powershell azurecli java go rust

Note

Zero runtime dependencies. Build requires Go 1.22+. Free to use, no API key needed.