# Microsoft Learn MCP

> Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

- name: com.microsoft/microsoft-learn-mcp
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 85/100
- quality: 66/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.microsoft%2Fmicrosoft-learn-mcp
- tools: https://api.protogrid.dev/v1/servers/com.microsoft%2Fmicrosoft-learn-mcp/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "type": "http",
      "url": "https://learn.microsoft.com/api/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 45
- provenance: 85
- drivers: +repository +dns-namespace +website +reachable +uptime-100% -stale-333d
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 66/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 79 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 3 of 3 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: microsoft_docs_fetch (openWorldHint); microsoft_docs_search (openWorldHint); microsoft_code_sample_search (openWorldHint)
- pass `tools.token_cost`: about 987 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 30 tool changes in 30 days
- fail `stability.rug_pull`: 8 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 3, about 987 tokens to load them all
- tool set hash: 9b76442abbc72231a7c04cb48aad1d10
- tools last changed: 2026-10-09T16:40:25.853Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.microsoft/microsoft-learn-mcp.svg)](https://protogrid.dev/servers/com.microsoft/microsoft-learn-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-09 `microsoft_docs_fetch` changed (inputSchema)
- 2026-10-09 `microsoft_code_sample_search` changed (inputSchema, outputSchema)
- 2026-10-09 `microsoft_docs_search` changed (inputSchema, outputSchema)
- 2026-10-09 `microsoft_docs_fetch` changed (description, inputSchema) **meaning changed**
  - before: Fetch complete content from a Microsoft documentation page and convert to markdown. ## When to Use: - Search results are incomplete or truncated - Need complete procedures, troubleshooting steps, or detailed explanations - Found a highly relevant page in search results ## Workflow: Use after microsoft_docs_search to get full content from high-value pages. ## URL Requirements: Must be a valid microsoft.com domain URL. ## Returns: Markdown with headings, code blocks, tables, and links preserved.
  - after: Fetch and convert a Microsoft Learn documentation webpage to markdown format. This tool retrieves the latest complete content of Microsoft documentation webpages including Azure, .NET, Microsoft 365, and other Microsoft technologies. ## When to Use This Tool - When search results provide incomplete information or truncated content - When you need complete step-by-step procedures or tutorials - When you need troubleshooting sections, prerequisites, or detailed explanations - When search results reference a specific page that seems highly relevant - For comprehensive guides that require full context ## Usage Pattern Use this tool AFTER microsoft_docs_search when you identify specific high-value pages that need complete content. The search tool gives you an overview; this tool gives you the complete picture. ## URL Requirements - The URL must be a valid HTML documentation webpage from the microsoft.com domain - Binary files (PDF, DOCX, images, etc.) are not supported ## Output Format markdown with headings, code blocks, tables, and links preserved.
- 2026-10-09 `microsoft_code_sample_search` changed (description, inputSchema)
  - before: Search for code snippets in official Microsoft Learn documentation. Returns relevant code samples with practical implementation examples for Microsoft/Azure products. Helps you use the **LATEST OFFICIAL** code snippets. ## When to Use: - When providing sample Microsoft/Azure related code snippets - When generating any Microsoft/Azure related code ## Usage: Input a descriptive query or SDK/class/method name. Optional 'language' parameter filters results. Eligible languages: csharp, javascript, typescript, python, powershell, azurecli, al, sql, java, kusto, cpp, go, rust, ruby, php.
  - after: Search for code snippets and examples in official Microsoft Learn documentation. This tool retrieves relevant code samples from Microsoft documentation pages providing developers with practical implementation examples and best practices for Microsoft/Azure products and services related coding tasks. This tool will help you use the **LATEST OFFICIAL** code snippets to empower coding capabilities. ## When to Use This Tool - When you are going to provide sample Microsoft/Azure related code snippets in your answers. - When you are **generating any Microsoft/Azure related code**. ## Usage Pattern Input a descriptive query, or SDK/class/method name to retrieve related code samples. The optional parameter `language` can help to filter results. Eligible values for `language` parameter include: csharp javascript typescript python powershell azurecli al sql java kusto cpp go rust ruby php
- 2026-10-09 `microsoft_docs_search` changed (description, inputSchema) **meaning changed**
  - before: Search official Microsoft/Azure documentation for the most relevant and trustworthy content. Returns up to 10 high-quality content chunks with title, URL, and excerpt. ## Usage: Always use this tool first to ground answers in official Microsoft/Azure knowledge when facing Microsoft/Azure related questions, then use microsoft_docs_fetch for complete page content when needed.
  - after: Search official Microsoft/Azure documentation to find the most relevant and trustworthy content for a user's query. This tool returns up to 10 high-quality content chunks (each max 500 tokens), extracted from Microsoft Learn and other official sources. Each result includes the article title, URL, and a self-contained content excerpt optimized for fast retrieval and reasoning. Always use this tool to quickly ground your answers in accurate, first-party Microsoft/Azure knowledge. ## Follow-up Pattern To ensure completeness, use microsoft_docs_fetch when high-value pages are identified by search. The fetch tool complements search by providing the full detail. This is a required step for comprehensive results.
- 2026-10-09 `microsoft_docs_fetch` changed (inputSchema)
- 2026-10-09 `microsoft_code_sample_search` changed (inputSchema)
- 2026-10-09 `microsoft_docs_search` changed (inputSchema)
- 2026-10-08 `microsoft_docs_fetch` changed (inputSchema)

Full history: https://api.protogrid.dev/v1/servers/com.microsoft%2Fmicrosoft-learn-mcp/changes

## Remotes

- https://learn.microsoft.com/api/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (3)

- `microsoft_code_sample_search`: Search for code snippets and examples in official Microsoft Learn documentation. This tool retrieves relevant code samples from Microsoft documentation pages providing developers with practical implementation examples and best practices for Microsoft/Azure products and services related coding tasks. This tool will help you use the **LATEST OFFICIAL** code snippets to empower coding capabilities.

## When to Use This Tool
- When you are going to provide sample Microsoft/Azure related code snippets in your answers.
- When you are **generating any Microsoft/Azure related code**.

## Usage Pattern
Input a descriptive query, or SDK/class/method name to retrieve related code samples. The optional parameter `language` can help to filter results.

Eligible values for `language` parameter include: csharp javascript typescript python powershell azurecli al sql java kusto cpp go rust ruby php
- `microsoft_docs_fetch`: Fetch and convert a Microsoft Learn documentation webpage to markdown format. This tool retrieves the latest complete content of Microsoft documentation webpages including Azure, .NET, Microsoft 365, and other Microsoft technologies.

## When to Use This Tool
- When search results provide incomplete information or truncated content
- When you need complete step-by-step procedures or tutorials
- When you need troubleshooting sections, prerequisites, or detailed explanations
- When search results reference a specific page that seems highly relevant
- For comprehensive guides that require full context

## Usage Pattern
Use this tool AFTER microsoft_docs_search when you identify specific high-value pages that need complete content. The search tool gives you an overview; this tool gives you the complete picture.

## URL Requirements
- The URL must be a valid HTML documentation webpage from the microsoft.com domain
- Binary files (PDF, DOCX, images, etc.) are not supported

## Output Format
markdown with headings, code blocks, tables, and links preserved.
- `microsoft_docs_search`: Search official Microsoft/Azure documentation to find the most relevant and trustworthy content for a user's query. This tool returns up to 10 high-quality content chunks (each max 500 tokens), extracted from Microsoft Learn and other official sources. Each result includes the article title, URL, and a self-contained content excerpt optimized for fast retrieval and reasoning. Always use this tool to quickly ground your answers in accurate, first-party Microsoft/Azure knowledge.

## Follow-up Pattern
To ensure completeness, use microsoft_docs_fetch when high-value pages are identified by search. The fetch tool complements search by providing the full detail. This is a required step for comprehensive results.