Mattchenderson review comments

ggailey777 · ggailey777 · commit d582e4941858 · 2025-05-07T11:40:25.000-07:00
diff --git a/articles/azure-functions/TOC.yml b/articles/azure-functions/TOC.yml
@@ -1015,14 +1015,14 @@
             - name: Output
               href: functions-bindings-kafka-output.md
               displayName: Kafka
-        - name: MCP server
+        - name: MCP tool
           items:
             - name: Overview
               href: functions-bindings-mcp.md
-              displayName: MCP server
+              displayName: MCP tool
             - name: Trigger
               href: functions-bindings-mcp-trigger.md
-              displayName: MCP server
+              displayName: MCP tool
         - name: Mobile Apps
           href: functions-bindings-mobile-apps.md
         - name: Notification Hubs
diff --git a/articles/azure-functions/functions-bindings-mcp-trigger.md b/articles/azure-functions/functions-bindings-mcp-trigger.md
@@ -22,7 +22,7 @@ For information on setup and configuration details, see the [overview](functions
 ## Example
 
 ::: zone pivot="programming-language-csharp"  
->[!TIP]  
+>[!NOTE]  
 >The Azure Functions MCP extension supports only the [isolated worker model](dotnet-isolated-process-guide.md). 
 
 This code creates an endpoint to expose a tool named `GetSnippet` that tries to retrieve a code snippet by name from blob storage.
@@ -47,7 +47,7 @@ This code creates an endpoint to expose a tool named `SaveSnippets` that tries t
 For the complete code example, see [Snippets.java](https://github.com/Azure-Samples/remote-mcp-functions-java/blob/main/src/main/java/com/function/Snippets.java).  
 ::: zone-end  
 ::: zone pivot="programming-language-javascript"  
-Example code for JavaScript isn't currently available.
+Example code for JavaScript isn't currently available. See the TypeScript examples for general guidance using Node.js.
 ::: zone-end  
 ::: zone pivot="programming-language-typescript"  
 This code creates an endpoint to expose a tool named `getsnippet` that tries to retrieve a code snippet by name from blob storage.
@@ -99,7 +99,7 @@ See [Usage](#usage) to learn how to define properties of the endpoint as input p
 
 ## Annotations
 
-The `McpTrigger` annotation creates a function that exposes a tool endpoint in your MCP server. 
+The `McpTrigger` annotation creates a function that exposes a tool endpoint in your remote MCP server. 
 
 The annotation supports the following configuration options:
 
@@ -151,7 +151,11 @@ See the [Example section](#example) for complete examples.
 
 ::: zone pivot="programming-language-csharp"  
 
-The MCP protocol enables an MCP server to make known to clients other properties of a tool endpoint. In C#, you can define one or more tool properties by applying the `McpToolProperty` attribute to input binding-style parameters in your function.  
+The MCP protocol enables an MCP server to make known to clients other properties of a tool endpoint. In C#, you can define properties of your tools as either input parameters using the `McpToolProperty` attribute to your trigger function code or by using the `FunctionsApplicationBuilder` when the app starts. 
+
+### [`McpToolPropertyAttribute`](#tab\attribute)
+
+You can define one or more tool properties by applying the `McpToolProperty` attribute to input binding-style parameters in your function.  
 
 The `McpToolPropertyAttribute` type supports these properties:
 
@@ -161,9 +165,21 @@ The `McpToolPropertyAttribute` type supports these properties:
 | **PropertyType** | The data type of the tool property, such as `string`.  |
 | **Description** | (Optional) Description of what the tool property does.  |
 
+You can see these attributes used in the `SaveSnippet` tool in the [Examples](#example).
+
+### [`FunctionsApplicationBuilder`](#tab\builder)
+
+You can define tool properties in your entry point (program.cs) file by using the `McpToolBuilder` returned by the `ConfigureMcpTool` method on `FunctionsApplicationBuilder`. This examples calls the `WithProperty` method on the builder for the `GetSnippet` tool to set the properties of the tool:
+
+:::code language="csharp" source="~/remote-mcp-functions-dotnet/src/Program.cs" range="5-15" ::: 
+
+For the complete example, see the [program.cs file](https://github.com/Azure-Samples/remote-mcp-functions-dotnet/blob/main/src/Program.cs).
+
+---
+
 ::: zone-end  
 ::: zone pivot="programming-language-java,programming-language-python"  
-Properties of a tool exposed by your MCP server are defined using tool properties. These properties are returned by the `toolProperties` field, which is a string representation of an array of `ToolProperty` objects. 
+Properties of a tool exposed by your remote MCP server are defined using tool properties. These properties are returned by the `toolProperties` field, which is a string representation of an array of `ToolProperty` objects. 
 
 A `ToolProperty` object has this structure:
 
@@ -176,7 +192,7 @@ A `ToolProperty` object has this structure:
 ``` 
 ::: zone-end  
 ::: zone pivot="programming-language-javascript,programming-language-typescript"  
-Properties of a tool exposed by your MCP server are defined using tool properties. These properties are returned by the `toolProperties` field, which is a string representation of an array of `ToolProperty` objects. 
+Properties of a tool exposed by your remote MCP server are defined using tool properties. These properties are returned by the `toolProperties` field, which is a string representation of an array of `ToolProperty` objects. 
 
 A `ToolProperty` object has this structure:
 
diff --git a/articles/azure-functions/functions-bindings-mcp.md b/articles/azure-functions/functions-bindings-mcp.md
@@ -1,6 +1,6 @@
 ---
-title: MCP bindings for Azure Functions
-description: Learn how you can expose your functions as a model content protocol (MCP) server using bindings in Azure Functions.
+title: MCP tool bindings for Azure Functions
+description: Learn how you can expose your functions as model content protocol (MCP) tools using bindings in Azure Functions.
 ms.topic: reference
 ms.date: 05/03/2025
 ms.custom: 
@@ -12,18 +12,19 @@ zone_pivot_groups: programming-languages-set-functions
 ---
 
 
-# MCP bindings for Azure Functions overview
+# MCP tool bindings for Azure Functions overview
 
 The [Model Content Protocol (MCP)](https://github.com/modelcontextprotocol) is a client-server protocol intended to enable language models and agents to more efficiently discover and use external data sources and tools. 
 
 [!INCLUDE [functions-mcp-extension-preview-note](../../includes/functions-mcp-extension-preview-note.md)]
 
-The Azure Functions MCP extension allows you to use Azure Functions to create custom MCP servers. Your function app implements an MCP server by defining a set of MCP tool endpoints that are MCP trigger functions. MCP clients, such as language models and agents, can query and access these tools to do specific tasks, such as storing or accessing code snippets. MCP clients can also subscribe to your app to receive notifications about changes to the exposed tools. 
+The Azure Functions MCP extension allows you to use Azure Functions to create remote MCP servers. Your function app implements a remote MCP server by exposing a set of endpoints that are implemented as MCP tool trigger functions. MCP clients, such as language models and agents, can query and access these tools to do specific tasks, such as storing or accessing code snippets. MCP clients can also subscribe to your app to receive notifications about changes to the exposed tools. 
 
 [!INCLUDE [functions-mcp-extension-powershell-note](../../includes/functions-mcp-extension-powershell-note.md)]
-::: zone pivot="programming-language-csharp"
 ## Prerequisites 
 
++ The MCP tool trigger relies on Azure Queue storage provided by the [default host storage account](./storage-considerations.md) (`AzureWebJobsStorage`). When using managed identities, make sure that your function app has at least the equivalent of these role-based permissions in the host storage account: [Storage Queue Data Reader](/azure/role-based-access-control/built-in-roles#storage-queue-data-reader) and [Storage Queue Data Message Processor](/azure/role-based-access-control/built-in-roles#storage-queue-data-message-processor).   
+::: zone pivot="programming-language-csharp"
 + Requires version 2.0.2 or later of the `Microsoft.Azure.Functions.Worker.Sdk` package.  
 
 ## Install extension
@@ -72,14 +73,14 @@ To use this experimental bundle in your app, replace the existing `extensionBund
 
 | Property | Description |
 | ----- | ----- |
-| **instructions** | Describes to clients how to access the server. |
-| **serverName** | A friendly name for the server. |
-| **serverVersion** | Current version of the server. |
+| **instructions** | Describes to clients how to access the remote MCP server. |
+| **serverName** | A friendly name for the remote MCP server. |
+| **serverVersion** | Current version of the remote MCP server. |
 
 
 ## Related articles
 
-[Create a tool endpoint in your MCP server](./functions-bindings-mcp-trigger.md) 
+[Create a tool endpoint in your remote MCP server](./functions-bindings-mcp-trigger.md) 
 
 
 [extension bundle]: ./functions-bindings-register.md#extension-bundles
