# Reported issues for Microsoft Learn

Pod holds 21 of 45 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [Microsoft Learn](/mcp/microsoft-learn).

## Most discussed

### HTTP 429 rate limit

I've seen this over the past few days. Just a single call, without any others over the past 1-12 hours, gets rate limited. This is with Claude Managed Agents.

Request:
{
  "evaluated_permission": "allow",
  "id": "...",
  "input": {
    "query": "Dynamics 365 Sales standard entities lead opportunity quote quotedetail product pricelevel territory account contact"
  },
  "mcp_server_name": "microsoft-learn",
  "name": "microsoft_docs_search",
  "processed_at": "2026-04-14T15:20:16.555Z",
  "type"

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/152) · 2026-04-14 · closed · external user · 8 comments

### Tool call issue from Claude

Tool call issue from Claude (Dekstop/Chat/Code/Web). Rate-limiting?

Recreational use from a home IP. Works from other apps such as ChatGPT.

<img width="1510" height="228" alt="Image" src="https://github.com/user-attachments/assets/63c4d64d-bd84-40b1-a9ed-6e2258f04009" />

<img width="1546" height="514" alt="Image" src="https://github.com/user-attachments/assets/1e0889f3-1ad0-4aa9-b363-e2ff409ebbf6" />

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/135) · 2026-03-23 · closed · external user · 12 comments

### Microsoft Learn MCP not working anymore

This mcp server worked well, untill around first of march. I reinstalled it from mcp browser in vs code but that did not change anything. 

My configuration is : 
```json
"servers": {
        "microsoftdocs/mcp": {
            "type": "http",
            "url": "https://learn.microsoft.com/api/mcp",
        }
    }
```

after starting the server it returns an error: 

```
2026-03-10 10:24:08.887 [info] Starting server microsoftdocs/mcp
2026-03-10 10:24:08.888 [info] Connection state: Starting
20

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/118) · 2026-03-10 · closed · external user · 7 comments

### Need configuration or parameter to control how many results the MCP server should return

Currently, the MCP server always returns 10 results, which consume too many tokens unnecessarily.
Is there a way to configure the number of results the MCP server should return? Maybe via a parameter in the MCP server URL.

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/82) · 2025-10-16 · closed · external user · 13 comments

### Invalid parameter `query` on `microsoft_docs_search`

https://github.com/MicrosoftDocs/mcp/blob/cd0912bda8b3f99359c492b37a17daa378683f76/README.md?plain=1#L65
Hi team. Isn't the correct parameter `question` ?

I used ModelContextProtocol SDK version `0.3.0-preview.3`. ([NuGet](https://www.nuget.org/packages/ModelContextProtocol/0.3.0-preview.3))
When I used `query` as a parameter as in the following code, an error occurred. (included in response)

```csharp
var response = await mcpClient.CallToolAsync("microsoft_docs_search", new Dictionary<string,

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/49) · 2025-07-31 · closed · external user · 12 comments

### Feature request: Implement MCP `search` and `fetch` tools for MCP Server to support openai platform specification

Similar to discussion #42, based on https://platform.openai.com/docs/mcp
---
### Description
The MCP server must implement two tools to work with deep research: `search` and `fetch`.

### Tool specifications

#### Search tool
The `search` tool is used by deep research models (and others) to return a list of possibly relevant search results from the dataset exposed by the MCP server.

**Arguments:**
- A single query string.

**Returns:**
- An array of objects with the following properties:
  - `i

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/44) · 2025-07-09 · closed · external user · 7 comments

### mcp-remote no longer able to connect

The `README.md` contains directions for clients that don't support Streamable HTTP yet, but those directions are no longer valid. It seems some form of data protection is blocking requests (I tried another node-based http->stdio adapter but had the same issue).

> stderr: [70012] Connection error: Error: Error POSTing to endpoint (HTTP 500): The key {a92859ef-53e3-497c-a0dd-2daa2da44557} was not found in the key ring. For more information go to https://aka.ms/aspnet/dataprotectionwarning

After 

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/40) · 2025-06-28 · closed · external user · 21 comments

### Behind corporate proxy getting error while sending message to learn.microsoft.com/api/mcp

Greetings,

I am trying the new MicrosoftDocs mcp server in VS Code.

However, after installing it, am seeing this error message:

```
2025-06-13 11:44:16.283 [info] Starting server microsoft.docs.mcp
2025-06-13 11:44:16.285 [info] Connection state: Starting
2025-06-13 11:44:16.298 [info] Starting server from LocalProcess extension host
2025-06-13 11:44:16.341 [info] Connection state: Running
2025-06-13 11:44:17.876 [info] Connection state: Error Error sending message to https://learn.microsoft.

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/5) · 2025-06-13 · closed · external user · 7 comments

## Most recent

### Duplicate Responses When Using Microsoft Learn Docs MCP Server Alongside Knowledge Sources

# Microsoft Learn Docs MCP Server Generates Separate Response Instead of Being Synthesized with Knowledge Sources

TL;DR Copilot Studio Agent does not synthesize Microsoft Learn Docs MCP Server results with other knowledge sources and instead generates a separate MCP-based response.

## Description

I added the **Microsoft Learn Docs MCP Server** as a tool to a **Copilot Studio agent** that already has other knowledge sources configured (for example, Azure AI Search–based knowledge sources).

Af

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/176) · 2026-06-30 · closed · external user · 1 comment

### Microsoft Learn Plugin

In [Copilot Cowork](https://learn.microsoft.com/en-us/microsoft-365/copilot/cowork/) there is a capability to create a plugin ([learn documentation](https://learn.microsoft.com/en-us/microsoft-365/copilot/cowork/cowork-plugin-development)) which can contain a MCP Server and one or more skills. Would love to see Microsoft Learn as an [out of the box plugin](https://learn.microsoft.com/en-us/microsoft-365/copilot/cowork/cowork-available-plugins) in Copilot Cowork.

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/171) · 2026-06-12 · open · external user · 1 comment

### Add source/product field to search result output

**Problem**: The \mslearn search --json\ output includes title, url, and content, but the source product or technology area (e.g., Azure, .NET, VS Code) is not explicitly surfaced. LLMs must infer it from the URL or content, which is unreliable.

**Solution**: Include a \product\ or \source\ field in the search result JSON output, derived from the document metadata already available in the Learn API.

**Use case**: An agent using \mslearn search --json | jq\ to filter results by product before d

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/170) · 2026-06-06 · open · external user · 2 comments

### Installation trouble and will not start

I have tried to install this server using a few methods that fail

Copilot command /plugin install microsoftdocs/mcp "failed to locate the exact name pair" and suggests alternatives.

Extension search for @mcp learn fails to return any results

I installed it directly from extensions when searching for full name, however it would not start with the following messages returned:

2026-06-03 08:38:03.466 [info] Starting server from LocalProcess extension host
2026-06-03 08:38:03.467 [info] Connecti

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/168) · 2026-06-03 · open · external user · 1 comment

### Docs for Web Search MCP server incorrect

At https://mcp.azure.com/?vendors.microsoft=true the listing for Web Search MCP URL is shown as https://placeholder.mcp.microsoft.com/web-search ... "placeholder" obviously incorrect.

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/167) · 2026-06-03 · closed · external user · 1 comment

### "Empty Response from Connector" Error in the Tools section when trying to use the Microsoft learn docs mcp in the copilot studio agent.

We have a customer who is observing an issue when adding this MCP server to their copilot agent. When they try to add the Microsoft docs MCP they are getting the below error in the tools section and resources section.
 
<img width="867" height="592" alt="Image" src="https://github.com/user-attachments/assets/891af569-cd58-41d8-ad1d-2b5b7fdbac20" />

 
The behavior persists even they turned off the tool and refreshed it again post turning on.
 
From the network trace, observed the below response 

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/154) · 2026-04-20 · closed · external user · 1 comment

### AEO Score: 45/100 — How AI agents discover this MCP server

## AEO Score: 45/100

Hi! I scanned the Microsoft Learn MCP Server with [Clarvia](https://clarvia.art).

**Score: 45/100**

Clarvia's AEO measures how easily AI agents discover and use MCP servers across dimensions: tool descriptions, error handling, structured outputs, and agent-discovery endpoints.

Badge for README:

```markdown
[![AEO Score](https://clarvia.art/api/badge/mcp-context-forge)](https://clarvia.art/scan?url=https://github.com/MicrosoftDocs/mcp)
```

Full report: https://clarvia.a

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/141) · 2026-04-01 · closed · external user · 0 comments

### how do I report subject matter errors in responses?

My colleague used MS Learn MCP to answer a set of questions from his customer. When checking the responses manually, I found a number of subject matter errors. Is there a place/channel to report these?

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/131) · 2026-03-17 · closed · external user · 1 comment

### MCP server DEBUG log spam

Is there a reason why the MCP server spams `MCP server "microsoft_learn": No token data found` every second in Claude Code?

<img width="984" height="284" alt="Image" src="https://github.com/user-attachments/assets/95408ad2-b88f-4722-bc72-643c86737fe0" />

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/128) · 2026-03-13 · closed · external user · 2 comments

### Add an MCP tool/resource for searching official Azure and Microsoft architecture icons

## Summary

It would be very helpful if Microsoft Learn MCP exposed an MCP tool/resource for searching and retrieving official Azure architecture icons.

## Why this matters

A common use case for Learn MCP is helping generate architecture diagrams from official Microsoft documentation. In that workflow, access to official Azure icons would be extremely valuable because the resource type becomes immediately recognizable in the diagram.

## Proposed capability

Please add a tool/resource that can

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/115) · 2026-03-08 · open · external user · 3 comments

### Read pdf's? Currently if microsoft_docs_fetch_article model hits maxtokens

The microsoft_docs_search sometimes returns pdf's but when trying to fetch with the 'microsoft_docs_fetch_article' the model hits maxtokens (tested with gpt-5.1, 400k context window)

The pdf was not very large it, it's this one:
https://www.microsoft.com/content/dam/microsoft/final/en-us/microsoft-brand/documents/Modern-Work-Plan-Comparison-SMB-1-16-2024.pdf

It's probably complicated but I just ask as a "wish" if it would be possible to add a tool that reads pdf's, as markdown maybe? Or in a f

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/109) · 2026-02-04 · open · external user · 5 comments

### [bug] the newly added `microsoft-skill-creator` skill is not listed in README agent skills section

`microsoft-skill-creator` skill was added under skills folder, but it is not mentioned in README.

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/107) · 2026-01-30 · closed · outside contributor · 0 comments

### [Feature Request] - Include preview/staging doc in the doc search result

Hey, team
I am from [Azure App Configuration](https://learn.microsoft.com/en-us/azure/azure-app-configuration/) team. My team invest a lot on maintaining our public docs. 
We are currently working on an AI evaluation initiative to assess whether AI agents, when equipped with the MS Learn MCP tools, can correctly answer product-specific questions based on our documentation. The results of this evaluation will help us identify gaps and improve our content quality, making our doc more AI-friendly.

[Read the thread](https://github.com/MicrosoftDocs/mcp/issues/104) · 2026-01-20 · closed · external user · 2 comments