Apply suggestions from code review

Co-authored-by: Dan Barr <[email protected]>

Author: JAORMX

docs/toolhive/guides-k8s/tool-config.mdx

@@ -10,7 +10,7 @@ description:
 Use the MCPToolConfig Custom Resource Definition (CRD) to centrally manage which
 tools an MCP server exposes, and optionally rename tools or override their
 descriptions. You reference the configuration from an MCPServer using the
-toolConfigRef field.
+`toolConfigRef` field.
 
 - toolsFilter: allow‑list the tools to expose.
 - toolsOverride: rename tools and/or change their descriptions.
@@ -19,13 +19,6 @@ toolConfigRef field.
 - Precedence: toolConfigRef takes precedence over the deprecated spec.tools
   field on MCPServer.
 
-## Prerequisites
-
-- ToolHive operator installed. See
-  [Deploy the operator using Helm](./deploy-operator-helm.md).
-- Permissions to create namespaced resources (and optionally RBAC for servers
-  that need cluster access).
-
 ## Define a basic tool filter
 
 This example exposes only three tools on a server:
@@ -75,12 +68,15 @@ spec:
       description: Merge a GitHub pull request
 ```
 
+The key in the `toolsOverride` object is the _original tool name_, while the
+`name` field contains the _new name_ that clients will see.
+
 ## Reference the configuration from an MCP server
 
 Add toolConfigRef to your MCPServer. toolConfigRef overrides spec.tools
 (deprecated).
 
-```yaml title="mcpserver-with-toolconfig.yaml"
+```yaml {12-13} title="mcpserver-with-toolconfig.yaml"
 apiVersion: toolhive.stacklok.dev/v1alpha1
 kind: MCPServer
 metadata:

docs/toolhive/guides-mcp/k8s.mdx

@@ -180,10 +180,13 @@ spec:
     - '--read-write=true'
 ```
 
-:::info[Configure tools] To filter or rename the tools exposed by your MCP
-server on Kubernetes, use the MCPToolConfig CRD and reference it from your
-MCPServer with the `toolConfigRef` field. See
+:::info[Configure tools]
+
+To filter or rename the tools exposed by your MCP server on Kubernetes, use the
+MCPToolConfig CRD and reference it from your MCPServer with the `toolConfigRef`
+field. See
 [Configure tools for MCP servers on Kubernetes](../guides-k8s/tool-config.mdx).
+
 :::
 
 </TabItem>