{
  "server": "microsoft-learn",
  "url": "https://learn.microsoft.com/api/mcp",
  "date": "2026-10-09",
  "protocolVersion": "2026-07-28",
  "serverInfo": {
    "name": "Microsoft Learn MCP Server",
    "version": "1.0.0"
  },
  "listChangedDeclared": false,
  "toolCount": 3,
  "outputSchemaCoveragePct": 66.66,
  "tools": [
    {
      "annotations": {
        "destructiveHint": false,
        "idempotentHint": true,
        "readOnlyHint": true,
        "title": "Microsoft Code Sample Search"
      },
      "description": "Search for code snippets in official Microsoft Learn documentation.\nReturns relevant code samples with practical implementation examples for Microsoft/Azure products. Helps you use the **LATEST OFFICIAL** code snippets.\n\n## When to Use:\n- When providing sample Microsoft/Azure related code snippets\n- When generating any Microsoft/Azure related code\n\n## Usage:\nInput a descriptive query or SDK/class/method name. Optional 'language' parameter filters results.\n\nEligible languages: csharp, javascript, typescript, python, powershell, azurecli, al, sql, java, kusto, cpp, go, rust, ruby, php.",
      "inputSchema": {
        "properties": {
          "SessionId": {
            "const": "f6cceafe-1ace-451b-adf7-a1ab2a0ded1c",
            "default": "f6cceafe-1ace-451b-adf7-a1ab2a0ded1c",
            "description": "The logical session identifier provided by tools/list; use its default value on every Microsoft Learn tool call",
            "type": [
              "string",
              "null"
            ]
          },
          "language": {
            "default": null,
            "description": "Optional parameter specifying the programming language of code snippets to retrieve. Can significantly improve search quality if provided. Eligible values: csharp javascript typescript python powershell azurecli al sql java kusto cpp go rust ruby php",
            "type": [
              "string",
              "null"
            ]
          },
          "query": {
            "description": "a descriptive query, SDK name, method name or code snippet related to Microsoft/Azure products, services, platforms, developer tools, frameworks, APIs or SDKs",
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "microsoft_code_sample_search",
      "outputSchema": {
        "properties": {
          "SessionId": {
            "type": [
              "string",
              "null"
            ]
          },
          "results": {
            "items": {
              "properties": {
                "codeSnippet": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "content_omitted": {
                  "type": "boolean"
                },
                "description": {
                  "type": "string"
                },
                "language": {
                  "type": "string"
                },
                "link": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "title": "Microsoft Code Sample Search"
    },
    {
      "annotations": {
        "destructiveHint": false,
        "idempotentHint": true,
        "readOnlyHint": true,
        "title": "Microsoft Docs Fetch"
      },
      "description": "Fetch complete content from a Microsoft documentation page and convert to markdown.\n\n## When to Use:\n- Search results are incomplete or truncated\n- Need complete procedures, troubleshooting steps, or detailed explanations\n- Found a highly relevant page in search results\n\n## Workflow:\nUse after microsoft_docs_search to get full content from high-value pages.\n\n## URL Requirements:\nMust be a valid microsoft.com domain URL.\n\n## Returns:\nMarkdown with headings, code blocks, tables, and links preserved.",
      "inputSchema": {
        "properties": {
          "SessionId": {
            "const": "f6cceafe-1ace-451b-adf7-a1ab2a0ded1c",
            "default": "f6cceafe-1ace-451b-adf7-a1ab2a0ded1c",
            "description": "The logical session identifier provided by tools/list; use its default value on every Microsoft Learn tool call",
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "description": "URL of the Microsoft documentation page to read",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "type": "object"
      },
      "name": "microsoft_docs_fetch",
      "title": "Microsoft Docs Fetch"
    },
    {
      "annotations": {
        "destructiveHint": false,
        "idempotentHint": true,
        "readOnlyHint": true,
        "title": "Microsoft Docs Search"
      },
      "description": "Search official Microsoft/Azure documentation for the most relevant and trustworthy content.\nReturns up to 10 high-quality content chunks with title, URL, and excerpt.\n\n## Usage:\nAlways 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.",
      "inputSchema": {
        "properties": {
          "SessionId": {
            "const": "f6cceafe-1ace-451b-adf7-a1ab2a0ded1c",
            "default": "f6cceafe-1ace-451b-adf7-a1ab2a0ded1c",
            "description": "The logical session identifier provided by tools/list; use its default value on every Microsoft Learn tool call",
            "type": [
              "string",
              "null"
            ]
          },
          "query": {
            "default": null,
            "description": "a query or topic about Microsoft/Azure products, services, platforms, developer tools, frameworks, or APIs",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "name": "microsoft_docs_search",
      "outputSchema": {
        "properties": {
          "SessionId": {
            "type": [
              "string",
              "null"
            ]
          },
          "results": {
            "items": {
              "properties": {
                "content": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "contentUrl": {
                  "type": "string"
                },
                "content_omitted": {
                  "type": "boolean"
                },
                "extensionData": {
                  "type": [
                    "object",
                    "null"
                  ]
                },
                "id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "title": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "title": "Microsoft Docs Search"
    }
  ]
}