Share via

Microsoft Learn MCP Server developer reference documentation

This article provides information for developers implementing the Microsoft Learn Docs Model Context Protocol (MCP) Server. We also recommend checking out the Learn MCP Server best practices, release notes, and frequently asked questions articles to support your development journey.

MCP Endpoint

Learn MCP Server is a remote MCP server that uses streamable http. Compatible client apps like GitHub Copilot can connect with the endpoint. You can use this url in a tool like MCP Inspector.

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

Common format to configure MCP servers in integrated development environments.

{
  "microsoft.docs.mcp": {
    "type": "http",
    "url": "https://learn.microsoft.com/api/mcp"
  }
}

Note

Although the Learn MCP Server provides a public endpoint, it is not an Application Programming Interface (API) in the traditional sense. Developers should use an agent framework to communicate with the MCP Server, not access the endpoint directly.

Tools

We encourage developers to integrate with the MCP server through an agent framework like Semantic Kernel or LangChain. Every time the client initializes the server, it should call list tool to get a tool list. Over time the list and the tools may change, so we are deliberately not describing request and response details here.

The MCP Server provides the following tools:

  • microsoft_docs_search - This tool accepts a search string and returns up to 10 high-quality content chunks (each max 500 tokens), with article titles, URLs, and self-contained content excerpts.

Next steps

You can learn more about the Learn MCP Server by visiting the following links: