### Install and Run CLI Globally

Source: https://github.com/microsoftdocs/mcp/blob/main/cli/README.md

Install the package globally using npm and execute a search command.

```bash
npm install -g @microsoft/learn-cli
mslearn search "azure functions timeout"
```

--------------------------------

### Install and Use Microsoft Learn CLI Globally

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Install the Microsoft Learn CLI globally using npm for persistent access. After installation, use the `mslearn` command for CLI operations.

```sh
# Or install globally
npm install -g @microsoft/learn-cli
# then use `mslearn`
mslearn search "azure functions timeout"
```

--------------------------------

### Install MCP Server in Cursor IDE

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Click the provided link to install the Microsoft Learn MCP Server directly within Cursor IDE.

```markdown
[![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-000000?style=flat-square&logoColor=white)](https://cursor.com/en/install-mcp?name=microsoft-learn&config=eyJuYW1lIjoibWljcm9zb2Z0LWxlYXJuIiwidHlwZSI6Imh0dHAiLCJ1cmwiOiJodHRwczovL2xlYXJuLm1pY3Jvc29mdC5jb20vYXBpL21jcCJ9)
```

--------------------------------

### Phase 1 - Scope Discovery Queries

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Uses the microsoft_docs_search tool to perform initial discovery for a technology, focusing on overview, concepts, architecture, and getting started tutorials.

```python
microsoft_docs_search(query="{technology} overview what is")
microsoft_docs_search(query="{technology} concepts architecture")
microsoft_docs_search(query="{technology} getting started tutorial")
```

--------------------------------

### Install Microsoft Learn MCP in VS Code

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

One-click installation for Visual Studio Code to integrate Microsoft Learn MCP.

```URL
https://vscode.dev/redirect/mcp/install?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D
```

--------------------------------

### Build and Test from Source

Source: https://github.com/microsoftdocs/mcp/blob/main/cli/README.md

Commands to install dependencies, build the project, and run tests from the source code.

```bash
cd cli
npm install
npm run build
npm test
node dist/index.js --help
```

--------------------------------

### CLI Command Examples

Source: https://github.com/microsoftdocs/mcp/blob/main/cli/README.md

Common usage patterns for searching documentation, fetching pages, and running diagnostics.

```bash
mslearn search "azure functions timeout"
mslearn fetch "https://learn.microsoft.com/azure/azure-functions/functions-versions"
mslearn fetch "https://learn.microsoft.com/azure/azure-functions/functions-versions" --section "Function app timeout duration"
mslearn fetch "https://learn.microsoft.com/azure/azure-functions/functions-versions" --max-chars 3000
mslearn code-search "cosmos db change feed processor"
mslearn code-search "cosmos db change feed processor" --language csharp
mslearn doctor
mslearn doctor --format json
```

--------------------------------

### List Items API Example

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Example of an SDK code snippet for listing items in an API. This typically involves making an HTTP GET request to a specific endpoint.

```csharp
GET https://api.example.com/items
```csharp
var items = await graphClient.Items.Request().GetAsync();
```
```

--------------------------------

### Install MCP Server in VS Code

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Click the provided link to install the Microsoft Learn MCP Server directly within VS Code. Alternatively, search for '@mcp learn' in the VS Code Extensions marketplace.

```markdown
[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D)
```

--------------------------------

### Create Item API Example

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Example of an SDK code snippet for creating an item in an API. This usually involves an HTTP POST request with item data in the body.

```csharp
POST https://api.example.com/items
```csharp
var newItem = new Item { Name = "New Item" };
await graphClient.Items.Request().AddAsync(newItem);
```
```

--------------------------------

### Install Microsoft Learn MCP in VS Code Insiders

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

One-click installation for Visual Studio Code Insiders to integrate Microsoft Learn MCP.

```URL
https://insiders.vscode.dev/redirect/mcp/install?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D&quality=insiders
```

--------------------------------

### Azure Service Skill Template - Provisioning Example

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Demonstrates how to provision an Azure resource using CLI, Portal, or Bicep. This markdown template is for Azure services and cloud resources.

```markdown
```markdown
---
name: {service-name}
description: Work with {Azure Service}. Use when agents need to {primary capabilities}. Covers provisioning, configuration, and SDK usage.
---

# {Azure Service Name}

{One paragraph: what the service does, primary use cases}

## Overview

- **Category**: {Compute/Storage/AI/Networking/etc.}
- **Key capability**: {main value proposition}
- **When to use**: {scenarios}

## Getting Started

### Prerequisites
- Azure subscription
- {Other requirements}

### Provisioning
{CLI/Portal/Bicep snippet for creating the resource}

## SDK Usage ({Language})

### Installation
```
{package install command}
```

### Authentication
```{language}
{auth code pattern}
```

### Basic Operations
```{language}
{CRUD or primary operations}
```

## Key Configurations

| Setting | Purpose | Default |
|---------|---------|---------|
| {setting} | {what it controls} | {value} |

## Pricing & Limits

- **Pricing model**: {consumption/tier-based/etc.}
- **Key limits**: {important quotas}

For current pricing: `microsoft_docs_search(query="{service} pricing")`

## Common Patterns

### {Pattern 1}
{Code or configuration}

### {Pattern 2}
{Code or configuration}

## Troubleshooting

| Issue | Solution |
|-------|----------|
| {Common error} | {Fix} |

For more issues: `microsoft_docs_search(query="{service} troubleshoot {symptom}")`

## Learn More

| Topic | How to Find |
|-------|-------------|
| REST API | `microsoft_docs_fetch(url="{url}")` |
| ARM/Bicep | `microsoft_docs_search(query="{service} bicep template")` |
| Security | `microsoft_docs_search(query="{service} security best practices")` |
```
```

--------------------------------

### Install Microsoft Docs Plugin for GitHub Copilot CLI

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Install the 'microsoftdocs/mcp' plugin for GitHub Copilot CLI. This command enables the Agent Skills within the Copilot CLI environment.

```sh
/plugin install microsoftdocs/mcp
```

--------------------------------

### Semantic Kernel Directory Structure

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Example file structure for a Semantic Kernel skill.

```text
semantic-kernel/
├── SKILL.md
└── sample_codes/
    ├── getting-started/
    │   └── hello-kernel.cs
    └── common-patterns/
        ├── chat-completion.cs
        └── function-calling.cs
```

--------------------------------

### Skill Structure Example

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Illustrates the directory structure for a skill. The SKILL.md file is required and contains frontmatter and instructions. References, sample codes, and assets are organized into respective directories.

```text
skill-name/
├── SKILL.md (required)     # Frontmatter (name, description) + instructions
├── references/             # Documentation loaded into context as needed
├── sample_codes/           # Working code examples
└── assets/                 # Files used in output (templates, etc.)
```

--------------------------------

### Run Microsoft Learn CLI Instantly

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Execute the Microsoft Learn CLI commands directly using npx without a global installation. This is useful for quick, one-off searches.

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

--------------------------------

### Query Effectiveness Examples

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-docs/SKILL.md

Examples of broad versus specific search queries to improve documentation retrieval accuracy.

```text
# ❌ Too broad
"Azure Functions"

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

--------------------------------

### MCP Tool to CLI Command Mapping

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Provides CLI equivalents for Microsoft Learn MCP tools when the Learn MCP server is unavailable. Run with `npx @microsoft/learn-cli <command>` or install globally.

```bash
mslearn search "..."
```

```bash
mslearn code-search "..." --language ...
```

```bash
mslearn fetch "..."
```

--------------------------------

### Install Microsoft Docs Plugin for Claude Code

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Install the 'microsoft-docs' plugin for Claude Code to enable Agent Skills. This command should be run in the Claude Code environment, followed by a restart.

```sh
/plugin install microsoft-docs@claude-plugins-official
```

--------------------------------

### Search for Code Samples

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-code-reference/SKILL.md

Use `microsoft_code_sample_search` to find official, working examples for specific tasks and languages. Useful before writing code, after encountering errors, or when unsure about initialization.

```python
microsoft_code_sample_search(query: "upload file to blob storage", language: "csharp")
```

```python
microsoft_code_sample_search(query: "authenticate with managed identity", language: "python")
```

```python
microsoft_code_sample_search(query: "send message service bus", language: "javascript")
```

--------------------------------

### CLI Alternative Usage

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-docs/SKILL.md

Commands for using the mslearn CLI when the MCP server is unavailable, including direct execution and global installation methods.

```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"
```

--------------------------------

### Investigation Queries for Semantic Kernel

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Example investigation queries for understanding and using the Semantic Kernel.

```text
microsoft_docs_search(query="semantic kernel overview")
microsoft_docs_search(query="semantic kernel plugins functions")
microsoft_code_sample_search(query="semantic kernel", language="csharp")
microsoft_docs_fetch(url="https://learn.microsoft.com/semantic-kernel/overview/")
```

--------------------------------

### Check Node.js Version

Source: https://github.com/microsoftdocs/mcp/blob/main/cli/README.md

Verify that the installed Node.js version meets the requirement of version 22 or later.

```bash
node --version
```

--------------------------------

### Run CLI via npx

Source: https://github.com/microsoftdocs/mcp/blob/main/cli/README.md

Execute the CLI command directly without performing a global installation.

```bash
npx @microsoft/learn-cli search "azure functions timeout"
```

--------------------------------

### Phase 2 - Core Content Fetching

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Fetches full page content using microsoft_docs_fetch and searches for code examples using microsoft_code_sample_search. Requires a URL for the page content and a query with a specified language for code samples.

```python
microsoft_docs_fetch(url="...")  # Fetch pages from Phase 1
microsoft_code_sample_search(query="{technology}", language="{lang}")
```

--------------------------------

### Semantic Kernel SKILL.md Content

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Markdown content for the SKILL.md file, including key concepts, quick start, and further learning resources.

```markdown
# Semantic Kernel

Orchestration SDK for integrating LLMs into applications with plugins, planners, and memory.

## Key Concepts

- **Kernel**: Central orchestrator managing AI services and plugins
- **Plugins**: Collections of functions the AI can call
- **Planner**: Sequences plugin functions to achieve goals
- **Memory**: Vector store integration for RAG patterns

## Quick Start

See [getting-started/hello-kernel.cs](sample_codes/getting-started/hello-kernel.cs)

## Learn More

| Topic | How to Find |
|-------|-------------|
| Plugin development | `microsoft_docs_search(query="semantic kernel plugins custom functions")` |
| Planners | `microsoft_docs_search(query="semantic kernel planner")` |
| Memory | `microsoft_docs_fetch(url="https://learn.microsoft.com/en-us/semantic-kernel/frameworks/agent/agent-memory")` |

## CLI Alternative

If the Learn MCP server is not available, use the `mslearn` CLI instead:

| MCP Tool | CLI Command |
|----------|-------------|
| `microsoft_docs_search(query: "...")` | `mslearn search "..."` |
| `microsoft_code_sample_search(query: "...", language: "...")` | `mslearn code-search "..." --language ...` |
| `microsoft_docs_fetch(url: "...")` | `mslearn fetch "..."` |

Run directly with `npx @microsoft/learn-cli <command>` or install globally with `npm install -g @microsoft/learn-cli`.
```

--------------------------------

### Get Structured JSON Output from CLI

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Use the `--json` flag with the `mslearn search` command to obtain structured JSON output. This is beneficial for programmatic processing of search results, often piped to tools like `jq`.

```sh
mslearn search "azure openai" --json | jq '.results[].title'
```

--------------------------------

### CLI Alternative for Code Reference Tools

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-code-reference/SKILL.md

Use the `mslearn` CLI as an alternative to the MCP server when it's unavailable. Commands map directly to their MCP tool equivalents for searching and fetching documentation.

```sh
# Run directly (no install needed)
npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs"
```

```sh
# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "BlobClient UploadAsync Azure.Storage.Blobs"
```

```sh
mslearn search "..."
```

```sh
mslearn code-search "..." --language ...
```

```sh
mslearn fetch "..."
```

--------------------------------

### Standard MCP Client Configuration

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Standard JSON configuration for connecting to the Microsoft Learn MCP server.

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

--------------------------------

### Configure Gemini CLI for MCP Server

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Add this JSON configuration to your `.gemini/settings.json` file to connect to the Microsoft Learn MCP Server.

```json
{
  "Microsoft Learn MCP Server": {
     "httpUrl": "https://learn.microsoft.com/api/mcp" 
   }
}
```

--------------------------------

### Learn MCP Tool Equivalents

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Maps Microsoft Learn MCP tools to their equivalent mslearn CLI commands for searching documentation and code samples, and fetching page content.

```text
| MCP Tool | CLI Command |
|----------|-------------|
| `microsoft_docs_search(query: "...")` | `mslearn search "..."` |
| `microsoft_code_sample_search(query: "...", language: "...")` | `mslearn code-search "..." --language ...` |
| `microsoft_docs_fetch(url: "...")` | `mslearn fetch "..."` |
```

--------------------------------

### Configure GitHub for MCP Server

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Add this JSON configuration under Settings → Coding agent in GitHub to connect to the Microsoft Learn MCP Server.

```json
{
  "mslearn": {
    "type": "http",
    "url": "https://learn.microsoft.com/api/mcp",
    "tools": [
      "*"
    ]
  }
}
```

--------------------------------

### Search Queries for SDKs/Libraries

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Use these search query patterns to find relevant information about SDKs and libraries.

```text
"{name} overview" → purpose, architecture
"{name} getting started quickstart" → setup steps
"{name} API reference" → core classes/methods
"{name} samples examples" → code patterns
"{name} best practices performance" → optimization
```

--------------------------------

### Search Queries for Frameworks/Platforms

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Use these search query patterns to find relevant information about frameworks and platforms.

```text
"{framework} architecture concepts" → mental model
"{framework} project structure" → conventions
"{framework} tutorial walkthrough" → end-to-end flow
"{framework} configuration options" → customization
```

--------------------------------

### Framework/Platform Skill Template - Project Structure

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Illustrates a typical project structure for development frameworks and platforms. This markdown template is for technologies like ASP.NET, MAUI, or Blazor.

```markdown
```markdown
---
name: {framework-name}
description: Build {type of apps} with {Framework}. Use when agents need to create, modify, or debug {framework} applications.
---

# {Framework Name}

{One paragraph: what it is, what you build with it, why choose it}

## Project Structure

```
{typical-project}/
├── {folder}/     # {purpose}
├── {file}        # {purpose}
└── {file}        # {purpose}
```

## Getting Started

### Create New Project
```bash
{CLI command to scaffold}
```

### Project Configuration
{Key files to configure and what they control}

## Core Concepts

### {Concept 1: e.g., "Components"}
{Explanation with minimal code example}

### {Concept 2: e.g., "Routing"}
{Explanation with minimal code example}

### {Concept 3: e.g., "State Management"}
{Explanation with minimal code example}

## Common Patterns

### {Pattern 1}
```{language}
{code}
```

```

--------------------------------

### ChatGPT Connector Configuration

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Instructions for configuring a custom connector in ChatGPT's advanced settings to use the Microsoft Learn MCP Server.

```text
1. Open ChatGPT in the browser
2. Go to **Settings → Connectors → Advanced settings → Turn Developer mode on**
3. Go back to connectors and click **create**
4. Give the connector a **name**, enter **URL** `https://learn.microsoft.com/api/mcp`, set **authentication** to `No authentication` and **trust** the application
5. Click **create**
```

--------------------------------

### Add MCP Server in Codex

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Use this command to add the Microsoft Learn MCP server in Codex, specifying the URL.

```bash
codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp"
```

--------------------------------

### API Method and Class Lookup

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-code-reference/SKILL.md

Verify the existence of methods, classes, or interfaces by providing their names and namespaces. This helps in confirming API signatures and identifying the correct components.

```text
"BlobClient UploadAsync Azure.Storage.Blobs"
```

```text
"GraphServiceClient Users Microsoft.Graph"
```

```text
"DefaultAzureCredential class Azure.Identity"
```

```text
"Azure Blob Storage NuGet package"
```

```text
"azure-storage-blob pip package"
```

--------------------------------

### mslearn CLI Fallback

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Provides alternative commands using the mslearn CLI when the Learn MCP server is unavailable. It shows how to search documentation and code samples.

```sh
# Run directly (no install needed)
npx @microsoft/learn-cli search "semantic kernel overview"

# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "semantic kernel overview"
```

--------------------------------

### SDK/Library Skill Template - Common Patterns

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Illustrates common usage patterns for SDKs or libraries, such as basic CRUD operations or error handling. This markdown template is intended for client libraries, SDKs, and programming frameworks.

```markdown
```markdown
---
name: {sdk-name}
description: {What it does}. Use when agents need to {primary task} with {technology context}. Supports {languages/platforms}.
---

# {SDK Name}

{One paragraph: what it is, why it exists, when to use it}

## Installation

{Package manager commands for supported languages}

## Key Concepts

{3-5 essential concepts, one paragraph each max}

### {Concept 1}
{Brief explanation}

### {Concept 2}
{Brief explanation}

## Quick Start

{Minimal working example - inline if <30 lines, otherwise reference sample_codes/}

## Common Patterns

### {Pattern 1: e.g., "Basic CRUD"}
```{language}
{code}
```

### {Pattern 2: e.g., "Error Handling"}
```{language}
{code}
```

## API Quick Reference

| Class/Method | Purpose | Example |
|--------------|---------|---------|
| {name} | {what it does} | `{usage}` |

For full API documentation:
- `microsoft_docs_search(query="{sdk} {class} API reference")`
- `microsoft_docs_fetch(url="{url}")`

## Best Practices

- **Do**: {recommendation}
- **Do**: {recommendation}
- **Avoid**: {anti-pattern}

See [best-practices.md](references/best-practices.md) for detailed guidance.

## Learn More

| Topic | How to Find |
|-------|-------------|
| {Advanced topic 1} | `microsoft_docs_search(query="{sdk} {topic}")` |
| {Advanced topic 2} | `microsoft_docs_fetch(url="{url}")` |
| {Code examples} | `microsoft_code_sample_search(query="{sdk} {scenario}", language="{lang}")` |
```
```

--------------------------------

### API/Protocol Skill Documentation

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Template for documenting APIs and protocols.

```APIDOC
--- 
name: {api-name}
description: Interact with {API/Protocol}. Use when agents need to {primary operations}. Covers authentication, endpoints, and common operations.
---

# {API/Protocol Name}

{One paragraph: what it provides access to, primary use cases}

## Authentication

{Auth method and code pattern}

## Base Configuration

- **Base URL**: `{url}`
- **Version**: `{version}`
- **Format**: {JSON/XML/etc.}

## Common Endpoints/Operations

### {Operation 1: e.g., "List Items"}
```
{HTTP method} {endpoint}
```
```{language}
{SDK code}
```

### {Operation 2: e.g., "Create Item"}
```
{HTTP method} {endpoint}
```
```{language}
{SDK code}
```

## Request/Response Patterns

### Pagination
{How to handle pagination}

### Error Handling
{Error format and common codes}

## Quick Reference

| Operation | Endpoint/Method | Notes |
|-----------|-----------------|-|
| {op} | `{endpoint}` | {note} |

## Permissions/Scopes

| Operation | Required Permission |
|-----------|---------------------|-|
| {op} | `{permission}` |

## Learn More

| Topic | How to Find |
|-------|-------------|-|
| Full endpoint reference | `microsoft_docs_fetch(url="{url}")` |
| Permissions | `microsoft_docs_search(query="{api} permissions {resource}")` |
| SDKs | `microsoft_docs_search(query="{api} SDK {language}")` |
```

--------------------------------

### Configure Windsurf for MCP Server

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Add this JSON configuration to your Windsurf settings to connect to the Microsoft Learn MCP Server.

```json
{
  "mcpServers": {
    "microsoft-learn": {
      "serverUrl": "https://learn.microsoft.com/api/mcp"
    }
  }
}
```

--------------------------------

### Encourage LLM Tool Usage with System Prompt

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Use this system prompt in Cursor rules to encourage LLMs to utilize MCP tools for querying Microsoft documentation. This is particularly useful for models that may not call tools by default.

```markdown
## Querying Microsoft Documentation

You have access to MCP tools called `microsoft_docs_search`, `microsoft_docs_fetch`, and `microsoft_code_sample_search` - these tools allow you to search through and fetch Microsoft's latest official documentation and code samples, and that information might be more detailed or newer than what's in your training data set.

When handling questions around how to work with native Microsoft technologies, such as C#, F#, ASP.NET Core, Microsoft.Extensions, NuGet, Entity Framework, the `dotnet` runtime - please use these tools for research purposes when dealing with specific / narrowly defined questions that may occur.
```

--------------------------------

### Search Microsoft Code Samples

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Use this function to search for code samples related to a specific framework and scenario.

```python
microsoft_code_sample_search(query="{framework} {scenario}")
```

--------------------------------

### Configure Kiro for MCP Server

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

Add this JSON configuration to your Kiro settings to connect to the Microsoft Learn MCP Server.

```json
{
  "microsoft-learn": {
    "url": "https://learn.microsoft.com/api/mcp"
    }
}
```

--------------------------------

### Validation Workflow Steps

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-code-reference/SKILL.md

A three-step workflow to validate code before generating it with Microsoft SDKs: confirm existence, fetch details, and find samples. For simple lookups, only the first step might be necessary.

```python
microsoft_docs_search(query: "[ClassName] [MethodName] [Namespace]")
```

```python
microsoft_docs_fetch(url: "...")
```

```python
microsoft_code_sample_search(query: "[task]", language: "[lang]")
```

--------------------------------

### Phase 3 - Deeper Topic Search

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Utilizes microsoft_docs_search to find information on best practices and troubleshooting for a given technology.

```python
microsoft_docs_search(query="{technology} best practices")
microsoft_docs_search(query="{technology} troubleshooting errors")
```

--------------------------------

### Semantic Kernel SKILL.md Frontmatter

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Frontmatter for the SKILL.md file, defining the skill's name and description.

```markdown
---
name: semantic-kernel
description: Build AI agents with Microsoft Semantic Kernel. Use for LLM-powered apps with plugins, planners, and memory in .NET or Python.
---
```

--------------------------------

### Search API SDKs

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Use this function to search for SDKs available for a specific API and programming language.

```python
microsoft_docs_search(query="{api} SDK {language}")
```

--------------------------------

### Fetch URL Content

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Use this function to fetch content from a given URL. It is useful for retrieving detailed documentation or specifications.

```python
microsoft_docs_fetch(url="{url}")
```

--------------------------------

### Troubleshoot API Errors with Search

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-code-reference/SKILL.md

Use `microsoft_docs_search` and `microsoft_code_sample_search` to diagnose and resolve common errors such as 'Method not found', 'Type not found', or 'Wrong signature'.

```text
"[ClassName] methods [Namespace]"
```

```text
"[TypeName] NuGet package namespace"
```

```text
"[ClassName] [MethodName] overloads"
```

```text
"[OldType] migration v12"
```

```text
"DefaultAzureCredential troubleshooting"
```

```text
"[ServiceName] RBAC permissions"
```

--------------------------------

### Default API Endpoint

Source: https://github.com/microsoftdocs/mcp/blob/main/cli/README.md

The default URL used by the CLI to connect to the Microsoft Learn MCP server.

```text
https://learn.microsoft.com/api/mcp
```

--------------------------------

### Configure Endpoint in PowerShell

Source: https://github.com/microsoftdocs/mcp/blob/main/cli/README.md

Set the MSLEARN_ENDPOINT environment variable to override the default API URL.

```powershell
$env:MSLEARN_ENDPOINT = "https://learn.microsoft.com/api/mcp"
mslearn doctor
```

--------------------------------

### Output JSON Responses

Source: https://github.com/microsoftdocs/mcp/blob/main/cli/README.md

Retrieve raw JSON output for programmatic processing with tools like jq.

```bash
mslearn search "azure functions" --json | jq '.results[].title'
mslearn code-search "BlobServiceClient" --language python --json
```

--------------------------------

### Generated Skill Structure

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Defines the expected directory structure for a generated skill, including the SKILL.md file, a references directory, and a sample_codes directory with subdirectories for different code types.

```text
{skill-name}/
├── SKILL.md                    # Core knowledge + Learn MCP guidance
├── references/                 # Detailed local documentation (if needed)
└── sample_codes/               # Working code examples
    ├── getting-started/
    └── common-patterns/
```

--------------------------------

### Manual Configuration for Cline MCP Server

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

When manually configuring Cline for MCP, use the 'streamableHttp' type.

```json
"type": "streamableHttp"
```

--------------------------------

### Search Queries for Azure Services

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/SKILL.md

Use these search query patterns to find relevant information about Azure services.

```text
"{service} overview features" → capabilities
"{service} quickstart {language}" → setup code
"{service} REST API reference" → endpoints
"{service} SDK {language}" → client library
"{service} pricing limits quotas" → constraints
```

--------------------------------

### Search Microsoft Docs

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Use this function to search for documentation on Microsoft Docs. It takes a query string as input.

```python
microsoft_docs_search(query="{framework} deploy {target}")
```

--------------------------------

### Microsoft Learn MCP Server Endpoint

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

The remote MCP endpoint for accessing Microsoft official documentation.

```URL
https://learn.microsoft.com/api/mcp
```

--------------------------------

### Validate Repository Configuration

Source: https://github.com/microsoftdocs/mcp/blob/main/AGENTS.md

Executes the repository validation script to ensure sync rules, file structures, and marketplace wiring are correct.

```powershell
pwsh -File scripts/validate-repo.ps1
```

--------------------------------

### OpenAI-Compatible MCP Endpoint

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

The OpenAI-compatible endpoint for applications requiring OpenAI Deep Research model compatibility.

```URL
https://learn.microsoft.com/api/mcp/openai-compatible
```

--------------------------------

### Search API Permissions

Source: https://github.com/microsoftdocs/mcp/blob/main/skills/microsoft-skill-creator/references/skill-templates.md

Use this function to search for information about API permissions required for a specific resource.

```python
microsoft_docs_search(query="{api} permissions {resource}")
```

--------------------------------

### MCP Endpoint with Token Budget Control

Source: https://github.com/microsoftdocs/mcp/blob/main/README.md

MCP endpoint URL with the maxTokenBudget query parameter to limit token count in search tool responses.

```URL
https://learn.microsoft.com/api/mcp?maxTokenBudget=2000
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.