microsoftdocs/mcp

microsoft-docs

Understand Microsoft technologies by querying official documentation.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/microsoftdocs/mcp --skill microsoft-docs

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Microsoft Docs

Tools

ToolUse For
microsoft_docs_searchFind documentation—concepts, guides, tutorials, configuration
microsoft_docs_fetchGet full page content (when search excerpts aren't enough)

When to Use

  • Understanding concepts — "How does Cosmos DB partitioning work?"
  • Learning a service — "Azure Functions overview", "Container Apps architecture"
  • Finding tutorials — "quickstart", "getting started", "step-by-step"
  • Configuration options — "App Service configuration settings"
  • Limits & quotas — "Azure OpenAI rate limits", "Service Bus quotas"
  • Best practices — "Azure security best practices"

Query Effectiveness

Good queries are specific:

# ❌ Too broad
"Azure Functions"

# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"Container Apps scaling rules KEDA"

Include context:

  • Version when relevant (.NET 8, EF Core 8)
  • Task intent (quickstart, tutorial, overview, limits)
  • Platform for multi-platform docs (Linux, Windows)

When to Fetch Full Page

Fetch after search when:

  • Tutorials — need complete step-by-step instructions
  • Configuration guides — need all options listed
  • Deep dives — user wants comprehensive coverage
  • Search excerpt is cut off — full context needed

Why Use This

  • Accuracy — live docs, not training data that may be outdated
  • Completeness — tutorials have all steps, not fragments
  • Authority — official Microsoft documentation

CLI Alternative

If the Learn MCP server is not available, use the mslearn CLI from the command line instead:

sh
# Run directly (no install needed)
npx @microsoft/learn-cli search "azure functions timeout"

# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "azure functions timeout"
MCP ToolCLI Command
microsoft_docs_search(query: "...")mslearn search "..."
microsoft_docs_fetch(url: "...")mslearn fetch "..."

The fetch command also supports --section <heading> to extract a single section and --max-chars <number> to truncate output.

Related by task

from this repository

More skills

All skills