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

package/build/shared/src/pulsemcp-admin-client/lib/create-mcp-implementation.js

@@ -64,6 +64,9 @@ export async function createMCPImplementation(apiKey, baseUrl, params) {
     if (params.recommended !== undefined) {
         formData.append('mcp_implementation[recommended]', params.recommended.toString());
     }
+    if (params.verified_no_remote_canonicals !== undefined) {
+        formData.append('mcp_implementation[verified_no_remote_canonicals]', params.verified_no_remote_canonicals.toString());
+    }
     // Date overrides
     if (params.created_on_override !== undefined) {
         formData.append('mcp_implementation[created_on_override]', params.created_on_override);

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/pulsemcp-admin-client/lib/save-mcp-implementation.js

@@ -74,6 +74,9 @@ export async function saveMCPImplementation(apiKey, baseUrl, id, params) {
     if (params.recommended !== undefined) {
         formData.append('mcp_implementation[recommended]', params.recommended.toString());
     }
+    if (params.verified_no_remote_canonicals !== undefined) {
+        formData.append('mcp_implementation[verified_no_remote_canonicals]', params.verified_no_remote_canonicals.toString());
+    }
     // Date overrides
     if (params.created_on_override !== undefined) {
         formData.append('mcp_implementation[created_on_override]', params.created_on_override);

package/build/shared/src/pulsemcp-admin-client/lib/unified-mcp-server-mapper.js

@@ -47,6 +47,7 @@ export function mapToUnifiedServer(impl) {
         package_name: impl.package_name,
         // Flags
         recommended: impl.recommended,
+        verified_no_remote_canonicals: mcpServer.verified_no_remote_canonicals,
         // Canonical URLs
         canonical_urls: impl.canonical,
         // Remote endpoints

package/build/shared/src/pulsemcp-admin-client/lib/update-unified-mcp-server.js

@@ -49,6 +49,8 @@ export async function updateUnifiedMCPServer(apiKey, baseUrl, implementationId,
     // Flags
     if (params.recommended !== undefined)
         implParams.recommended = params.recommended;
+    if (params.verified_no_remote_canonicals !== undefined)
+        implParams.verified_no_remote_canonicals = params.verified_no_remote_canonicals;
     // Date overrides
     if (params.created_on_override !== undefined)
         implParams.created_on_override = params.created_on_override;

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

@@ -102,6 +102,9 @@ Example response:
                 if (server.recommended !== undefined) {
                     content += `**Recommended:** ${server.recommended ? 'Yes' : 'No'}\n`;
                 }
+                if (server.verified_no_remote_canonicals !== undefined) {
+                    content += `**Verified No Remote Canonicals:** ${server.verified_no_remote_canonicals ? 'Yes' : 'No'}\n`;
+                }
                 if (server.short_description) {
                     content += `\n**Short Description:**\n${server.short_description}\n`;
                 }

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,11 @@ 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
     internal_notes: 'Admin-only notes. Not displayed publicly. Used for tracking submission sources, reviewer comments, etc.',
 };
@@ -88,6 +90,11 @@ const SaveMCPImplementationSchema = z.object({
     }))
         .optional()
         .describe(PARAM_DESCRIPTIONS.canonical),
+    // Flags
+    verified_no_remote_canonicals: z
+        .boolean()
+        .optional()
+        .describe(PARAM_DESCRIPTIONS.verified_no_remote_canonicals),
     // Other fields
     internal_notes: z.string().optional().describe(PARAM_DESCRIPTIONS.internal_notes),
 });
@@ -99,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",
@@ -114,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):
@@ -127,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": [
@@ -144,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\`
@@ -167,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: {
@@ -301,6 +304,11 @@ Use cases:
                     },
                     description: PARAM_DESCRIPTIONS.canonical,
                 },
+                // Flags
+                verified_no_remote_canonicals: {
+                    type: 'boolean',
+                    description: PARAM_DESCRIPTIONS.verified_no_remote_canonicals,
+                },
                 // Other fields
                 internal_notes: {
                     type: 'string',
@@ -365,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: [
                             {
@@ -422,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

@@ -16,10 +16,11 @@ const PARAM_DESCRIPTIONS = {
     package_registry: 'Package registry: npm, pypi, cargo, etc.',
     package_name: 'Package name on the registry (e.g., "@modelcontextprotocol/server-filesystem")',
     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({
@@ -82,6 +83,10 @@ const UpdateMCPServerSchema = z.object({
     package_registry: z.string().optional().describe(PARAM_DESCRIPTIONS.package_registry),
     package_name: z.string().optional().describe(PARAM_DESCRIPTIONS.package_name),
     recommended: z.boolean().optional().describe(PARAM_DESCRIPTIONS.recommended),
+    verified_no_remote_canonicals: z
+        .boolean()
+        .optional()
+        .describe(PARAM_DESCRIPTIONS.verified_no_remote_canonicals),
     created_on_override: z.string().optional().describe(PARAM_DESCRIPTIONS.created_on_override),
     tags: z.array(z.string()).optional().describe(PARAM_DESCRIPTIONS.tags),
     canonical_urls: z
@@ -94,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
 {
@@ -121,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,
@@ -133,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,
@@ -220,6 +230,10 @@ Create new provider:
                 package_registry: { type: 'string', description: PARAM_DESCRIPTIONS.package_registry },
                 package_name: { type: 'string', description: PARAM_DESCRIPTIONS.package_name },
                 recommended: { type: 'boolean', description: PARAM_DESCRIPTIONS.recommended },
+                verified_no_remote_canonicals: {
+                    type: 'boolean',
+                    description: PARAM_DESCRIPTIONS.verified_no_remote_canonicals,
+                },
                 created_on_override: {
                     type: 'string',
                     description: PARAM_DESCRIPTIONS.created_on_override,
@@ -318,6 +332,9 @@ Create new provider:
                 if (server.recommended !== undefined) {
                     content += `**Recommended:** ${server.recommended ? 'Yes' : 'No'}\n`;
                 }
+                if (server.verified_no_remote_canonicals !== undefined) {
+                    content += `**Verified No Remote Canonicals:** ${server.verified_no_remote_canonicals ? 'Yes' : 'No'}\n`;
+                }
                 if (server.updated_at) {
                     content += `**Updated:** ${server.updated_at}\n`;
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulsemcp-cms-admin-mcp-server",
-  "version": "0.9.1",
+  "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/create-mcp-implementation.js

@@ -64,6 +64,9 @@ export async function createMCPImplementation(apiKey, baseUrl, params) {
     if (params.recommended !== undefined) {
         formData.append('mcp_implementation[recommended]', params.recommended.toString());
     }
+    if (params.verified_no_remote_canonicals !== undefined) {
+        formData.append('mcp_implementation[verified_no_remote_canonicals]', params.verified_no_remote_canonicals.toString());
+    }
     // Date overrides
     if (params.created_on_override !== undefined) {
         formData.append('mcp_implementation[created_on_override]', params.created_on_override);

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/pulsemcp-admin-client/lib/save-mcp-implementation.js

@@ -74,6 +74,9 @@ export async function saveMCPImplementation(apiKey, baseUrl, id, params) {
     if (params.recommended !== undefined) {
         formData.append('mcp_implementation[recommended]', params.recommended.toString());
     }
+    if (params.verified_no_remote_canonicals !== undefined) {
+        formData.append('mcp_implementation[verified_no_remote_canonicals]', params.verified_no_remote_canonicals.toString());
+    }
     // Date overrides
     if (params.created_on_override !== undefined) {
         formData.append('mcp_implementation[created_on_override]', params.created_on_override);

package/shared/pulsemcp-admin-client/lib/unified-mcp-server-mapper.d.ts

@@ -45,6 +45,8 @@ export interface RailsImplementation {
         downloads_estimate_last_30_days?: number;
         downloads_estimate_total?: number;
         mcp_server_remotes_count?: number;
+        recommended?: boolean;
+        verified_no_remote_canonicals?: boolean;
         tags?: MCPServerTag[];
         remotes?: MCPServerRemote[];
         created_at?: string;

package/shared/pulsemcp-admin-client/lib/unified-mcp-server-mapper.js

@@ -47,6 +47,7 @@ export function mapToUnifiedServer(impl) {
         package_name: impl.package_name,
         // Flags
         recommended: impl.recommended,
+        verified_no_remote_canonicals: mcpServer.verified_no_remote_canonicals,
         // Canonical URLs
         canonical_urls: impl.canonical,
         // Remote endpoints

package/shared/pulsemcp-admin-client/lib/update-unified-mcp-server.js

@@ -49,6 +49,8 @@ export async function updateUnifiedMCPServer(apiKey, baseUrl, implementationId,
     // Flags
     if (params.recommended !== undefined)
         implParams.recommended = params.recommended;
+    if (params.verified_no_remote_canonicals !== undefined)
+        implParams.verified_no_remote_canonicals = params.verified_no_remote_canonicals;
     // Date overrides
     if (params.created_on_override !== undefined)
         implParams.created_on_override = params.created_on_override;

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

@@ -102,6 +102,9 @@ Example response:
                 if (server.recommended !== undefined) {
                     content += `**Recommended:** ${server.recommended ? 'Yes' : 'No'}\n`;
                 }
+                if (server.verified_no_remote_canonicals !== undefined) {
+                    content += `**Verified No Remote Canonicals:** ${server.verified_no_remote_canonicals ? 'Yes' : 'No'}\n`;
+                }
                 if (server.short_description) {
                     content += `\n**Short Description:**\n${server.short_description}\n`;
                 }

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,11 @@ 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;
+                description: "Mark that this server has been verified to have no remote canonical URLs (true = verified no remote canonicals exist, false = reset/canonicals found)";
             };
             internal_notes: {
                 type: string;

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

@@ -24,9 +24,11 @@ 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
     internal_notes: 'Admin-only notes. Not displayed publicly. Used for tracking submission sources, reviewer comments, etc.',
 };
@@ -88,6 +90,11 @@ const SaveMCPImplementationSchema = z.object({
     }))
         .optional()
         .describe(PARAM_DESCRIPTIONS.canonical),
+    // Flags
+    verified_no_remote_canonicals: z
+        .boolean()
+        .optional()
+        .describe(PARAM_DESCRIPTIONS.verified_no_remote_canonicals),
     // Other fields
     internal_notes: z.string().optional().describe(PARAM_DESCRIPTIONS.internal_notes),
 });
@@ -99,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",
@@ -114,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):
@@ -127,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": [
@@ -144,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\`
@@ -167,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: {
@@ -301,6 +304,11 @@ Use cases:
                     },
                     description: PARAM_DESCRIPTIONS.canonical,
                 },
+                // Flags
+                verified_no_remote_canonicals: {
+                    type: 'boolean',
+                    description: PARAM_DESCRIPTIONS.verified_no_remote_canonicals,
+                },
                 // Other fields
                 internal_notes: {
                     type: 'string',
@@ -365,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: [
                             {
@@ -422,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

@@ -88,6 +88,10 @@ export declare function updateMCPServer(_server: Server, clientFactory: ClientFa
                 type: string;
                 description: "Mark this server as recommended by PulseMCP";
             };
+            verified_no_remote_canonicals: {
+                type: string;
+                description: "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: {
                 type: string;
                 description: "Override the automatically derived created date (ISO date string, e.g., \"2025-01-15\")";
@@ -97,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;
@@ -120,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;
@@ -173,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

@@ -16,10 +16,11 @@ const PARAM_DESCRIPTIONS = {
     package_registry: 'Package registry: npm, pypi, cargo, etc.',
     package_name: 'Package name on the registry (e.g., "@modelcontextprotocol/server-filesystem")',
     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({
@@ -82,6 +83,10 @@ const UpdateMCPServerSchema = z.object({
     package_registry: z.string().optional().describe(PARAM_DESCRIPTIONS.package_registry),
     package_name: z.string().optional().describe(PARAM_DESCRIPTIONS.package_name),
     recommended: z.boolean().optional().describe(PARAM_DESCRIPTIONS.recommended),
+    verified_no_remote_canonicals: z
+        .boolean()
+        .optional()
+        .describe(PARAM_DESCRIPTIONS.verified_no_remote_canonicals),
     created_on_override: z.string().optional().describe(PARAM_DESCRIPTIONS.created_on_override),
     tags: z.array(z.string()).optional().describe(PARAM_DESCRIPTIONS.tags),
     canonical_urls: z
@@ -94,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
 {
@@ -121,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,
@@ -133,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,
@@ -220,6 +230,10 @@ Create new provider:
                 package_registry: { type: 'string', description: PARAM_DESCRIPTIONS.package_registry },
                 package_name: { type: 'string', description: PARAM_DESCRIPTIONS.package_name },
                 recommended: { type: 'boolean', description: PARAM_DESCRIPTIONS.recommended },
+                verified_no_remote_canonicals: {
+                    type: 'boolean',
+                    description: PARAM_DESCRIPTIONS.verified_no_remote_canonicals,
+                },
                 created_on_override: {
                     type: 'string',
                     description: PARAM_DESCRIPTIONS.created_on_override,
@@ -318,6 +332,9 @@ Create new provider:
                 if (server.recommended !== undefined) {
                     content += `**Recommended:** ${server.recommended ? 'Yes' : 'No'}\n`;
                 }
+                if (server.verified_no_remote_canonicals !== undefined) {
+                    content += `**Verified No Remote Canonicals:** ${server.verified_no_remote_canonicals ? 'Yes' : 'No'}\n`;
+                }
                 if (server.updated_at) {
                     content += `**Updated:** ${server.updated_at}\n`;
                 }

package/shared/types.d.ts

@@ -124,6 +124,8 @@ export interface MCPServer {
     downloads_estimate_last_four_weeks?: number;
     visitors_estimate_total?: number;
     mcp_server_remotes_count?: number;
+    recommended?: boolean;
+    verified_no_remote_canonicals?: boolean;
     tags?: MCPServerTag[];
     remotes?: MCPServerRemote[];
 }
@@ -203,6 +205,7 @@ export interface SaveMCPImplementationParams {
     package_registry?: string;
     package_name?: string;
     recommended?: boolean;
+    verified_no_remote_canonicals?: boolean;
     created_on_override?: string;
     tags?: string[];
     remote?: RemoteEndpointParams[];
@@ -238,6 +241,7 @@ export interface CreateMCPImplementationParams {
     package_registry?: string;
     package_name?: string;
     recommended?: boolean;
+    verified_no_remote_canonicals?: boolean;
     created_on_override?: string;
     tags?: string[];
     remote?: RemoteEndpointParams[];
@@ -515,6 +519,7 @@ export interface UnifiedMCPServer {
     package_registry?: string;
     package_name?: string;
     recommended?: boolean;
+    verified_no_remote_canonicals?: boolean;
     canonical_urls?: CanonicalUrl[];
     remotes?: RemoteEndpoint[];
     tags?: MCPServerTag[];
@@ -564,6 +569,7 @@ export interface UpdateUnifiedMCPServerParams {
     package_registry?: string;
     package_name?: string;
     recommended?: boolean;
+    verified_no_remote_canonicals?: boolean;
     created_on_override?: string;
     tags?: string[];
     canonical_urls?: CanonicalUrl[];
@@ -708,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[];