Microsoft Learn Remote MCP Server
Microsoft's official Learn MCP server streams trusted, up-to-date documentation for Azure, .NET, Microsoft 365 and the full Microsoft technical catalog directly into agent context. Endpoint verified live on RemoteMCP.net (preflighted 200 OK).
- Provider
- Microsoft โ
- Categories
- ๐ Documentation, Search & Context
ไธญๆ็ฎไป
Microsoft Learn ๅฎๆนๆ็ฎก็่ฟ็จ MCP ๆๅกๅจใๅพฎ่ฝฏๅฎๆน Learn MCP ๆๅกๅจ๏ผๅฐ Azureใ.NETใMicrosoft 365 ็ญๆๆฐๅฎๆนๆๆกฃ็ดๆฅๆณจๅ ฅไปฃ็ไธไธๆใๅ ฌๅผๅ ้ดๆใ
Maintainer of Microsoft Learn? Claim or update this listing โ
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"microsoft-learn": {
"url": "https://learn.microsoft.com/api/mcp"
}
}
}claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"microsoft-learn": {
"type": "http",
"url": "https://learn.microsoft.com/api/mcp"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://learn.microsoft.com/api/mcp - No authentication needed โ tools are available immediately.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"microsoft-learn": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://learn.microsoft.com/api/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"microsoft-learn": {
"serverUrl": "https://learn.microsoft.com/api/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"microsoft-learn": {
"url": "https://learn.microsoft.com/api/mcp"
}
}
}Add to ~/.codex/config.toml โ Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.microsoft-learn] url = "https://learn.microsoft.com/api/mcp"
Add to cline_mcp_settings.json (Cline โ MCP Servers โ Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"microsoft-learn": {
"type": "streamableHttp",
"url": "https://learn.microsoft.com/api/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers โ httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"microsoft-learn": {
"httpUrl": "https://learn.microsoft.com/api/mcp"
}
}
}๐งฐ Microsoft Learn MCP Tools & Schema (3)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| microsoft_docs_search ~245 tok | ๐ข Readidempotent | 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. | query: string |
| microsoft_code_sample_search ~385 tok | ๐ข Readidempotent | 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 | query*: stringlanguage: string |
| microsoft_docs_fetch ~321 tok | ๐ข Readidempotent | 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. | url*: string |
๐ก๏ธ Security, Quality & Context Token Audit
Every tool definition (name + description + input schema) is injected into your LLMโs context on every request โ Estimate per-call LLM token cost โ
- No prompt-injection or hidden-character anomalies detected in tool descriptions
- Streamable HTTP primary endpoint (current 2025-03-26 transport)
- Public read-only-friendly endpoint โ no credentials stored client-side
- Official first-party endpoint operated by the vendor
- Manually verified by RemoteMCP.net
๐ OAuth 2.1 & Security
- Auth type
- None (public)
- Dynamic Client Registration
- โ
- PKCE S256
- โ
- Protected resource metadata
- https://learn.microsoft.com/.well-known/oauth-protected-resource (expected location)
๐งฉ Recommended Agent Skills
๐ Microsoft Learn MCP Endpoint Overview & Security Guide
Microsoft Learn โ Remote MCP Server
Microsoft's official Learn MCP server streams trusted, up-to-date documentation for Azure, .NET, Microsoft 365 and the full Microsoft technical catalog directly into agent context. The remote endpoint means there is nothing to install โ point your MCP client at the URL and start calling tools right away. Microsoft operates and versions the server themselves, so tool coverage tracks their API surface as it ships.
Official Microsoft Learn Endpoint & Transport Architecture
- Endpoint URL:
https://learn.microsoft.com/api/mcp - Transport: Streamable HTTP
Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. Microsoft Learn does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.
Authentication, Scopes & Permission Boundaries
Microsoft Learn is public and unauthenticated โ no OAuth, no API key, no headers. Any MCP client can connect and call its tools directly, which also makes it a great endpoint for smoke-testing your own MCP client or proxy.
All 3 cataloged tools are read-only โ Microsoft Learn cannot mutate your account data, which makes it safe to connect broadly.
Common Troubleshooting & Connection Tips
- "Session expired" / stale
Mcp-Session-Idโ just re-sendinitialize; stateless clients can ignore session headers entirely.
๐ How to Connect
- Copy the Microsoft Learn endpoint URLThe remote endpoint is https://learn.microsoft.com/api/mcp.
- Add it to your MCP clientClaude Code:
claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp. Cursor: add"microsoft-learn": { "url": "https://learn.microsoft.com/api/mcp" }undermcpServersin ~/.cursor/mcp.json. Other clients work similarly. - Verify with the online inspectorPaste https://learn.microsoft.com/api/mcp into remotemcp.net/inspector, run initialize and tools/list, and confirm Microsoft Learn's 3 tools respond.
โ FAQ
What is the Microsoft Learn remote MCP endpoint?
The primary endpoint is https://learn.microsoft.com/api/mcp. It is an official first-party server operated by Microsoft, speaking the Streamable HTTP transport.
How do I authenticate with Microsoft Learn?
You don't โ Microsoft Learn is public and unauthenticated. Connect and start calling tools; no OAuth flow or API key is needed.
I'm getting a 401 Unauthorized from Microsoft Learn โ what's wrong?
Microsoft Learn is authless, so a 401 is unusual. Check that you're hitting https://learn.microsoft.com/api/mcp exactly (including the path) and not an API endpoint that requires a different credential.
Which MCP clients work with Microsoft Learn?
Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp`), VS Code Copilot, ChatGPT connectors, Windsurf, Kiro (`~/.kiro/settings/mcp.json`), and Claude Desktop via the `mcp-remote` bridge.
What tools does Microsoft Learn expose?
3 tools are cataloged in this directory โ including `microsoft_docs_search`, `microsoft_docs_fetch`, `microsoft_code_sample_search`. Use our online inspector to fetch the live tool list straight from the endpoint.
๐ Connect Guides
๐ Embed Status Badge in README
Related Servers
AWS Knowledge's hosted remote MCP server. AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. It is public and unauthenticated โ connect and call tools immediately.
Claude Skills's hosted remote MCP server. ClaudeSkills.club's public MCP lets agents search and pull from a catalog of 90,000+ Agent Skills (SKILL.md) โ workflow specs, safety scores and one-line install instructions. It is public and unauthenticated โ connect and call tools immediately.
Cloudflare's free, authless documentation MCP server. Agents can search the full Cloudflare docs corpus โ no account or token required.
Cognition Devin's free DeepWiki MCP. Ask questions and read AI-generated wiki documentation for any public GitHub repository โ no auth required.