Flanj drift.flanj.io · daily contract watch

drift.flanj.io / servers / microsoft-learn

Server sheet · docs · anonymous

Microsoft microsoft-learn

4 change events over 48 comparison days: 0 breaking, 14 warning and 5 info findings, each with the two contracts as served behind it.

watched since 2026-08-24 as of 2026-10-15 49 days observed 48 comparison days latest snapshot 2026-10-15

01 / the server

What the watch knows about it.

Microsoftoperator
docskind
anonymousauth posture
3tools listed
49days observed
2025-06-18MCP revision · floor, not ceiling
2 / 3outputSchema declared

Anonymous: the same call the watch makes, minus initialize. A server that answers “session required” insists on initialize first and is alive.

probe
curl -sS 'https://learn.microsoft.com/api/mcp' -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' -H 'mcp-protocol-version: 2025-06-18' --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | sed -n 's/^data: //p; t; /^{/p' | jq '.result.tools[].name'

02 / event timeline — every event, expanded

4 change events, newest first.

2026-10-09 → 2026-10-10 5 warning 5 info 3 tools
3 description-changed3 input-optional-property-removed2 input-type-narrowed2 output-optional-property-removedas served: 2026-10-09 → 2026-10-10on the index
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_code_sample_search description
Search for code snippets and examples in official Microsoft Learn documentation. Returns This tool retrieves relevant code samples from Microsoft documentation pages providing developers with practical implementation examples and best practices for Microsoft/Azure products. Helps products and services related coding tasks. This tool will help you use the **LATEST OFFICIAL** code snippets. snippets to empower coding capabilities. ## When to Use: Use This Tool - When providing you are going to provide sample Microsoft/Azure related code snippets in your answers. - When generating you are **generating any Microsoft/Azure related code code**. ## Usage: Usage Pattern Input a descriptive query query, or SDK/class/method name. Optional 'language' name to retrieve related code samples. The optional parameter filters `language` can help to filter results. Eligible languages: csharp, javascript, typescript, python, powershell, azurecli, al, sql, java, kusto, cpp, go, rust, ruby, php. values for `language` parameter include: csharp javascript typescript python powershell azurecli al sql java kusto cpp go rust ruby php
flap returned to the 2026-10-08 shape — the earlier change
as served: 2026-10-09 → 2026-10-10
info input input-optional-property-removed Depending on whether the new schema forbids unknown fields, a caller still sending it is ignored or rejected; the row says which. #
microsoft_code_sample_search inputSessionId
their contract · 2026-10-09
{"const":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","default":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","description":"The logical session identifier provided by tools…
their contract · 2026-10-10
absent
location
input.SessionId
full fragment
{"const":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","default":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","description":"The logical session identifier provided by tools/list; use its default value on every Microsoft Learn tool call","type":["null","string"]}
as served: 2026-10-09 → 2026-10-10
info input input-type-narrowed A caller sending the dropped type is rejected. #
microsoft_code_sample_search inputlanguage
their contract · 2026-10-09
{"type":["null","string"]}
their contract · 2026-10-10
{"type":"string"}
location
input.language
as served: 2026-10-09 → 2026-10-10
warning output output-optional-property-removed A field the consumer may have been reading is no longer declared. #
microsoft_code_sample_search outputSessionId
their contract · 2026-10-09
{"type":["null","string"]}
their contract · 2026-10-10
absent
location
output.SessionId
as served: 2026-10-09 → 2026-10-10
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_docs_fetch description
Fetch and convert a Microsoft Learn documentation webpage to markdown format. This tool retrieves the latest complete content from a of Microsoft documentation page webpages including Azure, .NET, Microsoft 365, and convert to markdown. other Microsoft technologies. ## When to Use: Use This Tool - Search When search results are provide incomplete information or truncated content - Need When you need complete procedures, step-by-step procedures or tutorials - When you need troubleshooting steps, sections, prerequisites, or detailed explanations - Found When search results reference a specific page that seems highly relevant page in search results - For comprehensive guides that require full context ## Workflow: Usage Pattern Use after this tool AFTER microsoft_docs_search to get full content from when you identify specific high-value pages. pages that need complete content. The search tool gives you an overview; this tool gives you the complete picture. ## URL Requirements: Must Requirements - The URL must be a valid HTML documentation webpage from the microsoft.com domain URL. - Binary files (PDF, DOCX, images, etc.) are not supported ## Returns: Markdown Output Format markdown with headings, code blocks, tables, and links preserved.
flap returned to the 2026-10-08 shape — the earlier change
as served: 2026-10-09 → 2026-10-10
info input input-optional-property-removed Depending on whether the new schema forbids unknown fields, a caller still sending it is ignored or rejected; the row says which. #
microsoft_docs_fetch inputSessionId
their contract · 2026-10-09
{"const":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","default":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","description":"The logical session identifier provided by tools…
their contract · 2026-10-10
absent
location
input.SessionId
full fragment
{"const":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","default":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","description":"The logical session identifier provided by tools/list; use its default value on every Microsoft Learn tool call","type":["null","string"]}
as served: 2026-10-09 → 2026-10-10
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_docs_search description
Search official Microsoft/Azure documentation for to find the most relevant and trustworthy content. Returns content for a user's query. This tool returns up to 10 high-quality content chunks with (each max 500 tokens), extracted from Microsoft Learn and other official sources. Each result includes the article title, URL, and excerpt. ## Usage: a self-contained content excerpt optimized for fast retrieval and reasoning. Always use this tool first to quickly ground your answers in official Microsoft/Azure knowledge when facing accurate, first-party Microsoft/Azure related questions, then knowledge. ## Follow-up Pattern To ensure completeness, use microsoft_docs_fetch for complete page content when needed. high-value pages are identified by search. The fetch tool complements search by providing the full detail. This is a required step for comprehensive results.
flap returned to the 2026-10-08 shape — the earlier change
as served: 2026-10-09 → 2026-10-10
info input input-optional-property-removed Depending on whether the new schema forbids unknown fields, a caller still sending it is ignored or rejected; the row says which. #
microsoft_docs_search inputSessionId
their contract · 2026-10-09
{"const":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","default":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","description":"The logical session identifier provided by tools…
their contract · 2026-10-10
absent
location
input.SessionId
full fragment
{"const":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","default":"f6cceafe-1ace-451b-adf7-a1ab2a0ded1c","description":"The logical session identifier provided by tools/list; use its default value on every Microsoft Learn tool call","type":["null","string"]}
as served: 2026-10-09 → 2026-10-10
info input input-type-narrowed A caller sending the dropped type is rejected. #
microsoft_docs_search inputquery
their contract · 2026-10-09
{"type":["null","string"]}
their contract · 2026-10-10
{"type":"string"}
location
input.query
as served: 2026-10-09 → 2026-10-10
warning output output-optional-property-removed A field the consumer may have been reading is no longer declared. #
microsoft_docs_search outputSessionId
their contract · 2026-10-09
{"type":["null","string"]}
their contract · 2026-10-10
absent
location
output.SessionId
as served: 2026-10-09 → 2026-10-10
2026-10-08 → 2026-10-09 3 warning 3 tools
3 description-changedas served: 2026-10-08 → 2026-10-09on the index
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_code_sample_search description
Search for code snippets and examples in official Microsoft Learn documentation. This tool retrieves Returns relevant code samples from Microsoft documentation pages providing developers with practical implementation examples and best practices for Microsoft/Azure products and services related coding tasks. This tool will help products. Helps you use the **LATEST OFFICIAL** code snippets to empower coding capabilities. snippets. ## When to Use This Tool Use: - When you are going to provide providing sample Microsoft/Azure related code snippets in your answers. - When you are **generating generating any Microsoft/Azure related code**. code ## Usage Pattern Usage: Input a descriptive query, query or SDK/class/method name to retrieve related code samples. The optional name. Optional 'language' parameter `language` can help to filter filters results. Eligible values for `language` parameter include: csharp javascript typescript python powershell azurecli al sql java kusto cpp go rust ruby php languages: csharp, javascript, typescript, python, powershell, azurecli, al, sql, java, kusto, cpp, go, rust, ruby, php.
flap returned to the 2026-10-06 shape — the earlier change
as served: 2026-10-08 → 2026-10-09
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_docs_fetch description
Fetch and convert a Microsoft Learn documentation webpage to markdown format. This tool retrieves the latest complete content of from a Microsoft documentation webpages including Azure, .NET, Microsoft 365, page and other Microsoft technologies. convert to markdown. ## When to Use This Tool Use: - When search Search results provide are incomplete information or truncated content - When you need Need complete step-by-step procedures or tutorials - When you need procedures, troubleshooting sections, prerequisites, steps, or detailed explanations - When search results reference Found a specific page that seems highly relevant - For comprehensive guides that require full context page in search results ## Usage Pattern Workflow: Use this tool AFTER after microsoft_docs_search when you identify specific to get full content from high-value pages that need complete content. The search tool gives you an overview; this tool gives you the complete picture. pages. ## URL Requirements - The URL must Requirements: Must be a valid HTML documentation webpage from the microsoft.com domain - Binary files (PDF, DOCX, images, etc.) are not supported URL. ## Output Format markdown Returns: Markdown with headings, code blocks, tables, and links preserved.
flap returned to the 2026-10-06 shape — the earlier change
as served: 2026-10-08 → 2026-10-09
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_docs_search description
Search official Microsoft/Azure documentation to find for the most relevant and trustworthy content for a user's query. This tool returns content. Returns up to 10 high-quality content chunks (each max 500 tokens), extracted from Microsoft Learn and other official sources. Each result includes the article with title, URL, and a self-contained content excerpt optimized for fast retrieval and reasoning. excerpt. ## Usage: Always use this tool first to quickly ground your answers in accurate, first-party official Microsoft/Azure knowledge. ## Follow-up Pattern To ensure completeness, knowledge when facing Microsoft/Azure related questions, then use microsoft_docs_fetch when high-value pages are identified by search. The fetch tool complements search by providing the full detail. This is a required step for comprehensive results. complete page content when needed.
flap returned to the 2026-10-06 shape — the earlier change
as served: 2026-10-08 → 2026-10-09
2026-10-06 → 2026-10-07 3 warning 3 tools
3 description-changedas served: 2026-10-06 → 2026-10-07on the index
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_code_sample_search description
Search for code snippets and examples in official Microsoft Learn documentation. Returns This tool retrieves relevant code samples from Microsoft documentation pages providing developers with practical implementation examples and best practices for Microsoft/Azure products. Helps products and services related coding tasks. This tool will help you use the **LATEST OFFICIAL** code snippets. snippets to empower coding capabilities. ## When to Use: Use This Tool - When providing you are going to provide sample Microsoft/Azure related code snippets in your answers. - When generating you are **generating any Microsoft/Azure related code code**. ## Usage: Usage Pattern Input a descriptive query query, or SDK/class/method name. Optional 'language' name to retrieve related code samples. The optional parameter filters `language` can help to filter results. Eligible languages: csharp, javascript, typescript, python, powershell, azurecli, al, sql, java, kusto, cpp, go, rust, ruby, php. values for `language` parameter include: csharp javascript typescript python powershell azurecli al sql java kusto cpp go rust ruby php
flap returned to the 2026-10-05 shape — the earlier change
as served: 2026-10-06 → 2026-10-07
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_docs_fetch description
Fetch and convert a Microsoft Learn documentation webpage to markdown format. This tool retrieves the latest complete content from a of Microsoft documentation page webpages including Azure, .NET, Microsoft 365, and convert to markdown. other Microsoft technologies. ## When to Use: Use This Tool - Search When search results are provide incomplete information or truncated content - Need When you need complete procedures, step-by-step procedures or tutorials - When you need troubleshooting steps, sections, prerequisites, or detailed explanations - Found When search results reference a specific page that seems highly relevant page in search results - For comprehensive guides that require full context ## Workflow: Usage Pattern Use after this tool AFTER microsoft_docs_search to get full content from when you identify specific high-value pages. pages that need complete content. The search tool gives you an overview; this tool gives you the complete picture. ## URL Requirements: Must Requirements - The URL must be a valid HTML documentation webpage from the microsoft.com domain URL. - Binary files (PDF, DOCX, images, etc.) are not supported ## Returns: Markdown Output Format markdown with headings, code blocks, tables, and links preserved.
flap returned to the 2026-10-05 shape — the earlier change
as served: 2026-10-06 → 2026-10-07
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_docs_search description
Search official Microsoft/Azure documentation for to find the most relevant and trustworthy content. Returns content for a user's query. This tool returns up to 10 high-quality content chunks with (each max 500 tokens), extracted from Microsoft Learn and other official sources. Each result includes the article title, URL, and excerpt. ## Usage: a self-contained content excerpt optimized for fast retrieval and reasoning. Always use this tool first to quickly ground your answers in official Microsoft/Azure knowledge when facing accurate, first-party Microsoft/Azure related questions, then knowledge. ## Follow-up Pattern To ensure completeness, use microsoft_docs_fetch for complete page content when needed. high-value pages are identified by search. The fetch tool complements search by providing the full detail. This is a required step for comprehensive results.
flap returned to the 2026-10-05 shape — the earlier change
as served: 2026-10-06 → 2026-10-07
2026-10-05 → 2026-10-06 3 warning 3 tools
3 description-changedas served: 2026-10-05 → 2026-10-06on the index
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_code_sample_search description
Search for code snippets and examples in official Microsoft Learn documentation. This tool retrieves Returns relevant code samples from Microsoft documentation pages providing developers with practical implementation examples and best practices for Microsoft/Azure products and services related coding tasks. This tool will help products. Helps you use the **LATEST OFFICIAL** code snippets to empower coding capabilities. snippets. ## When to Use This Tool Use: - When you are going to provide providing sample Microsoft/Azure related code snippets in your answers. - When you are **generating generating any Microsoft/Azure related code**. code ## Usage Pattern Usage: Input a descriptive query, query or SDK/class/method name to retrieve related code samples. The optional name. Optional 'language' parameter `language` can help to filter filters results. Eligible values for `language` parameter include: csharp javascript typescript python powershell azurecli al sql java kusto cpp go rust ruby php languages: csharp, javascript, typescript, python, powershell, azurecli, al, sql, java, kusto, cpp, go, rust, ruby, php.
as served: 2026-10-05 → 2026-10-06
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_docs_fetch description
Fetch and convert a Microsoft Learn documentation webpage to markdown format. This tool retrieves the latest complete content of from a Microsoft documentation webpages including Azure, .NET, Microsoft 365, page and other Microsoft technologies. convert to markdown. ## When to Use This Tool Use: - When search Search results provide are incomplete information or truncated content - When you need Need complete step-by-step procedures or tutorials - When you need procedures, troubleshooting sections, prerequisites, steps, or detailed explanations - When search results reference Found a specific page that seems highly relevant - For comprehensive guides that require full context page in search results ## Usage Pattern Workflow: Use this tool AFTER after microsoft_docs_search when you identify specific to get full content from high-value pages that need complete content. The search tool gives you an overview; this tool gives you the complete picture. pages. ## URL Requirements - The URL must Requirements: Must be a valid HTML documentation webpage from the microsoft.com domain - Binary files (PDF, DOCX, images, etc.) are not supported URL. ## Output Format markdown Returns: Markdown with headings, code blocks, tables, and links preserved.
as served: 2026-10-05 → 2026-10-06
warning wording description-changed The wording an agent reads to choose and call the tool changed; its behaviour may or may not have. #
microsoft_docs_search description
Search official Microsoft/Azure documentation to find for the most relevant and trustworthy content for a user's query. This tool returns content. Returns up to 10 high-quality content chunks (each max 500 tokens), extracted from Microsoft Learn and other official sources. Each result includes the article with title, URL, and a self-contained content excerpt optimized for fast retrieval and reasoning. excerpt. ## Usage: Always use this tool first to quickly ground your answers in accurate, first-party official Microsoft/Azure knowledge. ## Follow-up Pattern To ensure completeness, knowledge when facing Microsoft/Azure related questions, then use microsoft_docs_fetch when high-value pages are identified by search. The fetch tool complements search by providing the full detail. This is a required step for comprehensive results. complete page content when needed.
as served: 2026-10-05 → 2026-10-06

03 / tool inventory · as served on 2026-10-15

3 tools in the latest contract.

From the snapshot as served; descriptions shortened to their first sentence. “Changes” counts this server’s findings on the tool.

Tools in the latest snapshot with their input property counts, outputSchema declaration and finding counts
ToolDescriptionInputsRequiredoutputSchemaAnnotationsChanges
microsoft_code_sample_search Search for code snippets and examples in official Microsoft Learn documentation. 2 1 declared readOnly · idempotent 7
microsoft_docs_fetch Fetch and convert a Microsoft Learn documentation webpage to markdown format. 1 1 none readOnly · idempotent 5
microsoft_docs_search Search official Microsoft/Azure documentation to find the most relevant and trustworthy content for a user's query. 1 0 declared readOnly · idempotent 7