pulsemcp-cms-admin-mcp-server 0.6.0 → 0.6.2

package/README.md

@@ -40,26 +40,43 @@ This is an MCP ([Model Context Protocol](https://modelcontextprotocol.io/)) Serv
 
 This server is built and tested on macOS with Claude Desktop. It should work with other MCP clients as well.
 
-| Tool Name                              | Tool Group     | Read/Write | Description                                                                  |
-| -------------------------------------- | -------------- | ---------- | ---------------------------------------------------------------------------- |
-| `get_newsletter_posts`                 | newsletter     | read       | List newsletter posts with search, sorting, and pagination options.          |
-| `get_newsletter_post`                  | newsletter     | read       | Retrieve a specific newsletter post by its unique slug.                      |
-| `draft_newsletter_post`                | newsletter     | write      | Create a new draft newsletter post with title, body, and metadata.           |
-| `update_newsletter_post`               | newsletter     | write      | Update an existing newsletter post's content and metadata (except status).   |
-| `upload_image`                         | newsletter     | write      | Upload an image and attach it to a specific newsletter post.                 |
-| `get_authors`                          | newsletter     | read       | Get a list of authors with optional search and pagination.                   |
-| `search_mcp_implementations`           | server_queue   | read       | Search for MCP servers and clients in the PulseMCP registry.                 |
-| `get_draft_mcp_implementations`        | server_queue   | read       | Retrieve paginated list of draft MCP implementations needing review.         |
-| `find_providers`                       | server_queue   | read       | Search for providers by ID, name, URL, or slug.                              |
-| `save_mcp_implementation`              | server_queue   | write      | Update an MCP implementation (replicates Admin panel "Save Changes" button). |
-| `send_impl_posted_notif`               | server_queue   | write      | Send email notification when MCP implementation goes live.                   |
-| `get_official_mirror_queue_items`      | official_queue | read       | List and filter official mirror queue entries with pagination and search.    |
-| `get_official_mirror_queue_item`       | official_queue | read       | Get detailed information about a single official mirror queue entry.         |
-| `approve_official_mirror_queue_item`   | official_queue | write      | Approve a queue entry and link it to an existing MCP server (async).         |
-| `approve_mirror_no_modify`             | official_queue | write      | Approve without updating the linked server.                                  |
-| `reject_official_mirror_queue_item`    | official_queue | write      | Reject a queue entry (async operation).                                      |
-| `add_official_mirror_to_regular_queue` | official_queue | write      | Convert a queue entry to a draft MCP implementation (async).                 |
-| `unlink_official_mirror_queue_item`    | official_queue | write      | Unlink a queue entry from its linked MCP server.                             |
+| Tool Name                              | Tool Group         | Read/Write | Description                                                                   |
+| -------------------------------------- | ------------------ | ---------- | ----------------------------------------------------------------------------- |
+| `get_newsletter_posts`                 | newsletter         | read       | List newsletter posts with search, sorting, and pagination options.           |
+| `get_newsletter_post`                  | newsletter         | read       | Retrieve a specific newsletter post by its unique slug.                       |
+| `draft_newsletter_post`                | newsletter         | write      | Create a new draft newsletter post with title, body, and metadata.            |
+| `update_newsletter_post`               | newsletter         | write      | Update an existing newsletter post's content and metadata (except status).    |
+| `upload_image`                         | newsletter         | write      | Upload an image and attach it to a specific newsletter post.                  |
+| `get_authors`                          | newsletter         | read       | Get a list of authors with optional search and pagination.                    |
+| `search_mcp_implementations`           | server_queue       | read       | Search for MCP servers and clients in the PulseMCP registry.                  |
+| `get_draft_mcp_implementations`        | server_queue       | read       | Retrieve paginated list of draft MCP implementations needing review.          |
+| `find_providers`                       | server_queue       | read       | Search for providers by ID, name, URL, or slug.                               |
+| `save_mcp_implementation`              | server_queue       | write      | Update an MCP implementation (replicates Admin panel "Save Changes" button).  |
+| `send_impl_posted_notif`               | server_queue       | write      | Send email notification when MCP implementation goes live.                    |
+| `get_official_mirror_queue_items`      | official_queue     | read       | List and filter official mirror queue entries with pagination and search.     |
+| `get_official_mirror_queue_item`       | official_queue     | read       | Get detailed information about a single official mirror queue entry.          |
+| `approve_official_mirror_queue_item`   | official_queue     | write      | Approve a queue entry and link it to an existing MCP server (async).          |
+| `approve_mirror_no_modify`             | official_queue     | write      | Approve without updating the linked server.                                   |
+| `reject_official_mirror_queue_item`    | official_queue     | write      | Reject a queue entry (async operation).                                       |
+| `add_official_mirror_to_regular_queue` | official_queue     | write      | Convert a queue entry to a draft MCP implementation (async).                  |
+| `unlink_official_mirror_queue_item`    | official_queue     | write      | Unlink a queue entry from its linked MCP server.                              |
+| `get_unofficial_mirrors`               | unofficial_mirrors | read       | List unofficial mirrors with search, pagination, and MCP server filtering.    |
+| `get_unofficial_mirror`                | unofficial_mirrors | read       | Get detailed unofficial mirror info by ID or name.                            |
+| `create_unofficial_mirror`             | unofficial_mirrors | write      | Create a new unofficial mirror entry with JSON data.                          |
+| `update_unofficial_mirror`             | unofficial_mirrors | write      | Update an existing unofficial mirror by ID.                                   |
+| `delete_unofficial_mirror`             | unofficial_mirrors | write      | Delete an unofficial mirror by ID (irreversible).                             |
+| `get_official_mirrors`                 | official_mirrors   | read       | List official mirrors with search, status, and processing filters.            |
+| `get_official_mirror`                  | official_mirrors   | read       | Get detailed official mirror info by ID or name.                              |
+| `get_tenants`                          | tenants            | read       | List tenants with search and admin status filtering.                          |
+| `get_tenant`                           | tenants            | read       | Get detailed tenant info by ID or slug.                                       |
+| `get_mcp_jsons`                        | mcp_jsons          | read       | List MCP JSON configs with mirror and server filtering.                       |
+| `get_mcp_json`                         | mcp_jsons          | read       | Get a single MCP JSON configuration by ID.                                    |
+| `create_mcp_json`                      | mcp_jsons          | write      | Create a new MCP JSON configuration for an unofficial mirror.                 |
+| `update_mcp_json`                      | mcp_jsons          | write      | Update an existing MCP JSON configuration by ID.                              |
+| `delete_mcp_json`                      | mcp_jsons          | write      | Delete an MCP JSON configuration by ID (irreversible).                        |
+| `list_mcp_servers`                     | mcp_servers        | read       | List/search MCP servers with filtering by status, classification, pagination. |
+| `get_mcp_server`                       | mcp_servers        | read       | Get detailed MCP server info by slug (unified view of all admin UI fields).   |
+| `update_mcp_server`                    | mcp_servers        | write      | Update an MCP server's fields (all admin UI fields supported).                |
 
 # Tool Groups
 
@@ -70,14 +87,24 @@ This server organizes tools into groups that can be selectively enabled or disab
 
 ## Available Groups
 
-| Group                     | Tools | Description                                  |
-| ------------------------- | ----- | -------------------------------------------- |
-| `newsletter`              | 6     | Full newsletter management (read + write)    |
-| `newsletter_readonly`     | 3     | Newsletter read-only (get posts, authors)    |
-| `server_queue`            | 5     | Full MCP implementation queue (read + write) |
-| `server_queue_readonly`   | 3     | MCP implementation queue read-only           |
-| `official_queue`          | 7     | Full official mirror queue (read + write)    |
-| `official_queue_readonly` | 2     | Official mirror queue read-only              |
+| Group                         | Tools | Description                                  |
+| ----------------------------- | ----- | -------------------------------------------- |
+| `newsletter`                  | 6     | Full newsletter management (read + write)    |
+| `newsletter_readonly`         | 3     | Newsletter read-only (get posts, authors)    |
+| `server_queue`                | 5     | Full MCP implementation queue (read + write) |
+| `server_queue_readonly`       | 3     | MCP implementation queue read-only           |
+| `official_queue`              | 7     | Full official mirror queue (read + write)    |
+| `official_queue_readonly`     | 2     | Official mirror queue read-only              |
+| `unofficial_mirrors`          | 5     | Full unofficial mirrors CRUD (read + write)  |
+| `unofficial_mirrors_readonly` | 2     | Unofficial mirrors read-only                 |
+| `official_mirrors`            | 2     | Official mirrors REST API (read-only)        |
+| `official_mirrors_readonly`   | 2     | Official mirrors read-only (alias)           |
+| `tenants`                     | 2     | Tenants REST API (read-only)                 |
+| `tenants_readonly`            | 2     | Tenants read-only (alias)                    |
+| `mcp_jsons`                   | 5     | Full MCP JSON configurations (read + write)  |
+| `mcp_jsons_readonly`          | 2     | MCP JSON configurations read-only            |
+| `mcp_servers`                 | 3     | Full MCP servers management (read + write)   |
+| `mcp_servers_readonly`        | 2     | MCP servers read-only (list, get)            |
 
 ### Tools by Group
 
@@ -90,12 +117,25 @@ This server organizes tools into groups that can be selectively enabled or disab
 - **official_queue** / **official_queue_readonly**:
   - Read-only: `get_official_mirror_queue_items`, `get_official_mirror_queue_item`
   - Write: `approve_official_mirror_queue_item`, `approve_mirror_no_modify`, `reject_official_mirror_queue_item`, `add_official_mirror_to_regular_queue`, `unlink_official_mirror_queue_item`
+- **unofficial_mirrors** / **unofficial_mirrors_readonly**:
+  - Read-only: `get_unofficial_mirrors`, `get_unofficial_mirror`
+  - Write: `create_unofficial_mirror`, `update_unofficial_mirror`, `delete_unofficial_mirror`
+- **official_mirrors** / **official_mirrors_readonly**:
+  - Read-only: `get_official_mirrors`, `get_official_mirror`
+- **tenants** / **tenants_readonly**:
+  - Read-only: `get_tenants`, `get_tenant`
+- **mcp_jsons** / **mcp_jsons_readonly**:
+  - Read-only: `get_mcp_jsons`, `get_mcp_json`
+  - Write: `create_mcp_json`, `update_mcp_json`, `delete_mcp_json`
+- **mcp_servers** / **mcp_servers_readonly**:
+  - Read-only: `list_mcp_servers`, `get_mcp_server`
+  - Write: `update_mcp_server`
 
 ## Environment Variables
 
-| Variable      | Description                                 | Default                                                    |
-| ------------- | ------------------------------------------- | ---------------------------------------------------------- |
-| `TOOL_GROUPS` | Comma-separated list of enabled tool groups | `newsletter,server_queue,official_queue` (all base groups) |
+| Variable      | Description                                 | Default                                                                                                                      |
+| ------------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `TOOL_GROUPS` | Comma-separated list of enabled tool groups | `newsletter,server_queue,official_queue,unofficial_mirrors,official_mirrors,tenants,mcp_jsons,mcp_servers` (all base groups) |
 
 ## Examples
 
@@ -120,7 +160,7 @@ TOOL_GROUPS=server_queue_readonly
 Enable all groups with read-only access:
 
 ```bash
-TOOL_GROUPS=newsletter_readonly,server_queue_readonly,official_queue_readonly
+TOOL_GROUPS=newsletter_readonly,server_queue_readonly,official_queue_readonly,unofficial_mirrors_readonly,official_mirrors_readonly,tenants_readonly,mcp_jsons_readonly,mcp_servers_readonly
 ```
 
 Mix full and read-only access per group:
@@ -146,6 +186,10 @@ TOOL_GROUPS=newsletter,server_queue_readonly
 - Use the `canonical` array parameter in `save_mcp_implementation` to set canonical URLs with scope (domain, subdomain, subfolder, or url)
 - Remote endpoints allow specifying how MCP servers can be accessed (direct URL, setup URL, authentication method, cost, etc.)
 - When updating existing remotes, include the remote `id` (number from `get_draft_mcp_implementations`) in the remote object
+- Use `list_mcp_servers` to browse MCP servers with filtering by status (draft/live/archived) and classification (official/community)
+- Use `get_mcp_server` to get a unified view of all server data including provider, source code, canonicals, remotes, and tags
+- Use `update_mcp_server` to update any admin UI field: name, description, provider, source code, package info, tags, canonicals, remotes, etc.
+- The `mcp_servers` tools abstract away the MCPImplementation → MCPServer data model complexity
 
 # Examples
 
@@ -252,7 +296,7 @@ Add to your Claude Desktop configuration:
       "args": ["/path/to/pulsemcp-cms-admin/local/build/index.js"],
       "env": {
         "PULSEMCP_ADMIN_API_KEY": "your-api-key-here",
-        "TOOL_GROUPS": "newsletter,server_queue,official_queue"
+        "TOOL_GROUPS": "newsletter,server_queue,official_queue,unofficial_mirrors,official_mirrors,tenants,mcp_jsons,mcp_servers"
       }
     }
   }
@@ -269,7 +313,7 @@ For read-only access:
       "args": ["/path/to/pulsemcp-cms-admin/local/build/index.js"],
       "env": {
         "PULSEMCP_ADMIN_API_KEY": "your-api-key-here",
-        "TOOL_GROUPS": "newsletter_readonly,server_queue_readonly,official_queue_readonly"
+        "TOOL_GROUPS": "newsletter_readonly,server_queue_readonly,official_queue_readonly,unofficial_mirrors_readonly,official_mirrors_readonly,tenants_readonly,mcp_jsons_readonly,mcp_servers_readonly"
       }
     }
   }

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

@@ -0,0 +1,93 @@
+import { mapToUnifiedServer } from './unified-mcp-server-mapper.js';
+/**
+ * Get a unified MCP server by its slug.
+ * This fetches the MCPServer and its associated MCPImplementation data.
+ */
+export async function getUnifiedMCPServer(apiKey, baseUrl, slug) {
+    // First, get the MCPServer to get its ID
+    const serverUrl = new URL(`/supervisor/mcp_servers/${slug}`, baseUrl);
+    const serverResponse = await fetch(serverUrl.toString(), {
+        method: 'GET',
+        headers: {
+            'X-API-Key': apiKey,
+            Accept: 'application/json',
+        },
+    });
+    if (!serverResponse.ok) {
+        if (serverResponse.status === 401) {
+            throw new Error('Invalid API key');
+        }
+        if (serverResponse.status === 403) {
+            throw new Error('User lacks admin privileges');
+        }
+        if (serverResponse.status === 404) {
+            throw new Error(`MCP server not found: ${slug}`);
+        }
+        throw new Error(`Failed to fetch MCP server: ${serverResponse.status} ${serverResponse.statusText}`);
+    }
+    const mcpServerData = (await serverResponse.json());
+    // Now search for the implementation that references this MCPServer
+    // Use a search that includes the slug to narrow down results
+    // Don't pass status param to get all statuses (API doesn't support 'all' as a value)
+    const searchUrl = new URL('/api/implementations/search', baseUrl);
+    searchUrl.searchParams.append('q', slug);
+    searchUrl.searchParams.append('type', 'server');
+    searchUrl.searchParams.append('limit', '50');
+    const searchResponse = await fetch(searchUrl.toString(), {
+        method: 'GET',
+        headers: {
+            'X-API-Key': apiKey,
+            Accept: 'application/json',
+        },
+    });
+    if (!searchResponse.ok) {
+        throw new Error(`Failed to fetch implementation data: ${searchResponse.status} ${searchResponse.statusText}`);
+    }
+    const searchData = (await searchResponse.json());
+    // Find the implementation that matches this MCPServer's ID
+    const matchingImpl = searchData.data.find((impl) => impl.mcp_server_id === mcpServerData.id);
+    if (!matchingImpl) {
+        // If no matching implementation found, construct a minimal unified server from MCPServer data
+        return {
+            id: mcpServerData.id,
+            slug: mcpServerData.slug,
+            implementation_id: null, // No implementation exists for this server
+            name: mcpServerData.slug, // Use slug as name fallback
+            status: 'draft',
+            classification: mcpServerData.classification,
+            implementation_language: mcpServerData.implementation_language,
+            remotes: mcpServerData.remotes?.map((r) => ({
+                id: r.id,
+                display_name: r.display_name,
+                url_direct: r.url_direct,
+                url_setup: r.url_setup,
+                transport: r.transport,
+                host_platform: r.host_platform,
+                host_infrastructure: r.host_infrastructure,
+                authentication_method: r.authentication_method,
+                cost: r.cost,
+                status: r.status,
+                internal_notes: r.internal_notes,
+            })),
+            tags: mcpServerData.tags,
+            registry_package_id: mcpServerData.registry_package_id,
+            registry_package_soft_verified: mcpServerData.registry_package_soft_verified,
+            downloads_estimate_last_7_days: mcpServerData.downloads_estimate_last_7_days,
+            downloads_estimate_last_30_days: mcpServerData.downloads_estimate_last_30_days,
+            downloads_estimate_total: mcpServerData.downloads_estimate_total,
+            created_at: mcpServerData.created_at,
+            updated_at: mcpServerData.updated_at,
+        };
+    }
+    // Merge MCPServer data with implementation data for complete picture
+    matchingImpl.mcp_server = {
+        ...mcpServerData,
+        remotes: mcpServerData.remotes,
+        tags: mcpServerData.tags,
+    };
+    const unified = mapToUnifiedServer(matchingImpl);
+    if (!unified) {
+        throw new Error(`Failed to map MCP server data for: ${slug}`);
+    }
+    return unified;
+}

package/build/shared/src/pulsemcp-admin-client/lib/get-unified-mcp-servers.js

@@ -0,0 +1,51 @@
+import { mapToUnifiedServer } from './unified-mcp-server-mapper.js';
+export async function getUnifiedMCPServers(apiKey, baseUrl, params) {
+    const url = new URL('/api/implementations/search', baseUrl);
+    // Always filter to servers only
+    url.searchParams.append('type', 'server');
+    // The API requires a search query - use '*' wildcard if none provided
+    url.searchParams.append('q', params?.q || '*');
+    if (params?.status && params.status !== 'all') {
+        url.searchParams.append('status', params.status);
+    }
+    if (params?.classification) {
+        url.searchParams.append('classification', params.classification);
+    }
+    if (params?.limit) {
+        url.searchParams.append('limit', params.limit.toString());
+    }
+    if (params?.offset) {
+        url.searchParams.append('offset', params.offset.toString());
+    }
+    const response = await fetch(url.toString(), {
+        method: 'GET',
+        headers: {
+            'X-API-Key': apiKey,
+            Accept: 'application/json',
+        },
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new Error('Invalid API key');
+        }
+        if (response.status === 403) {
+            throw new Error('User lacks admin privileges');
+        }
+        throw new Error(`Failed to fetch MCP servers: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    // Map implementations to unified servers, filtering out those without an MCPServer
+    const servers = data.data
+        .map(mapToUnifiedServer)
+        .filter((s) => s !== null);
+    return {
+        servers,
+        pagination: {
+            current_page: data.meta.current_page,
+            total_pages: data.meta.total_pages,
+            total_count: data.meta.total_count,
+            has_next: data.meta.has_next,
+            limit: data.meta.limit,
+        },
+    };
+}

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

@@ -63,6 +63,33 @@ export async function saveMCPImplementation(apiKey, baseUrl, id, params) {
     if (params.github_subfolder !== undefined) {
         formData.append('mcp_implementation[github_subfolder]', params.github_subfolder);
     }
+    // Package registry fields
+    if (params.package_registry !== undefined) {
+        formData.append('mcp_implementation[package_registry]', params.package_registry);
+    }
+    if (params.package_name !== undefined) {
+        formData.append('mcp_implementation[package_name]', params.package_name);
+    }
+    // Flags
+    if (params.recommended !== undefined) {
+        formData.append('mcp_implementation[recommended]', params.recommended.toString());
+    }
+    // Date overrides
+    if (params.created_on_override !== undefined) {
+        formData.append('mcp_implementation[created_on_override]', params.created_on_override);
+    }
+    // Tags
+    if (params.tags !== undefined) {
+        if (params.tags.length > 0) {
+            params.tags.forEach((tagSlug, index) => {
+                formData.append(`mcp_implementation[tags][${index}]`, tagSlug);
+            });
+        }
+        else {
+            // Empty array explicitly provided - send empty array marker to Rails
+            formData.append('mcp_implementation[tags]', '[]');
+        }
+    }
     // Internal notes
     if (params.internal_notes !== undefined) {
         formData.append('mcp_implementation[internal_notes]', params.internal_notes);

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

@@ -0,0 +1,81 @@
+/**
+ * Maps a Rails implementation response to a unified MCP server representation.
+ * Returns null if the implementation doesn't have an associated MCPServer.
+ */
+export function mapToUnifiedServer(impl) {
+    // Only map implementations that have an associated MCPServer
+    if (!impl.mcp_server || !impl.mcp_server_id) {
+        return null;
+    }
+    const mcpServer = impl.mcp_server;
+    return {
+        // Core identification
+        id: mcpServer.id,
+        slug: mcpServer.slug,
+        implementation_id: impl.id,
+        // Basic info
+        name: impl.name,
+        short_description: impl.short_description,
+        description: impl.description,
+        status: impl.status,
+        classification: impl.classification,
+        implementation_language: impl.implementation_language,
+        url: impl.marketing_url,
+        // Provider info
+        provider: impl.provider_id || impl.provider_name
+            ? {
+                id: impl.provider_id,
+                name: impl.provider_name,
+                slug: impl.provider_slug,
+                url: impl.provider_url,
+            }
+            : undefined,
+        // Source code location
+        source_code: impl.github_owner || impl.github_repo
+            ? {
+                github_owner: impl.github_owner,
+                github_repo: impl.github_repo,
+                github_subfolder: impl.github_subfolder,
+                github_stars: impl.github_stars,
+                github_created_date: impl.github_created_date,
+                github_last_updated: impl.github_last_updated,
+                github_status: impl.github_status,
+            }
+            : undefined,
+        // Package registry info
+        package_registry: impl.package_registry,
+        package_name: impl.package_name,
+        // Flags
+        recommended: impl.recommended,
+        // Canonical URLs
+        canonical_urls: impl.canonical,
+        // Remote endpoints
+        remotes: mcpServer.remotes?.map((r) => ({
+            id: r.id,
+            display_name: r.display_name,
+            url_direct: r.url_direct,
+            url_setup: r.url_setup,
+            transport: r.transport,
+            host_platform: r.host_platform,
+            host_infrastructure: r.host_infrastructure,
+            authentication_method: r.authentication_method,
+            cost: r.cost,
+            status: r.status,
+            internal_notes: r.internal_notes,
+        })),
+        // Tags
+        tags: mcpServer.tags,
+        // Registry/download info
+        registry_package_id: mcpServer.registry_package_id,
+        registry_package_soft_verified: mcpServer.registry_package_soft_verified,
+        downloads_estimate_last_7_days: mcpServer.downloads_estimate_last_7_days,
+        downloads_estimate_last_30_days: mcpServer.downloads_estimate_last_30_days,
+        downloads_estimate_total: mcpServer.downloads_estimate_total,
+        // Internal notes
+        internal_notes: impl.internal_notes,
+        // Timestamps (use implementation timestamps as they're more relevant)
+        created_at: impl.created_at,
+        updated_at: impl.updated_at,
+        created_on_override: impl.created_on_override,
+    };
+}

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

@@ -0,0 +1,90 @@
+import { mapToUnifiedServer } from './unified-mcp-server-mapper.js';
+/**
+ * Update a unified MCP server by its implementation ID.
+ * This abstracts the complexity of updating the MCPImplementation and MCPServer relationship.
+ */
+export async function updateUnifiedMCPServer(apiKey, baseUrl, implementationId, params) {
+    // Transform unified params to implementation params
+    const implParams = {};
+    // Basic info
+    if (params.name !== undefined)
+        implParams.name = params.name;
+    if (params.short_description !== undefined)
+        implParams.short_description = params.short_description;
+    if (params.description !== undefined)
+        implParams.description = params.description;
+    if (params.status !== undefined)
+        implParams.status = params.status;
+    if (params.classification !== undefined)
+        implParams.classification = params.classification;
+    if (params.implementation_language !== undefined)
+        implParams.implementation_language = params.implementation_language;
+    if (params.url !== undefined)
+        implParams.url = params.url;
+    if (params.internal_notes !== undefined)
+        implParams.internal_notes = params.internal_notes;
+    // Provider handling
+    if (params.provider_id !== undefined)
+        implParams.provider_id = params.provider_id;
+    if (params.provider_name !== undefined)
+        implParams.provider_name = params.provider_name;
+    if (params.provider_slug !== undefined)
+        implParams.provider_slug = params.provider_slug;
+    if (params.provider_url !== undefined)
+        implParams.provider_url = params.provider_url;
+    // Source code location
+    if (params.source_code) {
+        if (params.source_code.github_owner !== undefined)
+            implParams.github_owner = params.source_code.github_owner;
+        if (params.source_code.github_repo !== undefined)
+            implParams.github_repo = params.source_code.github_repo;
+        if (params.source_code.github_subfolder !== undefined)
+            implParams.github_subfolder = params.source_code.github_subfolder;
+    }
+    // Package registry info
+    if (params.package_registry !== undefined)
+        implParams.package_registry = params.package_registry;
+    if (params.package_name !== undefined)
+        implParams.package_name = params.package_name;
+    // Flags
+    if (params.recommended !== undefined)
+        implParams.recommended = params.recommended;
+    // Date overrides
+    if (params.created_on_override !== undefined)
+        implParams.created_on_override = params.created_on_override;
+    // Tags
+    if (params.tags !== undefined)
+        implParams.tags = params.tags;
+    // Canonical URLs
+    if (params.canonical_urls !== undefined) {
+        implParams.canonical = params.canonical_urls;
+    }
+    // Remote endpoints
+    if (params.remotes !== undefined) {
+        implParams.remote = params.remotes.map((r) => ({
+            id: r.id,
+            display_name: r.display_name,
+            url_direct: r.url_direct,
+            url_setup: r.url_setup,
+            transport: r.transport,
+            host_platform: r.host_platform,
+            host_infrastructure: r.host_infrastructure,
+            authentication_method: r.authentication_method,
+            cost: r.cost,
+            status: r.status,
+            internal_notes: r.internal_notes,
+        }));
+    }
+    // Use the existing save-mcp-implementation endpoint
+    const { saveMCPImplementation } = await import('./save-mcp-implementation.js');
+    const result = await saveMCPImplementation(apiKey, baseUrl, implementationId, implParams);
+    // Map the result back to a unified server
+    const unified = mapToUnifiedServer(result);
+    if (!unified) {
+        // If the result doesn't have mcp_server, the implementation isn't linked to an MCPServer.
+        // This is unexpected for the mcp_servers tool group - throw an error to surface the issue.
+        throw new Error(`Implementation ${result.id} (${result.name}) is not linked to an MCPServer. ` +
+            `Use the implementations tools instead to manage this record.`);
+    }
+    return unified;
+}

package/build/shared/src/pulsemcp-admin-client/pulsemcp-admin-client.integration-mock.js

@@ -738,5 +738,51 @@ export function createMockPulseMCPAdminClient(mockData) {
         async deleteMcpJson() {
             return { success: true, message: 'MCP JSON deleted' };
         },
+        // Unified MCP Server methods (stub implementations)
+        async getUnifiedMCPServers() {
+            return {
+                servers: [],
+                pagination: { current_page: 1, total_pages: 1, total_count: 0 },
+            };
+        },
+        async getUnifiedMCPServer(slug) {
+            return {
+                id: 1,
+                slug,
+                implementation_id: 1,
+                name: `Test Server (${slug})`,
+                status: 'live',
+                classification: 'community',
+                created_at: new Date().toISOString(),
+                updated_at: new Date().toISOString(),
+            };
+        },
+        async updateUnifiedMCPServer(implementationId, params) {
+            return {
+                id: 1,
+                slug: 'test-server',
+                implementation_id: implementationId,
+                name: params.name || 'Updated Server',
+                short_description: params.short_description,
+                description: params.description,
+                status: params.status || 'live',
+                classification: params.classification || 'community',
+                implementation_language: params.implementation_language,
+                url: params.url,
+                provider: params.provider_name
+                    ? {
+                        name: params.provider_name,
+                        slug: params.provider_slug,
+                        url: params.provider_url,
+                    }
+                    : undefined,
+                source_code: params.source_code,
+                canonical_urls: params.canonical_urls,
+                remotes: params.remotes,
+                internal_notes: params.internal_notes,
+                created_at: new Date().toISOString(),
+                updated_at: new Date().toISOString(),
+            };
+        },
     };
 }

package/build/shared/src/server.js

@@ -173,6 +173,19 @@ export class PulseMCPAdminClient {
         const { deleteMcpJson } = await import('./pulsemcp-admin-client/lib/delete-mcp-json.js');
         return deleteMcpJson(this.apiKey, this.baseUrl, id);
     }
+    // Unified MCP Server methods (abstracted interface)
+    async getUnifiedMCPServers(params) {
+        const { getUnifiedMCPServers } = await import('./pulsemcp-admin-client/lib/get-unified-mcp-servers.js');
+        return getUnifiedMCPServers(this.apiKey, this.baseUrl, params);
+    }
+    async getUnifiedMCPServer(slug) {
+        const { getUnifiedMCPServer } = await import('./pulsemcp-admin-client/lib/get-unified-mcp-server.js');
+        return getUnifiedMCPServer(this.apiKey, this.baseUrl, slug);
+    }
+    async updateUnifiedMCPServer(implementationId, params) {
+        const { updateUnifiedMCPServer } = await import('./pulsemcp-admin-client/lib/update-unified-mcp-server.js');
+        return updateUnifiedMCPServer(this.apiKey, this.baseUrl, implementationId, params);
+    }
 }
 export function createMCPServer() {
     const server = new Server({