pulsemcp-cms-admin-mcp-server 0.9.2 → 0.9.5

package/build/shared/src/pulsemcp-admin-client/lib/get-proctor-runs.js

@@ -56,6 +56,8 @@ export async function getProctorRuns(apiKey, baseUrl, params) {
             num_tools: run.num_tools,
             packages: run.packages,
             remotes: run.remotes,
+            known_missing_init_tools_list: run.known_missing_init_tools_list || false,
+            known_missing_auth_check: run.known_missing_auth_check || false,
         })),
         pagination: {
             current_page: data.meta.current_page,

package/build/shared/src/tools/list-proctor-runs.js

@@ -151,6 +151,12 @@ Use cases:
                     if (run.remotes.length > 0) {
                         content += `   Remotes: ${run.remotes.join(', ')}\n`;
                     }
+                    if (run.known_missing_init_tools_list) {
+                        content += `   Known Missing Init Tools List: yes\n`;
+                    }
+                    if (run.known_missing_auth_check) {
+                        content += `   Known Missing Auth Check: yes\n`;
+                    }
                     content += '\n';
                 }
                 return { content: [{ type: 'text', text: content.trim() }] };

package/build/shared/src/tools/save-mcp-implementation.js

@@ -24,9 +24,9 @@ const PARAM_DESCRIPTIONS = {
     github_repo: 'GitHub repository name (without owner prefix).',
     github_subfolder: 'Subfolder path within the repository, for monorepos. Omit for root-level projects.',
     // Remote endpoints
-    remote: 'Array of remote endpoint configurations for MCP servers. Each remote can have: id (existing remote ID or blank for new), url_direct, url_setup, transport (e.g., "sse"), host_platform (e.g., "smithery"), host_infrastructure (e.g., "cloudflare"), authentication_method (e.g., "open"), cost (e.g., "free"), status (defaults to "live"), display_name, and internal_notes.',
+    remote: 'Array of remote endpoint configurations for MCP servers. Providing this replaces ALL existing remotes. Omitting leaves them unchanged. Pass an empty array to delete all. Each remote can have: id (existing remote ID or blank for new), url_direct, url_setup, transport (e.g., "sse"), host_platform (e.g., "smithery"), host_infrastructure (e.g., "cloudflare"), authentication_method (e.g., "open"), cost (e.g., "free"), status (defaults to "live"), display_name, and internal_notes.',
     // Canonical URLs
-    canonical: 'Array of canonical URL configurations. Each entry must have: url (the canonical URL), scope (one of "domain", "subdomain", or "url"), and optional note for additional context.',
+    canonical: 'Array of canonical URL configurations. Providing this replaces ALL existing canonical URLs. Omitting leaves them unchanged. Pass an empty array to delete all. Each entry must have: url (the canonical URL), scope (one of "domain", "subdomain", or "url"), and optional note for additional context.',
     // Flags
     verified_no_remote_canonicals: 'Mark that this server has been verified to have no remote canonical URLs (true = verified no remote canonicals exist, false = reset/canonicals found)',
     // Other fields
@@ -106,14 +106,17 @@ export function saveMCPImplementation(_server, clientFactory) {
 **Creating a new implementation:**
 - Omit the \`id\` field to create a new implementation
 - Required fields for creation: \`name\`, \`type\` (either "server" or "client")
+- Remote endpoints and canonical URLs CAN be included on creation
 
 **Updating an existing implementation:**
 - Provide the \`id\` field to update an existing implementation
-- Only provided fields will be updated; omitted fields remain unchanged
+- Only provided fields will be updated; **omitted fields remain unchanged**
+- Omitting \`remote\` or \`canonical\` leaves existing values unchanged (does NOT clear them)
+- Providing \`remote: []\` or \`canonical: []\` (empty array) will DELETE all existing entries
 
 All business logic from the Rails controller is applied (validation, associations, callbacks).
 
-Example request (CREATE new implementation):
+Example request (CREATE with remote endpoints and canonical URLs):
 {
   "name": "My New MCP Server",
   "type": "server",
@@ -121,7 +124,19 @@ Example request (CREATE new implementation):
   "classification": "community",
   "implementation_language": "typescript",
   "github_owner": "myorg",
-  "github_repo": "my-mcp-server"
+  "github_repo": "my-mcp-server",
+  "remote": [
+    {
+      "url_direct": "https://api.example.com/mcp",
+      "transport": "sse",
+      "host_platform": "smithery",
+      "authentication_method": "open",
+      "cost": "free"
+    }
+  ],
+  "canonical": [
+    { "url": "https://github.com/myorg/my-mcp-server", "scope": "url" }
+  ]
 }
 
 Example request (UPDATE existing implementation):
@@ -134,7 +149,7 @@ Example request (UPDATE existing implementation):
   "implementation_language": "typescript"
 }
 
-Example request (with remote endpoints - new remote):
+Example request (UPDATE with remote endpoints - replaces ALL existing remotes):
 {
   "id": 11371,
   "remote": [
@@ -151,21 +166,12 @@ Example request (with remote endpoints - new remote):
   ]
 }
 
-Example response:
-{
-  "id": 11371,
-  "name": "GitHub MCP Server",
-  "slug": "github-mcp-server",
-  "type": "server",
-  "status": "live",
-  "classification": "official",
-  "updated_at": "2024-01-20T16:30:00Z"
-}
-
 Important notes:
 - Omit \`id\` to CREATE, provide \`id\` to UPDATE
 - When creating: \`name\` and \`type\` are required
 - When updating: only provided fields will be changed
+- **Omission semantics:** omitting \`remote\` or \`canonical\` leaves them unchanged. To clear them, pass an empty array.
+- Providing \`remote\` or \`canonical\` replaces ALL existing entries (not a merge)
 - CREATE-ONLY restrictions:
   - \`github_stars\` is read-only (derived from GitHub repository)
   - \`mcp_server_id\`/\`mcp_client_id\` are created automatically based on \`type\`
@@ -174,17 +180,7 @@ Important notes:
 - Setting mcp_server_id or mcp_client_id to null will unlink the association (UPDATE only)
 - Remote endpoints are for MCP servers only and configure how they can be accessed
 - Canonical URLs help identify the authoritative source for the implementation
-
-Use cases:
-- Create new MCP implementation entries
-- Update draft implementations before publishing
-- Change implementation status (draft → live, live → archived)
-- Update metadata (stars, language, classification)
-- Link or unlink MCP server/client associations
-- Update descriptions and documentation
-- Modify URLs and provider information
-- Add or update remote endpoint configurations for servers
-- Set canonical URLs for implementations`,
+- After creating/updating, use \`get_mcp_server\` to verify the full state including remotes and canonical URLs`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -377,9 +373,25 @@ Use cases:
                     if (implementation.url) {
                         content += `**URL:** ${implementation.url}\n`;
                     }
+                    if (implementation.canonical && implementation.canonical.length > 0) {
+                        content += `**Canonical URLs:** ${implementation.canonical.length}\n`;
+                        implementation.canonical.forEach((c) => {
+                            content += `  - ${c.url} (${c.scope})\n`;
+                        });
+                    }
+                    const remotes = implementation.mcp_server?.remotes;
+                    if (remotes && remotes.length > 0) {
+                        content += `**Remote Endpoints:** ${remotes.length}\n`;
+                        remotes.forEach((r) => {
+                            content += `  - ${r.display_name || r.url_direct || `ID ${r.id}`}\n`;
+                        });
+                    }
                     if (implementation.created_at) {
                         content += `**Created:** ${new Date(implementation.created_at).toLocaleDateString()}\n`;
                     }
+                    if (implementation.type === 'server') {
+                        content += `\n**Tip:** Use \`get_mcp_server\` with slug \`${implementation.slug}\` to verify the full state including remotes and canonical URLs.\n`;
+                    }
                     return {
                         content: [
                             {
@@ -434,6 +446,19 @@ Use cases:
                     if (implementation.mcp_client_id) {
                         content += `**Linked MCP Client ID:** ${implementation.mcp_client_id}\n`;
                     }
+                    if (implementation.canonical && implementation.canonical.length > 0) {
+                        content += `**Canonical URLs:** ${implementation.canonical.length}\n`;
+                        implementation.canonical.forEach((c) => {
+                            content += `  - ${c.url} (${c.scope})\n`;
+                        });
+                    }
+                    const updateRemotes = implementation.mcp_server?.remotes;
+                    if (updateRemotes && updateRemotes.length > 0) {
+                        content += `**Remote Endpoints:** ${updateRemotes.length}\n`;
+                        updateRemotes.forEach((r) => {
+                            content += `  - ${r.display_name || r.url_direct || `ID ${r.id}`}\n`;
+                        });
+                    }
                     if (implementation.updated_at) {
                         content += `**Updated:** ${new Date(implementation.updated_at).toLocaleDateString()}\n`;
                     }

package/build/shared/src/tools/update-mcp-server.js

@@ -18,9 +18,9 @@ const PARAM_DESCRIPTIONS = {
     recommended: 'Mark this server as recommended by PulseMCP',
     verified_no_remote_canonicals: 'Mark that this server has been verified to have no remote canonical URLs (true = verified no remote canonicals exist, false = reset/canonicals found)',
     created_on_override: 'Override the automatically derived created date (ISO date string, e.g., "2025-01-15")',
-    tags: 'Tags for the server. Replaces all existing tags when provided. Use tag slugs.',
-    canonical_urls: 'Authoritative URLs for the server. Replaces all existing canonical URLs when provided.',
-    remotes: 'Remote endpoints for the server. Replaces all existing remotes when provided.',
+    tags: 'Tags for the server. Providing this replaces ALL existing tags. Omitting leaves them unchanged. Pass an empty array to delete all. Use tag slugs.',
+    canonical_urls: 'Authoritative URLs for the server. Providing this replaces ALL existing canonical URLs. Omitting leaves them unchanged. Pass an empty array to delete all.',
+    remotes: 'Remote endpoints for the server. Providing this replaces ALL existing remotes. Omitting leaves them unchanged. Pass an empty array to delete all.',
     internal_notes: 'Admin-only internal notes',
 };
 const CanonicalUrlSchema = z.object({
@@ -99,10 +99,15 @@ const UpdateMCPServerSchema = z.object({
 export function updateMCPServer(_server, clientFactory) {
     return {
         name: 'update_mcp_server',
-        description: `Update an MCP server's information. Only provided fields will be updated.
+        description: `Update an MCP server's information. Only provided fields will be updated; **omitted fields remain unchanged**.
 
 **Important:** Use the \`implementation_id\` from \`get_mcp_server\` or \`list_mcp_servers\`, NOT the server ID or slug.
 
+## Omission semantics
+- **Omitting** \`remotes\`, \`canonical_urls\`, or \`tags\` leaves existing values **unchanged** (does NOT clear them)
+- **Providing** \`remotes\`, \`canonical_urls\`, or \`tags\` **replaces ALL** existing entries (not a merge)
+- To **delete all** entries, pass an empty array (e.g., \`"remotes": []\`)
+
 ## Updating Basic Info
 \`\`\`json
 {
@@ -126,7 +131,7 @@ export function updateMCPServer(_server, clientFactory) {
 \`\`\`
 
 ## Adding/Updating Canonical URLs
-Providing canonical_urls replaces ALL existing canonical URLs:
+Providing canonical_urls replaces ALL existing canonical URLs (omitting leaves them unchanged):
 \`\`\`json
 {
   "implementation_id": 456,
@@ -138,7 +143,7 @@ Providing canonical_urls replaces ALL existing canonical URLs:
 \`\`\`
 
 ## Adding/Updating Remote Endpoints
-Providing remotes replaces ALL existing remote endpoints:
+Providing remotes replaces ALL existing remote endpoints (omitting leaves them unchanged):
 \`\`\`json
 {
   "implementation_id": 456,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulsemcp-cms-admin-mcp-server",
-  "version": "0.9.2",
+  "version": "0.9.5",
   "description": "Local implementation of PulseMCP CMS Admin MCP server",
   "mcpName": "com.pulsemcp.servers/pulsemcp-cms-admin",
   "main": "build/index.js",

package/shared/pulsemcp-admin-client/lib/get-proctor-runs.js

@@ -56,6 +56,8 @@ export async function getProctorRuns(apiKey, baseUrl, params) {
             num_tools: run.num_tools,
             packages: run.packages,
             remotes: run.remotes,
+            known_missing_init_tools_list: run.known_missing_init_tools_list || false,
+            known_missing_auth_check: run.known_missing_auth_check || false,
         })),
         pagination: {
             current_page: data.meta.current_page,

package/shared/tools/list-proctor-runs.js

@@ -151,6 +151,12 @@ Use cases:
                     if (run.remotes.length > 0) {
                         content += `   Remotes: ${run.remotes.join(', ')}\n`;
                     }
+                    if (run.known_missing_init_tools_list) {
+                        content += `   Known Missing Init Tools List: yes\n`;
+                    }
+                    if (run.known_missing_auth_check) {
+                        content += `   Known Missing Auth Check: yes\n`;
+                    }
                     content += '\n';
                 }
                 return { content: [{ type: 'text', text: content.trim() }] };

package/shared/tools/save-mcp-implementation.d.ts

@@ -129,7 +129,7 @@ export declare function saveMCPImplementation(_server: Server, clientFactory: Cl
                         };
                     };
                 };
-                description: "Array of remote endpoint configurations for MCP servers. Each remote can have: id (existing remote ID or blank for new), url_direct, url_setup, transport (e.g., \"sse\"), host_platform (e.g., \"smithery\"), host_infrastructure (e.g., \"cloudflare\"), authentication_method (e.g., \"open\"), cost (e.g., \"free\"), status (defaults to \"live\"), display_name, and internal_notes.";
+                description: "Array of remote endpoint configurations for MCP servers. Providing this replaces ALL existing remotes. Omitting leaves them unchanged. Pass an empty array to delete all. Each remote can have: id (existing remote ID or blank for new), url_direct, url_setup, transport (e.g., \"sse\"), host_platform (e.g., \"smithery\"), host_infrastructure (e.g., \"cloudflare\"), authentication_method (e.g., \"open\"), cost (e.g., \"free\"), status (defaults to \"live\"), display_name, and internal_notes.";
             };
             canonical: {
                 type: string;
@@ -149,7 +149,7 @@ export declare function saveMCPImplementation(_server: Server, clientFactory: Cl
                     };
                     required: string[];
                 };
-                description: "Array of canonical URL configurations. Each entry must have: url (the canonical URL), scope (one of \"domain\", \"subdomain\", or \"url\"), and optional note for additional context.";
+                description: "Array of canonical URL configurations. Providing this replaces ALL existing canonical URLs. Omitting leaves them unchanged. Pass an empty array to delete all. Each entry must have: url (the canonical URL), scope (one of \"domain\", \"subdomain\", or \"url\"), and optional note for additional context.";
             };
             verified_no_remote_canonicals: {
                 type: string;

package/shared/tools/save-mcp-implementation.js

@@ -24,9 +24,9 @@ const PARAM_DESCRIPTIONS = {
     github_repo: 'GitHub repository name (without owner prefix).',
     github_subfolder: 'Subfolder path within the repository, for monorepos. Omit for root-level projects.',
     // Remote endpoints
-    remote: 'Array of remote endpoint configurations for MCP servers. Each remote can have: id (existing remote ID or blank for new), url_direct, url_setup, transport (e.g., "sse"), host_platform (e.g., "smithery"), host_infrastructure (e.g., "cloudflare"), authentication_method (e.g., "open"), cost (e.g., "free"), status (defaults to "live"), display_name, and internal_notes.',
+    remote: 'Array of remote endpoint configurations for MCP servers. Providing this replaces ALL existing remotes. Omitting leaves them unchanged. Pass an empty array to delete all. Each remote can have: id (existing remote ID or blank for new), url_direct, url_setup, transport (e.g., "sse"), host_platform (e.g., "smithery"), host_infrastructure (e.g., "cloudflare"), authentication_method (e.g., "open"), cost (e.g., "free"), status (defaults to "live"), display_name, and internal_notes.',
     // Canonical URLs
-    canonical: 'Array of canonical URL configurations. Each entry must have: url (the canonical URL), scope (one of "domain", "subdomain", or "url"), and optional note for additional context.',
+    canonical: 'Array of canonical URL configurations. Providing this replaces ALL existing canonical URLs. Omitting leaves them unchanged. Pass an empty array to delete all. Each entry must have: url (the canonical URL), scope (one of "domain", "subdomain", or "url"), and optional note for additional context.',
     // Flags
     verified_no_remote_canonicals: 'Mark that this server has been verified to have no remote canonical URLs (true = verified no remote canonicals exist, false = reset/canonicals found)',
     // Other fields
@@ -106,14 +106,17 @@ export function saveMCPImplementation(_server, clientFactory) {
 **Creating a new implementation:**
 - Omit the \`id\` field to create a new implementation
 - Required fields for creation: \`name\`, \`type\` (either "server" or "client")
+- Remote endpoints and canonical URLs CAN be included on creation
 
 **Updating an existing implementation:**
 - Provide the \`id\` field to update an existing implementation
-- Only provided fields will be updated; omitted fields remain unchanged
+- Only provided fields will be updated; **omitted fields remain unchanged**
+- Omitting \`remote\` or \`canonical\` leaves existing values unchanged (does NOT clear them)
+- Providing \`remote: []\` or \`canonical: []\` (empty array) will DELETE all existing entries
 
 All business logic from the Rails controller is applied (validation, associations, callbacks).
 
-Example request (CREATE new implementation):
+Example request (CREATE with remote endpoints and canonical URLs):
 {
   "name": "My New MCP Server",
   "type": "server",
@@ -121,7 +124,19 @@ Example request (CREATE new implementation):
   "classification": "community",
   "implementation_language": "typescript",
   "github_owner": "myorg",
-  "github_repo": "my-mcp-server"
+  "github_repo": "my-mcp-server",
+  "remote": [
+    {
+      "url_direct": "https://api.example.com/mcp",
+      "transport": "sse",
+      "host_platform": "smithery",
+      "authentication_method": "open",
+      "cost": "free"
+    }
+  ],
+  "canonical": [
+    { "url": "https://github.com/myorg/my-mcp-server", "scope": "url" }
+  ]
 }
 
 Example request (UPDATE existing implementation):
@@ -134,7 +149,7 @@ Example request (UPDATE existing implementation):
   "implementation_language": "typescript"
 }
 
-Example request (with remote endpoints - new remote):
+Example request (UPDATE with remote endpoints - replaces ALL existing remotes):
 {
   "id": 11371,
   "remote": [
@@ -151,21 +166,12 @@ Example request (with remote endpoints - new remote):
   ]
 }
 
-Example response:
-{
-  "id": 11371,
-  "name": "GitHub MCP Server",
-  "slug": "github-mcp-server",
-  "type": "server",
-  "status": "live",
-  "classification": "official",
-  "updated_at": "2024-01-20T16:30:00Z"
-}
-
 Important notes:
 - Omit \`id\` to CREATE, provide \`id\` to UPDATE
 - When creating: \`name\` and \`type\` are required
 - When updating: only provided fields will be changed
+- **Omission semantics:** omitting \`remote\` or \`canonical\` leaves them unchanged. To clear them, pass an empty array.
+- Providing \`remote\` or \`canonical\` replaces ALL existing entries (not a merge)
 - CREATE-ONLY restrictions:
   - \`github_stars\` is read-only (derived from GitHub repository)
   - \`mcp_server_id\`/\`mcp_client_id\` are created automatically based on \`type\`
@@ -174,17 +180,7 @@ Important notes:
 - Setting mcp_server_id or mcp_client_id to null will unlink the association (UPDATE only)
 - Remote endpoints are for MCP servers only and configure how they can be accessed
 - Canonical URLs help identify the authoritative source for the implementation
-
-Use cases:
-- Create new MCP implementation entries
-- Update draft implementations before publishing
-- Change implementation status (draft → live, live → archived)
-- Update metadata (stars, language, classification)
-- Link or unlink MCP server/client associations
-- Update descriptions and documentation
-- Modify URLs and provider information
-- Add or update remote endpoint configurations for servers
-- Set canonical URLs for implementations`,
+- After creating/updating, use \`get_mcp_server\` to verify the full state including remotes and canonical URLs`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -377,9 +373,25 @@ Use cases:
                     if (implementation.url) {
                         content += `**URL:** ${implementation.url}\n`;
                     }
+                    if (implementation.canonical && implementation.canonical.length > 0) {
+                        content += `**Canonical URLs:** ${implementation.canonical.length}\n`;
+                        implementation.canonical.forEach((c) => {
+                            content += `  - ${c.url} (${c.scope})\n`;
+                        });
+                    }
+                    const remotes = implementation.mcp_server?.remotes;
+                    if (remotes && remotes.length > 0) {
+                        content += `**Remote Endpoints:** ${remotes.length}\n`;
+                        remotes.forEach((r) => {
+                            content += `  - ${r.display_name || r.url_direct || `ID ${r.id}`}\n`;
+                        });
+                    }
                     if (implementation.created_at) {
                         content += `**Created:** ${new Date(implementation.created_at).toLocaleDateString()}\n`;
                     }
+                    if (implementation.type === 'server') {
+                        content += `\n**Tip:** Use \`get_mcp_server\` with slug \`${implementation.slug}\` to verify the full state including remotes and canonical URLs.\n`;
+                    }
                     return {
                         content: [
                             {
@@ -434,6 +446,19 @@ Use cases:
                     if (implementation.mcp_client_id) {
                         content += `**Linked MCP Client ID:** ${implementation.mcp_client_id}\n`;
                     }
+                    if (implementation.canonical && implementation.canonical.length > 0) {
+                        content += `**Canonical URLs:** ${implementation.canonical.length}\n`;
+                        implementation.canonical.forEach((c) => {
+                            content += `  - ${c.url} (${c.scope})\n`;
+                        });
+                    }
+                    const updateRemotes = implementation.mcp_server?.remotes;
+                    if (updateRemotes && updateRemotes.length > 0) {
+                        content += `**Remote Endpoints:** ${updateRemotes.length}\n`;
+                        updateRemotes.forEach((r) => {
+                            content += `  - ${r.display_name || r.url_direct || `ID ${r.id}`}\n`;
+                        });
+                    }
                     if (implementation.updated_at) {
                         content += `**Updated:** ${new Date(implementation.updated_at).toLocaleDateString()}\n`;
                     }

package/shared/tools/update-mcp-server.d.ts

@@ -101,7 +101,7 @@ export declare function updateMCPServer(_server: Server, clientFactory: ClientFa
                 items: {
                     type: string;
                 };
-                description: "Tags for the server. Replaces all existing tags when provided. Use tag slugs.";
+                description: "Tags for the server. Providing this replaces ALL existing tags. Omitting leaves them unchanged. Pass an empty array to delete all. Use tag slugs.";
             };
             canonical_urls: {
                 type: string;
@@ -124,7 +124,7 @@ export declare function updateMCPServer(_server: Server, clientFactory: ClientFa
                     };
                     required: string[];
                 };
-                description: "Authoritative URLs for the server. Replaces all existing canonical URLs when provided.";
+                description: "Authoritative URLs for the server. Providing this replaces ALL existing canonical URLs. Omitting leaves them unchanged. Pass an empty array to delete all.";
             };
             remotes: {
                 type: string;
@@ -177,7 +177,7 @@ export declare function updateMCPServer(_server: Server, clientFactory: ClientFa
                         };
                     };
                 };
-                description: "Remote endpoints for the server. Replaces all existing remotes when provided.";
+                description: "Remote endpoints for the server. Providing this replaces ALL existing remotes. Omitting leaves them unchanged. Pass an empty array to delete all.";
             };
             internal_notes: {
                 type: string;

package/shared/tools/update-mcp-server.js

@@ -18,9 +18,9 @@ const PARAM_DESCRIPTIONS = {
     recommended: 'Mark this server as recommended by PulseMCP',
     verified_no_remote_canonicals: 'Mark that this server has been verified to have no remote canonical URLs (true = verified no remote canonicals exist, false = reset/canonicals found)',
     created_on_override: 'Override the automatically derived created date (ISO date string, e.g., "2025-01-15")',
-    tags: 'Tags for the server. Replaces all existing tags when provided. Use tag slugs.',
-    canonical_urls: 'Authoritative URLs for the server. Replaces all existing canonical URLs when provided.',
-    remotes: 'Remote endpoints for the server. Replaces all existing remotes when provided.',
+    tags: 'Tags for the server. Providing this replaces ALL existing tags. Omitting leaves them unchanged. Pass an empty array to delete all. Use tag slugs.',
+    canonical_urls: 'Authoritative URLs for the server. Providing this replaces ALL existing canonical URLs. Omitting leaves them unchanged. Pass an empty array to delete all.',
+    remotes: 'Remote endpoints for the server. Providing this replaces ALL existing remotes. Omitting leaves them unchanged. Pass an empty array to delete all.',
     internal_notes: 'Admin-only internal notes',
 };
 const CanonicalUrlSchema = z.object({
@@ -99,10 +99,15 @@ const UpdateMCPServerSchema = z.object({
 export function updateMCPServer(_server, clientFactory) {
     return {
         name: 'update_mcp_server',
-        description: `Update an MCP server's information. Only provided fields will be updated.
+        description: `Update an MCP server's information. Only provided fields will be updated; **omitted fields remain unchanged**.
 
 **Important:** Use the \`implementation_id\` from \`get_mcp_server\` or \`list_mcp_servers\`, NOT the server ID or slug.
 
+## Omission semantics
+- **Omitting** \`remotes\`, \`canonical_urls\`, or \`tags\` leaves existing values **unchanged** (does NOT clear them)
+- **Providing** \`remotes\`, \`canonical_urls\`, or \`tags\` **replaces ALL** existing entries (not a merge)
+- To **delete all** entries, pass an empty array (e.g., \`"remotes": []\`)
+
 ## Updating Basic Info
 \`\`\`json
 {
@@ -126,7 +131,7 @@ export function updateMCPServer(_server, clientFactory) {
 \`\`\`
 
 ## Adding/Updating Canonical URLs
-Providing canonical_urls replaces ALL existing canonical URLs:
+Providing canonical_urls replaces ALL existing canonical URLs (omitting leaves them unchanged):
 \`\`\`json
 {
   "implementation_id": 456,
@@ -138,7 +143,7 @@ Providing canonical_urls replaces ALL existing canonical URLs:
 \`\`\`
 
 ## Adding/Updating Remote Endpoints
-Providing remotes replaces ALL existing remote endpoints:
+Providing remotes replaces ALL existing remote endpoints (omitting leaves them unchanged):
 \`\`\`json
 {
   "implementation_id": 456,

package/shared/types.d.ts

@@ -714,6 +714,8 @@ export interface ProctorRun {
     num_tools: number | null;
     packages: string[];
     remotes: string[];
+    known_missing_init_tools_list: boolean;
+    known_missing_auth_check: boolean;
 }
 export interface ProctorRunsResponse {
     runs: ProctorRun[];