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

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/index.js

@@ -1,7 +1,15 @@
 #!/usr/bin/env node
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createMCPServer } from '../shared/index.js';
 import { logServerStart, logError } from '../shared/logging.js';
+// Read version from package.json
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = join(__dirname, '..', 'package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+const VERSION = packageJson.version;
 // Validate required environment variables before starting
 function validateEnvironment() {
     const required = [
@@ -33,7 +41,7 @@ async function main() {
     // Validate environment variables first
     validateEnvironment();
     // Create server using factory
-    const { server, registerHandlers } = createMCPServer();
+    const { server, registerHandlers } = createMCPServer({ version: VERSION });
     // Register all handlers (resources and tools)
     await registerHandlers(server);
     // Start server

package/build/local/src/index.integration-with-mock.js

@@ -7,11 +7,19 @@
  *
  * Mock data is passed via the PULSEMCP_MOCK_DATA environment variable.
  */
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 // IMPORTANT: This uses the package name pattern, not a relative path
 import { createMCPServer } from 'pulsemcp-cms-admin-mcp-server-shared';
 // Import the mock client factory from the shared module
 import { createMockPulseMCPAdminClient } from '../../shared/src/pulsemcp-admin-client/pulsemcp-admin-client.integration-mock.js';
+// Read version from package.json
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = join(__dirname, '..', 'package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+const VERSION = packageJson.version;
 async function main() {
     const transport = new StdioServerTransport();
     // Parse mock data from environment variable
@@ -26,7 +34,7 @@ async function main() {
     }
     // Create client factory that returns our mock
     const clientFactory = () => createMockPulseMCPAdminClient(mockData);
-    const { server, registerHandlers } = createMCPServer();
+    const { server, registerHandlers } = createMCPServer({ version: VERSION });
     await registerHandlers(server, clientFactory);
     await server.connect(transport);
 }

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

@@ -0,0 +1,179 @@
+export async function createMCPImplementation(apiKey, baseUrl, params) {
+    const url = new URL(`/api/implementations`, baseUrl);
+    // Build form data for the POST request
+    const formData = new URLSearchParams();
+    // Required fields for creation
+    formData.append('mcp_implementation[name]', params.name);
+    formData.append('mcp_implementation[type]', params.type);
+    // Optional fields
+    if (params.short_description !== undefined) {
+        formData.append('mcp_implementation[short_description]', params.short_description);
+    }
+    if (params.description !== undefined) {
+        formData.append('mcp_implementation[description]', params.description);
+    }
+    if (params.status !== undefined) {
+        formData.append('mcp_implementation[status]', params.status);
+    }
+    if (params.slug !== undefined) {
+        formData.append('mcp_implementation[slug]', params.slug);
+    }
+    if (params.url !== undefined) {
+        // Backend expects 'marketing_url' field, but tool exposes it as 'url' for better UX
+        formData.append('mcp_implementation[marketing_url]', params.url);
+    }
+    if (params.provider_name !== undefined) {
+        formData.append('mcp_implementation[provider_name]', params.provider_name);
+    }
+    if (params.github_stars !== undefined) {
+        formData.append('mcp_implementation[github_stars]', params.github_stars === null ? '' : params.github_stars.toString());
+    }
+    if (params.classification !== undefined) {
+        formData.append('mcp_implementation[classification]', params.classification);
+    }
+    if (params.implementation_language !== undefined) {
+        formData.append('mcp_implementation[implementation_language]', params.implementation_language);
+    }
+    if (params.mcp_server_id !== undefined) {
+        formData.append('mcp_implementation[mcp_server_id]', params.mcp_server_id === null ? '' : params.mcp_server_id.toString());
+    }
+    if (params.mcp_client_id !== undefined) {
+        formData.append('mcp_implementation[mcp_client_id]', params.mcp_client_id === null ? '' : params.mcp_client_id.toString());
+    }
+    // Provider creation/linking
+    if (params.provider_id !== undefined) {
+        formData.append('mcp_implementation[provider_id]', params.provider_id.toString());
+    }
+    if (params.provider_slug !== undefined) {
+        formData.append('mcp_implementation[provider_slug]', params.provider_slug);
+    }
+    if (params.provider_url !== undefined) {
+        formData.append('mcp_implementation[provider_url]', params.provider_url);
+    }
+    // GitHub repository fields
+    if (params.github_owner !== undefined) {
+        formData.append('mcp_implementation[github_owner]', params.github_owner);
+    }
+    if (params.github_repo !== undefined) {
+        formData.append('mcp_implementation[github_repo]', params.github_repo);
+    }
+    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);
+    }
+    // Remote endpoints
+    // Rails expects nested attributes to use the _attributes suffix for has_many associations
+    if (params.remote !== undefined) {
+        if (params.remote.length > 0) {
+            params.remote.forEach((remote, index) => {
+                if (remote.id !== undefined) {
+                    formData.append(`mcp_implementation[remote_attributes][${index}][id]`, remote.id.toString());
+                }
+                if (remote.url_direct !== undefined) {
+                    formData.append(`mcp_implementation[remote_attributes][${index}][url_direct]`, remote.url_direct);
+                }
+                if (remote.url_setup !== undefined) {
+                    formData.append(`mcp_implementation[remote_attributes][${index}][url_setup]`, remote.url_setup);
+                }
+                if (remote.transport !== undefined) {
+                    formData.append(`mcp_implementation[remote_attributes][${index}][transport]`, remote.transport);
+                }
+                if (remote.host_platform !== undefined) {
+                    formData.append(`mcp_implementation[remote_attributes][${index}][host_platform]`, remote.host_platform);
+                }
+                if (remote.host_infrastructure !== undefined) {
+                    formData.append(`mcp_implementation[remote_attributes][${index}][host_infrastructure]`, remote.host_infrastructure);
+                }
+                if (remote.authentication_method !== undefined) {
+                    formData.append(`mcp_implementation[remote_attributes][${index}][authentication_method]`, remote.authentication_method);
+                }
+                if (remote.cost !== undefined) {
+                    formData.append(`mcp_implementation[remote_attributes][${index}][cost]`, remote.cost);
+                }
+                if (remote.status !== undefined) {
+                    formData.append(`mcp_implementation[remote_attributes][${index}][status]`, remote.status);
+                }
+                if (remote.display_name !== undefined) {
+                    formData.append(`mcp_implementation[remote_attributes][${index}][display_name]`, remote.display_name);
+                }
+                if (remote.internal_notes !== undefined) {
+                    formData.append(`mcp_implementation[remote_attributes][${index}][internal_notes]`, remote.internal_notes);
+                }
+            });
+        }
+    }
+    // Canonical URLs
+    // Rails expects nested attributes to use the _attributes suffix for has_many associations
+    if (params.canonical !== undefined) {
+        if (params.canonical.length > 0) {
+            params.canonical.forEach((canonicalUrl, index) => {
+                formData.append(`mcp_implementation[canonical_attributes][${index}][url]`, canonicalUrl.url);
+                formData.append(`mcp_implementation[canonical_attributes][${index}][scope]`, canonicalUrl.scope);
+                if (canonicalUrl.note !== undefined) {
+                    formData.append(`mcp_implementation[canonical_attributes][${index}][note]`, canonicalUrl.note);
+                }
+            });
+        }
+    }
+    const response = await fetch(url.toString(), {
+        method: 'POST',
+        headers: {
+            'X-API-Key': apiKey,
+            'Content-Type': 'application/x-www-form-urlencoded',
+            Accept: 'application/json',
+        },
+        body: formData.toString(),
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new Error('Invalid API key');
+        }
+        if (response.status === 403) {
+            throw new Error('User lacks admin privileges');
+        }
+        if (response.status === 422) {
+            const errorData = (await response.json());
+            // Handle both array format and single error string format from Rails
+            // Also handle empty arrays - an empty array should fall back to the default message
+            const errors = errorData.errors && errorData.errors.length > 0
+                ? errorData.errors
+                : errorData.error
+                    ? [errorData.error]
+                    : ['Unknown validation error'];
+            throw new Error(`Validation failed: ${errors.join(', ')}`);
+        }
+        throw new Error(`Failed to create MCP implementation: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return data;
+}

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);