Microsoft's official hosted server for searching official Microsoft Learn documentation and code samples, with no API key required.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add microsoft-learn --env QUERY='<QUERY>' -- npx @microsoft/learn-cli search '{{config.QUERY}}'~/.codex/config.toml
[mcp_servers.microsoft-learn]
command = "npx"
args = ["@microsoft/learn-cli", "search", "{{config.QUERY}}"]
env = { QUERY = "<QUERY>" }
# codex mcp add microsoft-learn --env QUERY='<QUERY>' -- npx @microsoft/learn-cli search '{{config.QUERY}}'~/.cursor/mcp.json
{
"mcpServers": {
"microsoft-learn": {
"command": "npx",
"args": [
"@microsoft/learn-cli",
"search",
"{{config.QUERY}}"
],
"env": {
"QUERY": "<QUERY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"microsoft-learn": {
"type": "stdio",
"command": "npx",
"args": [
"@microsoft/learn-cli",
"search",
"{{config.QUERY}}"
],
"env": {
"QUERY": "<QUERY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"microsoft-learn": {
"command": "npx",
"args": [
"@microsoft/learn-cli",
"search",
"{{config.QUERY}}"
],
"env": {
"QUERY": "<QUERY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"microsoft-learn": {
"command": "npx",
"args": [
"@microsoft/learn-cli",
"search",
"{{config.QUERY}}"
],
"env": {
"QUERY": "<QUERY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"microsoft-learn": {
"command": "npx",
"args": [
"@microsoft/learn-cli",
"search",
"{{config.QUERY}}"
],
"env": {
"QUERY": "<QUERY>"
}
}
}
}Remote
claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp~/.codex/config.toml
[mcp_servers.microsoft-learn]
url = "https://learn.microsoft.com/api/mcp"
# codex mcp add microsoft-learn --url https://learn.microsoft.com/api/mcp~/.cursor/mcp.json
{
"mcpServers": {
"microsoft-learn": {
"url": "https://learn.microsoft.com/api/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"microsoft-learn": {
"type": "http",
"url": "https://learn.microsoft.com/api/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"microsoft-learn": {
"httpUrl": "https://learn.microsoft.com/api/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"microsoft-learn": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://learn.microsoft.com/api/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"microsoft-learn": {
"url": "https://learn.microsoft.com/api/mcp"
}
}
}Environment variables
QUERY
Replace the placeholders with your own credentials and keep them out of version control.