Microsoft Learn MCP Server: Setup for Claude, Cursor and Other Apps
Lets your AI assistant search and read official Microsoft Learn and Azure documentation and code samples.
Microsoft Learn MCP is Microsoft's own server that lets Claude, Cursor, Copilot and other assistants search and read Microsoft Learn documentation and code samples. It runs on Microsoft's servers, so there is nothing to install and no account or API key. The README says it only reaches first-party Microsoft documentation. Your search text is sent to Microsoft, and the server is read-only.
Good for
- Developers writing Azure, .NET or Microsoft 365 code with an AI assistant
- Cloud engineers who want answers checked against current Microsoft docs
- Teams who want fewer made-up SDK methods in generated code
Works in
14 should work
Tap an app to see how to set it up and any known problems.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Install Microsoft Learn MCP
Claude Code
- 1
Copy this prompt.
Add the Microsoft Learn MCP server to Claude Code. Run this command: claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Built from the package data we hold. Not yet tested by us.
Tools
Searches Microsoft and Azure documentation for the best matches
Finds the closest passages in Microsoft Learn for your question and returns up to 10 short excerpts with titles and links. The assistant uses it to ground an answer in current docs.
Try: “Is gpt-5.4 available in Azure EU regions?”
Network ·
microsoft_docs_searchReads a whole Microsoft documentation page
Downloads one Microsoft Learn page and returns the full text as Markdown. Use it when a search excerpt is too short for a full procedure or troubleshooting section.
Try: “Read the full Azure Container Apps managed identity page and list the steps.”
Network ·
microsoft_docs_fetchFinds official Microsoft and Azure code samples
Searches Microsoft documentation for code snippets, optionally filtered by programming language. It is meant for the moments when the assistant is about to write Microsoft or Azure code.
Try: “Show me a C# example of IHttpClientFactory in a .NET 8 minimal API.”
Network ·
microsoft_code_sample_search
Read from the source code
Permissions
low risk · 2 things to watch
Low risk
The three tools only read documentation, but your search text is sent to Microsoft because the server is hosted there.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Your search text goes to Microsoft
The server is hosted by Microsoft, so every query and page URL you ask about leaves your machine. Leave private details out of prompts that trigger a docs search. github.com
Not for opening in a browser
The address only works from an MCP app and returns an error if you open it in a browser. Use the install box rather than pasting it into a tab. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | All three tools only search or fetch documentation. They are marked read-only and non-destructive. |
|---|---|
| Talks to | learn.microsoft.com (your search text and page URLs) |
| Sign-in and keys | No account or API key. |
Questions
Is the Microsoft Learn MCP server official?
Yes. It is built by Microsoft and published from the MicrosoftDocs organization on GitHub.
Is it free, and does it need a key?
Yes, it is free and needs no account, sign-in or API key.
What is the Microsoft Learn MCP server URL?
The endpoint is https://learn.microsoft.com/api/mcp. Use it only inside an MCP app, because a browser gets a 405 error.
Which apps does it work with?
Any app that can connect to a web MCP server, including Claude, Cursor, VS Code, GitHub Copilot and Codex. The README names these in its intro and shows a VS Code install button.
Can it change or delete anything?
No. All three tools only search or read pages and are marked read-only.
How is it different from the Microsoft Learn CLI?
The CLI (mslearn, from the npm package named @microsoft/learn-cli) gives you the same search, fetch and code sample features in a terminal. The MCP server is what you add to an AI app. Installing the CLI does not add the server.
Does it cover everything Microsoft publishes?
It covers Microsoft Learn and other official Microsoft sources, such as Azure, .NET and Microsoft 365 docs. It does not search the open web.
Information
updated Nov 2, 2026
- Publisher
- Official
- Endpoint
https://learn.microsoft.com/api/mcp- Transport
- Streamable HTTP
- Auth
- None
- Version
- 1.0.0
- License
- CC-BY-4.0
- Last commit
- Oct 30, 2026
- Open issues
- 15
- Listed in
- Official MCP registry, Docker MCP Catalog
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 1Hide
- github.com · github.com