Address feedback

Author: stephentoub

src/ModelContextProtocol/Configuration/McpServerBuilderExtensions.cs

@@ -67,4 +67,27 @@ public record ResourceTemplate
     /// </remarks>
     [JsonPropertyName("annotations")]
     public Annotations? Annotations { get; init; }
+
+    /// <summary>Gets whether <see cref="UriTemplate"/> contains any template expressions.</summary>
+    [JsonIgnore]
+    public bool IsTemplated => UriTemplate.Contains('{');
+
+    /// <summary>Converts the <see cref="ResourceTemplate"/> into a <see cref="Resource"/>.</summary>
+    /// <returns>A <see cref="Resource"/> if <see cref="IsTemplated"/> is <see langword="false"/>; otherwise, <see langword="null"/>.</returns>
+    public Resource? AsResource()
+    {
+        if (IsTemplated)
+        {
+            return null;
+        }
+
+        return new()
+        {
+            Uri = UriTemplate,
+            Name = Name,
+            Description = Description,
+            MimeType = MimeType,
+            Annotations = Annotations,
+        };
+    }
 }

src/ModelContextProtocol/Protocol/Types/ResourceTemplate.cs

@@ -92,27 +92,17 @@ public class ResourcesCapability
     /// Gets or sets a collection of resources served by the server.
     /// </summary>
     /// <remarks>
-    /// Resources will specified via <see cref="ResourceCollection"/> augment the <see cref="ListResourcesHandler"/> and
-    /// <see cref="ReadResourceHandler"/>, if provided. ListResources requests will output information about every resource
-    /// in <see cref="ResourceCollection"/> and then also any resources output by <see cref="ListResourcesHandler"/>, if it's
-    /// non-<see langword="null"/>. ReadResource requests will first check <see cref="ResourceCollection"/> for the exact resource
-    /// being requested, will then fall back to <see cref="ResourceTemplateCollection"/> if no exact match could be found, and if the resource 
-    /// is still not found, any specified <see cref="ReadResourceHandler"/> will be invoked as a fallback.
+    /// <para>
+    /// Resources specified via <see cref="ResourceCollection"/> augment the <see cref="ListResourcesHandler"/>, <see cref="ListResourceTemplatesHandler"/>
+    /// and <see cref="ReadResourceHandler"/> handlers, if provided. Resources with template expressions in their URI templates are considered resource templates
+    /// and are listed via ListResourceTemplate, whereas resources without template parameters are considered static resources and are listed with ListResources.
+    /// </para>
+    /// <para>
+    /// ReadResource requests will first check the <see cref="ResourceCollection"/> for the exact resource being requested. If no match is found, they'll proceed to
+    /// try to match the resource against each resource template in <see cref="ResourceCollection"/>. If no match is still found, the request will fall back to
+    /// any handler registered for <see cref="ReadResourceHandler"/>.
+    /// </para>
     /// </remarks>
     [JsonIgnore]
     public McpServerPrimitiveCollection<McpServerResource>? ResourceCollection { get; set; }
-
-    /// <summary>
-    /// Gets or sets a collection of resource templates served by the server.
-    /// </summary>
-    /// <remarks>
-    /// Resource templates will specified via <see cref="ResourceTemplateCollection"/> augment the <see cref="ListResourceTemplatesHandler"/> and
-    /// <see cref="ReadResourceHandler"/>, if provided. ListResourceTemplates requests will output information about every resource template
-    /// in <see cref="ResourceTemplateCollection"/> and then also any resources output by <see cref="ListResourceTemplatesHandler"/>, if it's
-    /// non-<see langword="null"/>. ReadResource requests will first check <see cref="ResourceCollection"/> for the exact resource
-    /// being requested, will then fall back to <see cref="ResourceTemplateCollection"/> if no exact match could be found, and if the resource 
-    /// is still not found, any specified <see cref="ReadResourceHandler"/> will be invoked as a fallback.
-    /// </remarks>
-    [JsonIgnore]
-    public McpServerPrimitiveCollection<McpServerResourceTemplate>? ResourceTemplateCollection { get; set; }
 }