Microsoft Learn MCP Server: Tools, Setup and Security

The Microsoft Learn MCP server gives AI tools direct access to Microsoft's official documentation and code samples. It has three read-only tools for searching docs, fetching a full page and finding code samples. It is free, needs no sign-in and runs at https://learn.microsoft.com/api/mcp.

Checked against: Microsoft Learn's MCP overview, the MicrosoftDocs/mcp README and Claude's Microsoft Learn listing on 2 November 2026. eSEOspace did not install or test this server.

At a glance

What it can do

The README lists three tools:

• microsoft_docs_search runs a semantic search over Microsoft's official technical documentation. It takes a query.
• microsoft_docs_fetch fetches a Microsoft docs page and converts it to markdown. It takes a url.
• microsoft_code_sample_search searches official Microsoft and Azure code samples. It takes a query and an optional language.

The overview page says the server is an interface to the Learn knowledge service "that powers Ask Learn and Copilot for Azure." Microsoft suggests it for coding environments, Copilot Studio and Foundry agents, and support teams.

Two experimental options exist. An OpenAI-compatible endpoint at /api/mcp/openai-compatible supports OpenAI Deep Research models. A maxTokenBudget query parameter trims search results, for example https://learn.microsoft.com/api/mcp?maxTokenBudget=2000.

Microsoft also publishes @microsoft/learn-cli, which runs the same searches from a terminal without MCP, and three agent skills.

How to connect it

Most clients accept this standard config:

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

For Codex:

codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"

For Claude Code, the README recommends the plugin, which adds the server and skills:

/plugin install microsoft-docs@claude-plugins-official

In Claude Desktop, add a custom connector with the URL, or use the listing in Claude's directory. Visual Studio 2022 and 2026 include the server already. The README also gives configs for VS Code, Cursor, Gemini CLI, Windsurf, Cline, Kiro, GitHub's coding agent and ChatGPT.

The endpoint is for MCP clients only. Opening it in a browser may return 405 Method Not Allowed. Our MCP config generator can format the JSON for other clients.

Security notes

This is one of the lower-risk servers you can add. It is read-only, needs no credentials, and Microsoft says it only reaches "official 1st-party Microsoft documentation."

A few points still apply:

• Terms. Using the server means agreeing to the Microsoft Learn Terms of Use.
• Freshness. Results follow the daily refresh, so very new changes may lag.
• Your queries. Search queries go to Microsoft. Avoid pasting customer data or secrets into prompts that trigger a search.
• Tool changes. For custom clients, Microsoft says to discover tools at runtime with tools/list and refresh on errors.

Docs content is still text your agent reads. See tool poisoning for the general risk. The MCP project's security best practices and our MCP Security Center cover the rest.

Alternatives

• Azure MCP server to manage Azure resources, not just read docs.
• Context7 MCP server for docs across many open-source libraries.
• Microsoft MCP Server for Enterprise for Microsoft 365 tenant data.

Next step

Add the server and ask a question you already know the answer to, such as an Azure CLI command, to see how your client uses it. Our docs lookup playbook shows a full workflow, and the MCP server directory has more.

Frequently asked questions