Microsoft Learn Docs

CC BY 4.0

documentationazuredotnetmicrosoftsearchofficial

Summary

Microsoft's official remote MCP server for Learn documentation — semantic search over first-party Azure and .NET docs, page fetch, and verified code samples. Free, no key.

Features

Semantic search across official Microsoft Learn documentation
Fetch any Learn page and convert it to markdown
Search first-party Microsoft and Azure code samples by language
Hosted remote endpoint — no install, no API key, no sign-up
Only reaches first-party docs, avoiding untrusted web sources
Companion `@microsoft/learn-cli` for terminal use without an MCP client

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it.
Restart the agent — the "Microsoft Learn Docs" tools will be available.

{
  "mcpServers": {
    "microsoft-learn-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add microsoft-learn-mcp-server -- npx -y mcp-remote https://learn.microsoft.com/api/mcp

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "microsoft-learn-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://learn.microsoft.com/api/mcp"
      ]
    }
  }
}

Cursor

{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://learn.microsoft.com/api/mcp"
  ]
}

VS Code

{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://learn.microsoft.com/api/mcp"
  ]
}

Claude Code — native HTTP transport, no proxy needed

{
  "command": "claude",
  "args": [
    "mcp",
    "add",
    "--transport",
    "http",
    "microsoft-learn",
    "https://learn.microsoft.com/api/mcp"
  ]
}

Terminal CLI with the same tools, no MCP client required

{
  "command": "npx",
  "args": [
    "@microsoft/learn-cli",
    "search",
    "azure functions timeout"
  ]
}

Description

Microsoft Learn's MCP server exists to stop agents inventing Azure SDK methods that never shipped. It is a hosted Streamable HTTP endpoint at https://learn.microsoft.com/api/mcp that answers questions from Microsoft's own published documentation rather than from a model's training data or a general web search.

Three tools do the work. microsoft_docs_search runs a semantic search across Learn and returns relevant excerpts; microsoft_docs_fetch pulls a specific documentation page and converts it to markdown so the agent can read the whole thing; and microsoft_code_sample_search looks up official Microsoft and Azure code snippets, optionally filtered by language.

The supply-chain argument is the one Microsoft leads with, and it is a fair one: a generic web-search tool can land on an abandoned blog post or a typosquatted package, while this server only ever reaches first-party documentation. For .NET, ASP.NET Core, Entity Framework, NuGet, Azure CLI and the Azure SDKs — areas that move fast enough for training data to go stale — that difference shows up as code that actually compiles.

Practical notes: it is free, needs no API key, sign-up or OAuth flow, and installs in one click in VS Code. Because it is Streamable HTTP only, opening the URL in a browser returns 405 Method Not Allowed — that is expected, not a fault. A companion CLI (@microsoft/learn-cli) exposes the same three tools in a terminal for agents without an MCP client.

Related MCP Servers

MCP: Serena

by Oraios AI

New

Semantic code toolkit for coding agents — symbol-level search, editing and refactoring backed by language servers or the JetBrains platform.

Developer Tools

MCP: Hugging Face

by Hugging Face

New

Official Hugging Face MCP server: search models, datasets, Spaces and papers on the Hub, read repository files, and call Gradio apps as agent tools.

Developer ToolsWeb & Search

MCP: GitLab MCP Server

by GitLab

New

GitLab's own MCP server — issues, merge requests, CI/CD pipelines, job logs, wikis and semantic code search over an OAuth-authorised HTTP endpoint.

Developer Tools

MCP: Mobile MCP

by Mobile Next

New

Platform-agnostic MCP server that drives iOS and Android apps on simulators, emulators and real devices through the accessibility tree rather than screenshots.

Developer Tools

Browse all MCP servers →