Update MCP server documentation for toolsets and tools

danhellem · web-flow · commit da98a9b9cd10 · 2026-03-31T14:08:42.000-04:00
Clarify restrictions on toolsets and tools usage in MCP server documentation.
diff --git a/docs/mcp-server/remote-mcp-server.md b/docs/mcp-server/remote-mcp-server.md
@@ -77,7 +77,7 @@ You can also omit the organization name from the URL. However, if you omit the o
 
 ### Toolsets
 
-Specify toolsets to restrict the tools available to the MCP server.
+Specify toolsets to restrict the tools available to the MCP server. Should not be combined with `X-MCP-Tools`.
 
 ```json
 {
@@ -144,7 +144,7 @@ Use the `X-MCP-Readonly` header to restrict the server to read-only operations.
 
 ### Individual tools
 
-Use the `X-MCP-Tools` header to enable specific tools. Should not be combined with `X-MCP-Toolsets`.
+Use the `X-MCP-Tools` header to enable only specific tools. Should not be combined with `X-MCP-Toolsets`.
 
 ```json
 {
@@ -163,7 +163,7 @@ Use the `X-MCP-Tools` header to enable specific tools. Should not be combined wi
 
 ### Insiders
 
-As we experiment and provide new tools and changes to existing tools, you can get early access to those changes with the `X-MCP-Insiders` header.
+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.
 
 ```json
 {

Original file line number	Diff line number	Diff line change
`@@ -77,7 +77,7 @@ You can also omit the organization name from the URL. However, if you omit the o`
`77`	`77`
`78`	`78`	`### Toolsets`
`79`	`79`
`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`.
`81`	`81`
`82`	`82`	```json
`83`	`83`	`{`
@@ -144,7 +144,7 @@ Use the `X-MCP-Readonly` header to restrict the server to read-only operations.
`144`	`144`
`145`	`145`	`### Individual tools`
`146`	`146`
`147`		-Use the `X-MCP-Tools` header to enable specific tools. Should not be combined with `X-MCP-Toolsets`.
	`147`	+Use the `X-MCP-Tools` header to enable only specific tools. Should not be combined with `X-MCP-Toolsets`.
`148`	`148`
`149`	`149`	```json
`150`	`150`	`{`
@@ -163,7 +163,7 @@ Use the `X-MCP-Tools` header to enable specific tools. Should not be combined wi
`163`	`163`
`164`	`164`	`### Insiders`
`165`	`165`
`166`		-As we experiment and provide new tools and changes to existing tools, you can get early access to those changes with the `X-MCP-Insiders` header.
	`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`	`167`
`168`	`168`	```json
`169`	`169`	`{`