Microsoft Learn MCP Server: All Tools and Schemas

Introduction

The Microsoft Learn MCP Server provides AI-powered access to official Microsoft and Azure documentation, enabling assistants to ground their answers in accurate, first-party knowledge. It connects directly to Microsoft Learn and other trusted Microsoft sources, ensuring responses are always based on the latest official content.

The server offers three complementary tools focused on documentation retrieval and code assistance. These include searching documentation for relevant content chunks, fetching complete webpages in markdown format, and retrieving official code samples for Microsoft/Azure development tasks.

Together, these tools help developers, IT professionals, and learners get trustworthy answers, step-by-step guidance, and practical code examples across the entire Microsoft ecosystem—including Azure, .NET, Microsoft 365, and Copilot technologies.

Use Cases

1. Grounding answers in official Microsoft documentation

Quickly search across Microsoft Learn to find relevant, accurate content for any Microsoft/Azure question, ensuring responses reflect first-party knowledge.

Sample prompt: How do I configure managed identities for an Azure App Service to access Azure Key Vault?

2. Retrieving complete tutorials and step-by-step guides

When a search result is truncated or highly relevant, fetch the full documentation page to get comprehensive procedures, prerequisites, and troubleshooting details.

Sample prompt: Give me the complete step-by-step tutorial for deploying a containerized app to Azure Kubernetes Service, including all prerequisites.

3. Generating code with the latest official samples

Retrieve up-to-date, official code snippets when writing Microsoft/Azure related code, filtered by your preferred programming language.

Sample prompt: Show me a C# code sample for uploading a file to Azure Blob Storage using the latest Azure.Storage.Blobs SDK.

4. Comparing services and making architecture decisions

Search documentation to understand differences between Microsoft services and get authoritative guidance for architectural choices.

Sample prompt: What's the difference between Azure Functions and Azure Logic Apps, and when should I use each based on official Microsoft guidance?

5. Troubleshooting errors with authoritative sources

Search and fetch detailed troubleshooting sections from Microsoft docs to resolve specific errors or configuration issues.

Sample prompt: I'm getting a "403 Forbidden" error when calling the Microsoft Graph API. Find the official troubleshooting steps to fix this.

6. Learning SDK and API usage patterns

Combine documentation search with code sample retrieval to fully understand how to use a specific SDK, class, or method.

Sample prompt: Explain how to use the Azure OpenAI Python SDK to create chat completions, and include a working code example.

7. PowerShell and Azure CLI automation scripting

Retrieve official command-line samples for automating Azure resource management and administrative tasks.

Sample prompt: Give me a PowerShell script to create a new Azure resource group and deploy a virtual machine into it using official examples.

8. Exploring new Microsoft features and best practices

Search the latest documentation to stay current with new capabilities and recommended best practices across Microsoft products.

Sample prompt: What are the current best practices for securing a .NET 8 web API with Microsoft Entra ID authentication?

Details

MCP Server URL:

https://learn.microsoft.com/api/mcp

Type:

HTTP Stream

Authentication:

None

How to connect this MCP server

Tools

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.

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 Learn MCP Server