Skip to content

Commit d166fdd

Browse files
Merge pull request #9083 from MicrosoftDocs/users/danhellem/new-mcp-headers-1
Document individual tools and insiders for MCP server
2 parents 4bb5ef8 + da98a9b commit d166fdd

1 file changed

Lines changed: 39 additions & 1 deletion

File tree

docs/mcp-server/remote-mcp-server.md

Lines changed: 39 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ You can also omit the organization name from the URL. However, if you omit the o
7777

7878
### Toolsets
7979

80-
Specify toolsets to restrict the tools available to the MCP server.
80+
Specify toolsets to restrict the tools available to the MCP server. Should not be combined with `X-MCP-Tools`.
8181

8282
```json
8383
{
@@ -142,6 +142,44 @@ Use the `X-MCP-Readonly` header to restrict the server to read-only operations.
142142
}
143143
```
144144

145+
### Individual tools
146+
147+
Use the `X-MCP-Tools` header to enable only specific tools. Should not be combined with `X-MCP-Toolsets`.
148+
149+
```json
150+
{
151+
"servers": {
152+
"ado-remote-mcp": {
153+
"url": "https://mcp.dev.azure.com/{organization}",
154+
"type": "http",
155+
"headers": {
156+
"X-MCP-Tools": "core_list_projects, wit_my_work_items, wit_get_work_items_batch_by_ids"
157+
}
158+
}
159+
},
160+
"inputs": []
161+
}
162+
```
163+
164+
### Insiders
165+
166+
As we experiment and introduce new tools and updates to existing ones, you can get early access to these changes by using the `X-MCP-Insiders` header.
167+
168+
```json
169+
{
170+
"servers": {
171+
"ado-remote-mcp": {
172+
"url": "https://mcp.dev.azure.com/{organization}",
173+
"type": "http",
174+
"headers": {
175+
"X-MCP-Insiders": "true"
176+
}
177+
}
178+
},
179+
"inputs": []
180+
}
181+
```
182+
145183
## Available tools
146184

147185
> [!NOTE]

0 commit comments

Comments
 (0)