Microsoft Learn MCP Server – Official Docs Search
Microsoft Learn MCP Server gives AI agents live access to Microsoft's official technical documentation, full documentation pages, and code samples. Use it when an agent needs authoritative, up-to-date guidance for Microsoft technologies.
Overview
Microsoft Learn MCP Server is Microsoft's hosted Model Context Protocol service for bringing official Microsoft technical content into AI-assisted workflows. It connects compatible agents and development tools to the Microsoft Learn knowledge service, helping them answer product questions with current documentation rather than relying only on model training data.
What the MCP server enables
The server currently exposes tools that let an agent:
- Search Microsoft technical documentation semantically with
microsoft_docs_search. - Fetch a specific Microsoft documentation page and convert it to Markdown with
microsoft_docs_fetch. - Search official Microsoft and Azure code examples with
microsoft_code_sample_search, optionally filtering by programming language.
This is a read-only knowledge integration. It does not manage Microsoft accounts, subscriptions, resources, training progress, or user profile data. The public service contains publicly available documentation and code samples.
When to use it
Use this provider when an agent needs authoritative Microsoft product guidance, API references, configuration instructions, troubleshooting steps, architecture information, or verified code examples. Typical workflows include checking Azure service limits, finding the correct .NET API, retrieving a complete Learn article for analysis, validating an SDK usage pattern, or supporting developers inside tools such as VS Code, Visual Studio, Copilot Studio, Foundry, Cursor, Claude, or Codex.
Connection and authentication
The hosted endpoint uses Streamable HTTP at https://learn.microsoft.com/api/mcp. No API key, login, or custom authorization header is required. The endpoint is intended for MCP clients and agent frameworks, not direct browser access; opening it manually can return 405 Method Not Allowed.
Clients should discover the current tool list at runtime with MCP tool discovery rather than hard-coding schemas. Microsoft notes that the tool set and request or response formats can evolve dynamically.
Key considerations
The service is publicly available and free to use. Its underlying knowledge service refreshes incrementally after content changes and performs a full refresh daily, so updates may not appear immediately. Microsoft also documents throttling of 100 calls per connection per 60 seconds for the connector. Users must comply with the Microsoft Learn Terms of Use, and production clients should handle tool-list changes and refresh cached schemas when calls fail.
Supported Transports
streamable_http
URL: https://learn.microsoft.com/api/mcp
Frequently Asked Questions
- When should an AI agent use the Microsoft Learn MCP Server?
- Use it when an agent needs current, authoritative guidance for Microsoft technologies, such as Azure, .NET, Microsoft 365, SDKs, APIs, service limits, configuration steps, troubleshooting instructions, or official code examples.
- What tools does the Microsoft Learn MCP Server provide?
- Microsoft documents three tools: microsoft_docs_search for semantic documentation search, microsoft_docs_fetch for retrieving a complete Learn page as Markdown, and microsoft_code_sample_search for finding official Microsoft and Azure code samples with an optional language filter.
- What data can the agent access through this server?
- The server provides publicly available Microsoft technical documentation and official code samples. It does not expose Microsoft Learn training records, user profiles, private tenant data, subscriptions, or Azure resources.
- How is authentication configured for the Microsoft Learn MCP Server?
- Authentication is not required. Clients connect directly to the hosted MCP endpoint without an API key, bearer token, login, or custom authorization header. The endpoint should still be treated as a trusted external service.
- Which transport should be used for the Microsoft Learn MCP Server?
- Use the hosted Streamable HTTP endpoint at https://learn.microsoft.com/api/mcp. Microsoft does not document SSE or a local stdio server for this hosted service, and direct browser access is not supported.