Practical overview
When it fits
Use it when a compatible assistant or terminal workflow needs to retrieve Microsoft documentation or code examples during development, rather than relying only on the model's existing context.
Who it is for
- Developers using MCP-compatible assistants or IDEs who need Microsoft Learn content in an AI workflow.
- Terminal users who want to search Microsoft documentation or code samples without an MCP client.
- Teams configuring Microsoft-focused documentation skills for supported coding agents.
Documented uses
- Search Microsoft technical documentation for answers to API, configuration or conceptual questions.
- Fetch a specific Microsoft documentation page in Markdown for an assistant or tool to use as context.
- Find Microsoft or Azure code samples, with an optional programming-language filter.
- Run documentation queries from a terminal using the Learn CLI.
- Set up Learn-focused skills for supported Copilot, Claude Code or Codex workflows.
Requirements & limits
The README provides a remote endpoint and client setup options, and states that no API key or sign-up is required. The repository is public and specifies a CC-BY-4.0 license. The CLI is available through npm commands shown in the README; experimental endpoint features may change.
- Use the remote MCP service if the chosen IDE or assistant supports MCP over Streamable HTTP; use the CLI if terminal access without an MCP client is preferable.
- The three documented server tools cover documentation search, page retrieval and code-sample search; code-sample search accepts an optional language filter.
- The CLI does not configure agent discovery merely by being installed; the README describes a separate
mslearn setup --cliflow for supported agents. - The OpenAI-compatible endpoint and
maxTokenBudgetparameter are marked experimental in the README.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Search Microsoft Learn from a terminal
Run a documentation search with the Microsoft Learn CLI.
Before you start
- Node.js/npm environment capable of running npx or installing npm packages.
- Terminal access.
Steps
Run the command below to query documentation without installing the package globally.
npx @microsoft/learn-cli search "azure functions timeout"Alternatively, install the CLI with the command below.
npm install -g @microsoft/learn-cliAfter global installation, run
mslearn search "azure functions timeout".
Expected outcome
A terminal query using the CLI's documentation-search function.
Guide limitations
- This guide covers a search query only; it does not configure agent discovery or an MCP client.
- The README describes the CLI as providing the same tools, but this recipe demonstrates only search.
Configure a compatible client for the Microsoft Learn MCP endpoint
Add the remote Microsoft Learn MCP endpoint to an MCP-compatible client.
Before you start
- An IDE, agent or tool that supports MCP and Streamable HTTP.
- Access to that client's MCP server configuration.
Steps
Add an MCP server named
microsoft-learnto the client configuration.Set its type to
httpand its URL tohttps://learn.microsoft.com/api/mcp.Use the client's documented MCP setup flow to connect to the server.
Expected outcome
The client is configured with the Microsoft Learn remote MCP endpoint for access to its documentation and code-sample tools.
Guide limitations
- The endpoint is intended for compliant MCP clients and does not support direct browser access.
- Client-specific setup varies; consult the relevant client's MCP guide.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 13 October 2026
- Original website title
- MicrosoftDocs/mcp · Official homepage title · retained in its source language