Skip to content

Add Experimental Features section documenting maxTokenBudget and OpenAI-compatible endpoint #99

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
TianqiZhang merged 5 commits into from
Jan 12, 2026
+25 −1
Merged

Add Experimental Features section documenting maxTokenBudget and OpenAI-compatible endpoint #99

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
d1df39d
Initial plan
Copilot Jan 9, 2026
fd552e0
Add Experimental Features section with maxTokenBudget and OpenAI-comp…
Copilot Jan 9, 2026
9158fbe
Refine token budget description to be more precise
Copilot Jan 9, 2026
4fcb86c
Remove configuration example to simplify experimental features docume…
Copilot Jan 9, 2026
ace60f4
Remove redundant line about truncating responses
Copilot Jan 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 25 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,31 @@ https://learn.microsoft.com/api/mcp
}
```

**OpenAI-compatible endpoint** [supports OpenAI Deep Research models](https://platform.openai.com/docs/mcp): use `https://learn.microsoft.com/api/mcp/openai-compatible`.
For experimental features, see the [Experimental Features](#-experimental-features) section below.

## 🧪 Experimental Features

The Microsoft Learn MCP Server offers experimental features that are under active development. These features may change or be refined based on user feedback and usage patterns.

### OpenAI-Compatible Endpoint

For applications that require OpenAI Deep Research model compatibility, you can use the OpenAI-compatible endpoint:

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

This endpoint [supports OpenAI Deep Research models](https://platform.openai.com/docs/mcp) and follows the OpenAI MCP specification.

### Token Budget Control

To manage token usage and control costs, you can append the `maxTokenBudget` query parameter to the MCP endpoint URL. This parameter limits the token count in search tool responses by truncating the content to meet your specified budget.

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

> **Note:** These experimental features are subject to change. We welcome feedback through our [GitHub Discussions](https://github.com/MicrosoftDocs/mcp/discussions).

## 🛠️ Currently Supported Tools

Expand Down