DEV.co
RAG Frameworks · MicrosoftDocs

mcp

Microsoft Learn MCP Server is a free, no-auth connector that links AI assistants and development tools directly to official Microsoft documentation and code samples via the Model Context Protocol. It eliminates hallucinations by replacing generic web search with curated, first-party Microsoft technical resources.

Source: GitHub — github.com/MicrosoftDocs/mcp
1.8k
GitHub stars
211
Forks
TypeScript
Primary language
CC-BY-4.0
License (Requires review (not clearly OSI))

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

FieldValue
RepositoryMicrosoftDocs/mcp
OwnerMicrosoftDocs
Primary languageTypeScript
LicenseCC-BY-4.0 — Requires review (not clearly OSI)
Stars1.8k
Forks211
Open issues16
Latest releaseUnknown
Last updated2026-06-20
Sourcehttps://github.com/MicrosoftDocs/mcp

What mcp is

A TypeScript-based MCP server exposing three tools—semantic doc search, page fetch, and code sample search—over HTTP and CLI. Connects to https://learn.microsoft.com/api/mcp with optional token-budget control and experimental OpenAI-compatible endpoints. Includes agent skills for Claude, Copilot, and Cursor.

Quickstart

Get the mcp source

Clone the repository and explore it locally.

terminalbash
git clone https://github.com/MicrosoftDocs/mcp.gitcd mcp# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

AI-assisted Azure/Microsoft development

Ensure Claude, Copilot, or Cursor provide accurate, up-to-date Azure SDK/CLI references and .NET best practices without hallucinating deprecated APIs or non-existent methods.

Rapid documentation lookup in coding workflows

Developers can quickly fetch Microsoft docs and code samples from within their IDE or terminal (mslearn CLI) to verify syntax, limits, and implementation patterns without context-switching.

Supply-chain risk mitigation for LLM integrations

Organizations standardizing on 1st-party Microsoft docs reduce exposure to outdated or malicious web sources in AI agent decisions, particularly valuable for compliance-heavy environments.

Implementation considerations

  • No API keys or authentication required; deployment is minimal (one-click install in VS Code or npm install for CLI).
  • Experimental features (token budgeting, OpenAI-compatible endpoint) are subject to change; treat as preview and monitor for updates.
  • MCP clients must support Streamable HTTP; direct browser access returns 405 errors. Verify your IDE/agent is MCP-compliant before deployment.
  • Three agent skills provided (microsoft-docs, microsoft-code-reference, microsoft-skill-creator) to guide AI behavior; consider which skills fit your workflows.
  • CLI (npx @microsoft/learn-cli) is available for programmatic access via shell; --json flag enables structured scripting.

When to avoid it — and what to weigh

  • Non-Microsoft technology stack — If your primary stack is AWS, GCP, or open-source non-Microsoft technologies, this tool adds no value; consider general RAG or competing cloud-provider documentation connectors.
  • Requirement for persistent, versioned documentation snapshots — This server is live-connected to Microsoft Learn. If you need to freeze documentation at a specific date or version for compliance, you will need custom archival logic.
  • Offline-only or air-gapped deployments — The HTTP MCP endpoint requires live internet connectivity to https://learn.microsoft.com/api/mcp. No on-premises or offline mode is documented.
  • Complex multi-language or non-English documentation needs — Not clearly stated whether the server searches or surfaces non-English Microsoft docs; confirm coverage before relying on it for non-English-speaking teams.

License & commercial use

Licensed under CC-BY-4.0 (Creative Commons Attribution 4.0 International). This is a content/documentation license, not a software license.

CC-BY-4.0 permits derivative works and commercial use, but requires attribution. However, this is a content license applied to a TypeScript tool. For commercial integration, clarify whether the license applies to the server code, the documentation it surfaces, or both. Review with legal before shipping in proprietary products. The service is free and no-auth, but no SLA or commercial support is documented.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

SignalAssessment
MaintenanceActive
DocumentationStrong
License clarityNeeds review
Deployment complexityLow
DEV.co fitStrong
Assessment confidenceHigh
Security considerations

Live HTTP connection to Microsoft-controlled endpoint. No authentication required, reducing key-rotation risk but relying on HTTPS and Microsoft's server security. Endpoint validates MCP client protocol; direct browser access is blocked (405 errors). Supply-chain benefit is that docs sourced only from Microsoft's official 1st-party domain, not user-supplied URLs or web scraping. No vulnerability disclosure policy or security audit results provided in data.

Alternatives to consider

OpenAI Documentation Retrieval (custom ChatGPT + web search)

General-purpose LLM with web search; covers broader documentation but lacks curated 1st-party source guarantee and may hallucinate or pull stale/malicious sources.

AWS or GCP MCP servers (if cloud-specific)

If your stack is AWS or GCP, their official MCP servers provide equivalent 1st-party doc access and may integrate better with their SDKs and tools.

Self-hosted RAG (Retrieval-Augmented Generation)

Full control over doc versions, offline mode, multi-cloud support, and custom indexing, but requires infrastructure, DevOps, and ongoing maintenance.

Software development agency

Build on mcp with DEV.co software developers

One-click add to VS Code or run npx @microsoft/learn-cli now. Free, no auth, trusted Microsoft docs for your AI agents.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

Related on DEV.co

Explore the category and the services that help you build with it.

mcp FAQ

Do I need an API key or Microsoft account to use this?
No. The server is completely free and requires no keys, logins, or sign-ups. One-click install in VS Code or npx in terminal.
What if I'm using a non-VS-Code editor or agent?
Use the CLI (npx @microsoft/learn-cli) for standalone access, or configure any MCP-compatible client with the HTTP config: {"type": "http", "url": "https://learn.microsoft.com/api/mcp"}.
Can I run this offline or on-premises?
No. The server is a live remote HTTP endpoint hosted by Microsoft. Offline or air-gapped deployments are not supported.
Is there SLA or commercial support?
Not documented. This is a free community tool maintained by Microsoft Docs; support is via GitHub Discussions and Issues, not guaranteed SLA.

Work with a software development agency

DEV.co is a software development agency delivering custom software development services to companies building on open source. Our software developers and web developers design, integrate, and ship production systems — spanning web development, APIs, AI, data, and cloud. If mcp is part of your rag frameworks roadmap, our team can implement, customize, migrate, and maintain it.

Eliminate AI Hallucinations—Install Today

One-click add to VS Code or run npx @microsoft/learn-cli now. Free, no auth, trusted Microsoft docs for your AI agents.