Microsoft Learn MCP Server
About
The Microsoft Learn MCP Server is a cloud-hosted service that enables MCP hosts like GitHub Copilot and Cursor to search and retrieve accurate information directly from Microsoft's official documentation. By implementing the standardized Model Context Protocol (MCP), this service
Details
- Author
- microsoftdocs
- Downloads
- 331
- Categories
- Developer Tools, Knowledge Base, AI, Other
Jump to
- High‑quality content retrieval from official Microsoft documentation sources.
- Semantic understanding via advanced vector search for contextual relevance.
- Returns up to 10 chunks (max 500 tokens each) with titles, URLs, and excerpts.
- Real‑time access to the latest Microsoft documentation.
- Single tool: microsoft_docs_search for semantic search.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Microsoft Learn MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via one-click buttons for VS Code, VS Code Insiders, or Cursor, or manually configure the remote endpoint https://learn.microsoft.com/api/mcp. For clients without Streamable HTTP support (e.g., Claude Desktop, Windsurf), use npx -y mcp-remote as a workaround. After setup, invoke the microsoft_docs_search tool with a query to retrieve relevant documentation chunks.
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"microsoft learn mcp server": {
"type": "http",
"url": "https://learn.microsoft.com/api/mcp"
}
}
}
Microsoft.docs.mcp
{
"type": "http",
"url": "https://learn.microsoft.com/api/mcp"
}
🌐 The Microsoft Learn MCP Server Endpoint
The Microsoft Learn MCP Server is accessible to any IDE, agent, or tool that supports the Model Context Protocol (MCP). Any compatible client can connect to the followingremote MCP endpoint:
Note:This URL is intended for usewithin a compliant MCP clientvia Streamable HTTP, such as the recommended clients listed in ourGetting Startedsection. It does not support direct access from a web browser and may return a405 Method Not Allowederror if accessed manually. For developers who need to build their own solution, please follow the mandatory guidelines in theBuilding a Custom Clientsection to ensure your implementation is resilient and supported.
{ "servers": { "microsoft-learn": { "type": "http", "url": "https://learn.microsoft.com/api/mcp" } } }
For experimental features, see theExperimental Featuressection below.
The Microsoft Learn MCP Server offers experimental features that are under active development. These features may change or be refined based on user feedback and usage patterns.
For applications that require OpenAI Deep Research model compatibility, you can use the OpenAI-compatible endpoint:
https://learn.microsoft.com/api/mcp/openai-compatible
This endpointsupports OpenAI Deep Research modelsand follows the OpenAI MCP specification.
To manage token usage and control costs, you can append themaxTokenBudgetquery parameter to the MCP endpoint URL. This parameter limits the token count in search tool responses by truncating the content to meet your specified budget.
https://learn.microsoft.com/api/mcp?maxTokenBudget=2000
Note:These experimental features are subject to change. We welcome feedback through ourGitHub Discussions.
# Run instantly (no install) npx @microsoft/learn-cli search "azure functions timeout" # Or install globally npm install -g @microsoft/learn-cli # then use mslearn mslearn search "azure functions timeout"
Pass--jsonto get structured JSON output, useful for programmatic processing:
mslearn search "azure openai" --json | jq '.results[].title'
Seecli/README.mdfor the full command reference.
These agent skills are packed in amicrosoft-docsplugin together with the Learn MCP server itself. If you use Claude Code, run the following command and restart Claude Code:
/plugin install microsoft-docs@claude-plugins-official
Or if you use GitHub Copilot CLI, run this command:
- Install the MCP Server first— SeeInstallationbelow
- Copy the skill foldersto your project's.github/skills/or.claude/skills/directory:
- microsoft-docs— for concepts, tutorials, and factual lookups
- microsoft-code-reference— for API lookups, code samples, and troubleshooting
- microsoft-skill-creator— meta-skill for generating custom skills about Microsoft technologies
Agent Skills work across multiple AI agents:
- VS Code(Insiders) — enablechat.useAgentSkillssetting
- GitHub Copilot CLI&Copilot coding agent
- Claude Code,Cursor,OpenAI Codex, andmore
The Microsoft Learn MCP Server supports quick installation across multiple development environments. Choose your preferred client below for streamlined setup:
{
"Microsoft Learn MCP Server": {
"httpUrl": "https://learn.microsoft.com/api/mcp"
}
}
{
"Microsoft Learn MCP Server": {
"httpUrl": "https://learn.microsoft.com/api/mcp"
}
}
{
"mslearn": {
"type": "http",
"url": "https://learn.microsoft.com/api/mcp",
"tools": [
"*"
]
}
}
{
"mcpServers": {
"microsoft-learn": {
"serverUrl": "https://learn.microsoft.com/api/mcp"
}
}
}
{
"microsoft-learn": {
"url": "https://learn.microsoft.com/api/mcp"
}
}
If your use case requires a direct, programmatic integration, it is essential to understand that MCP is adynamic protocol, not a static API. The available tools and their schemas will evolve.
To build a resilient client that will not break as the service is updated, you should adhere to the following principles:
- Discover Tools Dynamically:Your client should fetch current tool definitions from the server at runtime (e.g., usingtools/list).Do not hard-code tool names or parameters.
- Refresh on Failure:Your client should handle errors duringtool/invokecalls. If a tool call fails with an error indicating it is missing or its schema has changed (e.g., an HTTP 404 or 400 error), your client should assume its cache is stale and automatically trigger a refresh by callingtools/list.
- Handle Live Updates:Your client should listen for server notifications (e.g.,listChanged) and refresh its tool cache accordingly.
Even tool-friendly models like Claude Sonnet 4 sometimes fail to call MCP tools by default; use system prompts to encourage usage.
Here's an example of a Cursor rule (a system prompt) that will cause the LLM to utilizemicrosoft-learnmore frequently:
## Querying Microsoft Documentation You have access to MCP tools called microsoft_docs_search, microsoft_docs_fetch, and microsoft_code_sample_search - these tools allow you to search through and fetch Microsoft's latest official documentation and code samples, and that information might be more detailed or newer than what's in your training data set. When handling questions around how to work with native Microsoft technologies, such as C#, F#, ASP.NET Core, Microsoft.Extensions, NuGet, Entity Framework, the dotnet runtime - please use these tools for research purposes when dealing with specific / narrowly defined questions that may occur.
- Ask questions, share ideas
- Create an issue
- Microsoft Learn MCP Server product documentation
- Microsoft MCP Servers
- Microsoft Learn
- Model Context Protocol Specification
- Microsoft Learn Terms of Use
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Connect AI tools like Cursor and VS Code to your product documentation using the Biel.ai platform.
The official Duck Framework MCP server provides AI assistants with rich, project-aware context for building applications using Duck Framework. It offers documentation retrieval, code guidance, API references, best practices, component discovery, and framework-specific recommendations to help developers generate high-quality Duck Framework projects faster and more accurately.
MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent
One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.
Local stdio MCP server that lets AI coding agents read and maintain structured architecture, rules, and decisions directly from your repository.
Official Context7 MCP server that brings up-to-date, version-specific library documentation and code examples into AI coding prompts.
Remote, no-auth MCP server providing AI-powered codebase context and answers
Create and read feature flags, review experiments, generate flag types, search docs, and interact with GrowthBook's feature flagging and experimentation platform.
Search and evaluate MCP servers from your AI agent: quality grades, live verification status, install commands and client compatibility for 5,000+ servers.
Official MCP server for Stimulsoft Reports & Dashboards documentation. Semantic search across FAQ, Programming Manual, Server/User Manual, and Server/Cloud API for .NET, WPF, Avalonia, WEB, Blazor, Angular, React, JS, PHP, Java, and Python platforms.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





