Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

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

claude mcp add --transport http microsoft-learn-mcp https://learn.microsoft.com/api/mcp

[mcp_servers.microsoft-learn-mcp]
url = "https://learn.microsoft.com/api/mcp"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "microsoft-learn-mcp": {
      "type": "remote",
      "url": "https://learn.microsoft.com/api/mcp",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "type": "http",
      "url": "https://learn.microsoft.com/api/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=microsoft-learn-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbGVhcm4ubWljcm9zb2Z0LmNvbS9hcGkvbWNwIn0%3D"
}

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

{
  "mcpServers": {
    "microsoft-learn-mcp": {
      "httpUrl": "https://learn.microsoft.com/api/mcp"
    }
  }
}

extensions:
  "microsoft-learn-mcp":
    enabled: true
    name: "microsoft-learn-mcp"
    type: streamable_http
    uri: "https://learn.microsoft.com/api/mcp"
    timeout: 300

Quality 66 / 100needs work

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene79 · weight 30

pass
tools.descriptionsevery tool has a description
warn
tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations3 of 3 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: microsoft_code_sample_search (openWorldHint); microsoft_docs_search (openWorldHint); microsoft_docs_fetch (openWorldHint)
pass
tools.token_costabout 987 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability25 · weight 15

warn
stability.changes30 tool changes in 30 days
fail
stability.rug_pull8 tools kept their name but changed most of their description in 30 days; review before trusting them

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

3 tools, about 987 tokens to load them all · tool set 9b76442abbc7 · tools last changed 2026-10-09 · checked 2026-10-19 22:14 UTC

Tool changes

2026-10-09microsoft_docs_fetchchangedinput schema
2026-10-09microsoft_code_sample_searchchangedinput schema, output schema
2026-10-09microsoft_docs_searchchangedinput schema, output schema
2026-10-09microsoft_docs_fetchchangeddescription, input schemameaning changed
before
Fetch complete content from a Microsoft documentation page and convert to markdown. ## When to Use: - Search results are incomplete or truncated - Need complete procedures, troubleshooting steps, or detailed explanations - Found a highly relevant page in search results ## Workflow: Use after microsoft_docs_search to get full content from high-value pages. ## URL Requirements: Must be a valid microsoft.com domain URL. ## Returns: Markdown with headings, code blocks, tables, and links preserved.
after · 46% of words in common
Fetch and convert a Microsoft Learn documentation webpage to markdown format. This tool retrieves the latest complete content of Microsoft documentation webpages including Azure, .NET, Microsoft 365, and other Microsoft technologies. ## When to Use This Tool - When search results provide incomplete information or truncated content - When you need complete step-by-step procedures or tutorials - When you need troubleshooting sections, prerequisites, or detailed explanations - When search results reference a specific page that seems highly relevant - For comprehensive guides that require full context ## Usage Pattern Use this tool AFTER microsoft_docs_search when you identify specific high-value pages that need complete content. The search tool gives you an overview; this tool gives you the complete picture. ## URL Requirements - The URL must be a valid HTML documentation webpage from the microsoft.com domain - Binary files (PDF, DOCX, images, etc.) are not supported ## Output Format markdown with headings, code blocks, tables, and links preserved.
2026-10-09microsoft_code_sample_searchchangeddescription, input schema
before
Search for code snippets in official Microsoft Learn documentation. Returns relevant code samples with practical implementation examples for Microsoft/Azure products. Helps you use the **LATEST OFFICIAL** code snippets. ## When to Use: - When providing sample Microsoft/Azure related code snippets - When generating any Microsoft/Azure related code ## Usage: Input a descriptive query or SDK/class/method name. Optional 'language' parameter filters results. Eligible languages: csharp, javascript, typescript, python, powershell, azurecli, al, sql, java, kusto, cpp, go, rust, ruby, php.
after · 65% of words in common
Search for code snippets and examples in official Microsoft Learn documentation. This tool retrieves 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 you use the **LATEST OFFICIAL** code snippets to empower coding capabilities. ## When to Use This Tool - When you are going to provide sample Microsoft/Azure related code snippets in your answers. - When you are **generating any Microsoft/Azure related code**. ## Usage Pattern Input a descriptive query, or SDK/class/method name to retrieve related code samples. The optional parameter `language` can help to filter results. Eligible values for `language` parameter include: csharp javascript typescript python powershell azurecli al sql java kusto cpp go rust ruby php
2026-10-09microsoft_docs_searchchangeddescription, input schemameaning changed
before
Search official Microsoft/Azure documentation for the most relevant and trustworthy content. Returns up to 10 high-quality content chunks with title, URL, and excerpt. ## Usage: Always use this tool first to ground answers in official Microsoft/Azure knowledge when facing Microsoft/Azure related questions, then use microsoft_docs_fetch for complete page content when needed.
after · 39% of words in common
Search official Microsoft/Azure documentation to find the most relevant and trustworthy content for a user's query. This tool 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 title, URL, and a self-contained content excerpt optimized for fast retrieval and reasoning. Always use this tool to quickly ground your answers in accurate, first-party Microsoft/Azure knowledge. ## Follow-up Pattern To ensure completeness, 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.
2026-10-09microsoft_docs_fetchchangedinput schema
2026-10-09microsoft_code_sample_searchchangedinput schema
2026-10-09microsoft_docs_searchchangedinput schema
2026-10-08microsoft_docs_fetchchangedinput schema

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 85 / 100

provenance85

liveness100

freshness45

hygiene100

+repository +dns-namespace +website +reachable +uptime-100% -stale-333d

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://learn.microsoft.com/api/mcp` streamable-http	none	yes	100%	771 ms	2025-06-18	2026-10-19

Tools (3)

`microsoft_code_sample_search`read-only	Search for code snippets and examples in official Microsoft Learn documentation. This tool retrieves 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 you use the LATEST OFFICIAL code snippets to empower coding capabilities. ## When to Use This Tool - When you are going to provide sample Microsoft/Azure related code snippets in your answers. - When you are generating any Microsoft/Azure related code. ## Usage Pattern Input a descriptive query, or SDK/class/method name to retrieve related code samples. The optional parameter `language` can help to filter results. Eligible values for `language` parameter include: csharp javascript typescript python powershell azurecli al sql java kusto cpp go rust ruby php
`microsoft_docs_fetch`read-only	Fetch and convert a Microsoft Learn documentation webpage to markdown format. This tool retrieves the latest complete content of Microsoft documentation webpages including Azure, .NET, Microsoft 365, and other Microsoft technologies. ## When to Use This Tool - When search results provide incomplete information or truncated content - When you need complete step-by-step procedures or tutorials - When you need troubleshooting sections, prerequisites, or detailed explanations - When search results reference a specific page that seems highly relevant - For comprehensive guides that require full context ## Usage Pattern Use this tool AFTER microsoft_docs_search when you identify specific high-value pages that need complete content. The search tool gives you an overview; this tool gives you the complete picture. ## URL Requirements - The URL must be a valid HTML documentation webpage from the microsoft.com domain - Binary files (PDF, DOCX, images, etc.) are not supported ## Output Format markdown with headings, code blocks, tables, and links preserved.
`microsoft_docs_search`read-only	Search official Microsoft/Azure documentation to find the most relevant and trustworthy content for a user's query. This tool 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 title, URL, and a self-contained content excerpt optimized for fast retrieval and reasoning. Always use this tool to quickly ground your answers in accurate, first-party Microsoft/Azure knowledge. ## Follow-up Pattern To ensure completeness, 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.

Schemas: list_tools.

Similar MCP servers

More from com.microsoft

And 10 more from this publisher.

Official server.json

{
  "name": "com.microsoft/microsoft-learn-mcp",
  "title": "Microsoft Learn MCP",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
  "remotes": [
    {
      "url": "https://learn.microsoft.com/api/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "1.0.0",
  "repository": {
    "url": "https://github.com/MicrosoftDocs/mcp",
    "source": "github"
  },
  "websiteUrl": "https://github.com/MicrosoftDocs/mcp",
  "description": "Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs."
}