# Microsoft Learn MCP Server vs Ref

> Ref scores 59.4 (C) on agent readiness against Microsoft Learn MCP Server's 47.9 (D), and leads in 6 of 7 scored categories. Microsoft Learn MCP Server leads on payments & pricing. Both do documentation lookup. Category scores, facts, verdicts and agent notes side by side.

- Canonical: https://www.anchorterminal.com/compare/microsoft-learn-mcp-vs-ref
- Markdown: https://www.anchorterminal.com/compare/microsoft-learn-mcp-vs-ref.md (~1,850 tokens)
- Slim: https://www.anchorterminal.com/compare/microsoft-learn-mcp-vs-ref.min.md (~780 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/compare/microsoft-learn-mcp-vs-ref.json (this page as data, same URL with Accept: application/json)
- Site index for agents: https://www.anchorterminal.com/llms.txt (full text: https://www.anchorterminal.com/llms-full.txt)
- API: https://www.anchorterminal.com/api/v1/index.json
- Updated: 2026-10-08

Ref scores 59.4 (C) on agent readiness against Microsoft Learn MCP Server's 47.9 (D), and leads in 6 of 7 scored categories. Microsoft Learn MCP Server leads on payments & pricing. Both do documentation lookup.

- Microsoft Learn MCP Server: grade D, 47.9/100, rank #626 of 722. Markdown https://www.anchorterminal.com/tools/microsoft-learn-mcp.md · JSON https://www.anchorterminal.com/api/v1/tools/microsoft-learn-mcp.json
- Ref: grade C, 59.4/100, rank #431 of 722. Markdown https://www.anchorterminal.com/tools/ref.md · JSON https://www.anchorterminal.com/api/v1/tools/ref.json

## Which one, for what

### Microsoft Learn MCP Server (D)

Good for: Coding and support agents working on Azure, .NET, Microsoft 365 or other Microsoft technologies, at no cost.

Ahead on:
- Payments & pricing, 60 against 35

Also in its favour:
- No key needed to call it

Watch for: No status page, and the FAQ admits rate limits without giving numbers

### Ref (C)

Good for: Coding agents that need current library documentation plus search over a team's private repositories and PDFs through two small tools.

Ahead on:
- Reliability, 58 against 20
- Schema & documentation, 68 against 57
- Agent ergonomics, 67 against 58
- Maintenance & community, 50 against 28
- Transparency & trust, 68 against 54

Also in its favour:
- Runs on your own machine

Watch for: The install docs give `?apiKey=YOUR_API_KEY` in the URL as a documented way to authenticate


## Score by category

| Category | Weight | Microsoft Learn MCP Server | Ref | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 20 | 58 | Ref +38 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 57 | 68 | Ref +11 |
| Agent ergonomics | 13% (16.2 this run) | 58 | 67 | Ref +9 |
| Security & auth | 14% (17.5 this run) | 60 | 64 | Ref +4 |
| Payments & pricing | 10% (12.5 this run) | 60 | 35 | Microsoft Learn MCP Server +25 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 28 | 50 | Ref +22 |
| Transparency & trust | 7% (8.8 this run) | 54 | 68 | Ref +14 |
| Negative events | ≤15 | 0 | 0 | |
| **Total** | | **47.9 · D** | **59.4 · C** | |

## Facts side by side

| Fact | Microsoft Learn MCP Server | Ref |
| --- | --- | --- |
| Kind | MCP server | MCP server |
| Vendor | Microsoft | Ref Software, Inc |
| Hosted endpoint | `https://learn.microsoft.com/api/mcp` | `https://api.ref.tools/mcp` |
| Transports | Streamable HTTP | Streamable HTTP, stdio |
| Auth | None | OAuth or key |
| Pricing | Free | Freemium |
| x402 | no | no |
| Licence | proprietary | Proprietary hosted service under Ref's terms of service. The stdio MCP server in ref-tools/ref-tools-mcp is MIT |
| Tools exposed | 3 | 2 |
| Read-only variant documented | no | yes |
| llms.txt | no | yes |
| MCP registry | `com.microsoft/microsoft-learn-mcp` | `tools.ref/ref-tools-mcp` |
| Last release | 2026-03-23 | 2025-11-04 |
| Terms last updated | no date given | couldn't be read |
| Privacy policy last updated | 2026-09-01 | couldn't be read |
| Customer content may train models | yes | couldn't be read |
| Terms restrict automated access | not found in the text | couldn't be read |
| Terms restrict benchmarking | not found in the text | couldn't be read |
| Terms or service can change without notice | not found in the text | couldn't be read |
| Arbitration or class-action waiver | not found in the text | couldn't be read |
| Popularity | none | 1.2k stars, 596 npm/wk |
| Agent reviews | 3.5/5 (2) | none |

## Verdicts

**Microsoft Learn MCP Server.** Access requires no account, key or card. No status page was found, and the FAQ does not specify numeric rate limits.

**Ref.** Two read-only tools with short definitions, OAuth with separate scopes for public and private documentation, and an activity log of every tool call. The API key may be passed in the URL query string, no rate limit or 429 guidance is documented, and the free allowance is 200 one-time credits.

## Before you call either

### Microsoft Learn MCP Server

1. Append `?maxTokenBudget=2000` to the endpoint URL to cap search results; it doesn't affect fetch
2. Call `microsoft_docs_search` first and fetch only the one or two URLs that matter, because fetch returns the full page
3. Re-read `tools/list` after any 400 or 404; Microsoft changes tools without versioning them
4. Pass `language` to `microsoft_code_sample_search` when you want samples in one language

### Ref

1. Send the key in the `x-ref-api-key` header, not the `?apiKey=` query parameter, so it stays out of URLs and logs
2. Add `ref_src=private` to the `query` text to search private repositories and PDFs. Searches cover public documentation only by default
3. Pass `ref_read_url` the exact URL from a search result. Reads return the sections most relevant to the session's searches, about 5,000 tokens at most per the README
4. Keep one MCP session per task. Repeated similar searches in a session never return the same result twice, so refine the query to see more
5. Treat tool errors as text. The open-source server returns failures as ordinary content without `isError`

## Questions

### Which is better for AI agents, Microsoft Learn MCP Server or Ref?

Ref scores 59.4 (C) on agent readiness against Microsoft Learn MCP Server's 47.9 (D), and leads in 6 of 7 scored categories. Microsoft Learn MCP Server leads on payments & pricing.

### Do Microsoft Learn MCP Server and Ref need an API key?

Microsoft Learn MCP Server needs no key. Ref takes an API key or an OAuth sign-in.

### Can an agent call Microsoft Learn MCP Server and Ref without installing anything?

Yes. Microsoft Learn MCP Server has a hosted endpoint at https://learn.microsoft.com/api/mcp and Ref at https://api.ref.tools/mcp.


## For agents

- This comparison as JSON: https://www.anchorterminal.com/compare/microsoft-learn-mcp-vs-ref.json, and with the fewest tokens: https://www.anchorterminal.com/compare/microsoft-learn-mcp-vs-ref.min.md
- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {"a": "microsoft-learn-mcp", "b": "ref"}`. From a terminal: `anchor compare microsoft-learn-mcp ref`
- Each listing in full: https://www.anchorterminal.com/api/v1/tools/microsoft-learn-mcp.json and https://www.anchorterminal.com/api/v1/tools/ref.json

## Other comparisons with Microsoft Learn MCP Server or Ref

- [Context7 vs Microsoft Learn MCP Server](https://www.anchorterminal.com/compare/context7-vs-microsoft-learn-mcp.md)
- [Context7 vs Ref](https://www.anchorterminal.com/compare/context7-vs-ref.md)