microsoft_docs_search returns a stale chunk for a page that microsoft_docs_fetch serves current
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 25/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- typescript
Research direction
The payload names no source files. Start by finding where microsoft_docs_search results are indexed and how contentUrl is attached to chunks, then compare that with the path microsoft_docs_fetch uses to read the same URL. Reproduce by running both tools on the Entra Agent ID page and checking whether search returns a chunk older than the live page. Done means search chunks for changed or redirected URLs are refreshed or removed, which needs a maintainer decision on re-index versus drop.
Written by the indexing model from the issue text.
Description
microsoft_docs_search returns a chunk attributed to a Learn URL whose live content has changed. microsoft_docs_fetch on the same URL returns the current page.
Page
Steps to reproduce
- Call
microsoft_docs_searchwith the queryMicrosoft Entra Agent ID is currently in PREVIEW. - Look at the first result. Its
contentUrlis the page above, and its title is "What is Microsoft Entra Agent ID?". The chunk has an "Important" notice saying Microsoft Entra Agent ID "is currently in PREVIEW". - Call
microsoft_docs_fetchon the same URL.
Expected
The search chunk matches what fetch returns for that URL.
Actual
- Fetch returns the current "What is Microsoft Entra Agent ID?" overview. It has no preview notice and says Agent ID "is available for all Microsoft Entra customers".
- With another query, the search also returned a "How to get started" chunk under the same URL. That chunk says Agent ID is available through the Frontier program and needs a Microsoft 365 Copilot license.
- The same search response contradicts the stale chunk. It includes the Entra "What's new" April 2026 entry announcing general availability, and "What's new in Microsoft Entra Agent ID", which says the product "is now generally available".
Why it matters
Clients often use search results without fetching the full page. A stale chunk that still says "PREVIEW" and gives retired licensing guidance leads readers to the wrong product status and the wrong licensing.
Suggestion
- Re-index, or drop, search chunks for URLs whose content has changed or that now redirect. In this case, refresh the chunks under the
identity-professional/microsoft-entra-agent-identities-for-ai-agentsURL. - More generally, a last-indexed date on each search result would let callers spot stale entries.
I reproduced this on October 31, 2026, with two different queries.
- Dominant language
- TypeScript
- Stars
- 2k
- Forks
- 288
- Avg merge
- 4m
- Merged PRs (30d)
- 1
Getting set up
This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from MicrosoftDocs/mcp
-
Difficulty 5/5 Over a week Newbie friendliness 15/100
MicrosoftDocs/mcp#230 ·
Maintainers usually reply within 1 day
-
Add MCP configuration instructions for Antigravity IDE and Antigravity CLI to READMEPossibly taken @vksampath claimed this 23 days ago. Open
Difficulty 1/5 1-3 hours Newbie friendliness 35/100
MicrosoftDocs/mcp#221 ·
Maintainers usually reply within 1 day
-
For theOpen
MicrosoftDocs/mcp#211 ·
Maintainers usually reply within 1 day
-
UpdatedOpen
Difficulty 5/5 Over a week Newbie friendliness 10/100
MicrosoftDocs/mcp#208 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 10/100
MicrosoftDocs/mcp#204 · 1 comment ·
Maintainers usually reply within 1 day
All issues in MicrosoftDocs/mcp
Similar issues
-
bot:ai-assisted component:platform-js status:untriaged
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
midnightntwrk/platform-js#69 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
Picolab/pico-engine#668 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Maintainers usually reply within 1 day
-
ai-driven-qa bug claude Cosmetic
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 1 day
-
needs verification
Difficulty 2/5 1-3 hours Newbie friendliness 64/100
Maintainers usually reply within 13 days