pulsemcp-cms-admin-mcp-server 0.5.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/create-mcp-json.js

@@ -0,0 +1,46 @@
+export async function createMcpJson(apiKey, baseUrl, params) {
+    const url = new URL('/api/mcp_jsons', baseUrl);
+    const body = {
+        mcp_servers_unofficial_mirror_id: params.mcp_servers_unofficial_mirror_id,
+        title: params.title,
+        value: typeof params.value === 'string' ? params.value : JSON.stringify(params.value),
+    };
+    if (params.description !== undefined) {
+        body.description = params.description;
+    }
+    const response = await fetch(url.toString(), {
+        method: 'POST',
+        headers: {
+            'X-API-Key': apiKey,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new Error('Invalid API key');
+        }
+        if (response.status === 403) {
+            throw new Error('User lacks write privileges');
+        }
+        if (response.status === 422) {
+            const errorData = (await response.json());
+            throw new Error(`Validation failed: ${errorData.errors?.join(', ') || 'Unknown error'}`);
+        }
+        throw new Error(`Failed to create MCP JSON: ${response.status} ${response.statusText}`);
+    }
+    const mcpJson = (await response.json());
+    return {
+        id: mcpJson.id,
+        mcp_servers_unofficial_mirror_id: mcpJson.mcp_servers_unofficial_mirror_id,
+        unofficial_mirror_name: mcpJson.unofficial_mirror_name,
+        unofficial_mirror_version: mcpJson.unofficial_mirror_version,
+        title: mcpJson.title,
+        description: mcpJson.description,
+        value: mcpJson.value,
+        server_key: mcpJson.server_key,
+        created_at: mcpJson.created_at,
+        updated_at: mcpJson.updated_at,
+    };
+}

package/build/shared/src/pulsemcp-admin-client/lib/create-unofficial-mirror.js

@@ -0,0 +1,55 @@
+export async function createUnofficialMirror(apiKey, baseUrl, params) {
+    const url = new URL('/api/unofficial_mirrors', baseUrl);
+    const body = {
+        name: params.name,
+        version: params.version,
+        jsonb_data: typeof params.jsonb_data === 'string' ? params.jsonb_data : JSON.stringify(params.jsonb_data),
+    };
+    if (params.mcp_server_id !== undefined) {
+        body.mcp_server_id = params.mcp_server_id;
+    }
+    if (params.previous_name !== undefined) {
+        body.previous_name = params.previous_name;
+    }
+    if (params.next_name !== undefined) {
+        body.next_name = params.next_name;
+    }
+    const response = await fetch(url.toString(), {
+        method: 'POST',
+        headers: {
+            'X-API-Key': apiKey,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new Error('Invalid API key');
+        }
+        if (response.status === 403) {
+            throw new Error('User lacks write privileges');
+        }
+        if (response.status === 422) {
+            const errorData = (await response.json());
+            throw new Error(`Validation failed: ${errorData.errors?.join(', ') || 'Unknown error'}`);
+        }
+        throw new Error(`Failed to create unofficial mirror: ${response.status} ${response.statusText}`);
+    }
+    const mirror = (await response.json());
+    return {
+        id: mirror.id,
+        name: mirror.name,
+        version: mirror.version,
+        jsonb_data: mirror.jsonb_data,
+        datetime_ingested: mirror.datetime_ingested,
+        mcp_server_id: mirror.mcp_server_id,
+        mcp_server_slug: mirror.mcp_server_slug,
+        previous_name: mirror.previous_name,
+        next_name: mirror.next_name,
+        proctor_results_count: mirror.proctor_results_count,
+        mcp_jsons_count: mirror.mcp_jsons_count,
+        created_at: mirror.created_at,
+        updated_at: mirror.updated_at,
+    };
+}

package/build/shared/src/pulsemcp-admin-client/lib/delete-mcp-json.js

@@ -0,0 +1,24 @@
+export async function deleteMcpJson(apiKey, baseUrl, id) {
+    const url = new URL(`/api/mcp_jsons/${id}`, baseUrl);
+    const response = await fetch(url.toString(), {
+        method: 'DELETE',
+        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 write privileges');
+        }
+        if (response.status === 404) {
+            throw new Error(`MCP JSON with ID ${id} not found`);
+        }
+        throw new Error(`Failed to delete MCP JSON: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return data;
+}

package/build/shared/src/pulsemcp-admin-client/lib/delete-unofficial-mirror.js

@@ -0,0 +1,24 @@
+export async function deleteUnofficialMirror(apiKey, baseUrl, id) {
+    const url = new URL(`/api/unofficial_mirrors/${id}`, baseUrl);
+    const response = await fetch(url.toString(), {
+        method: 'DELETE',
+        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 write privileges');
+        }
+        if (response.status === 404) {
+            throw new Error(`Unofficial mirror with ID ${id} not found`);
+        }
+        throw new Error(`Failed to delete unofficial mirror: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return data;
+}

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

@@ -0,0 +1,35 @@
+export async function getMcpJson(apiKey, baseUrl, id) {
+    const url = new URL(`/api/mcp_jsons/${id}`, baseUrl);
+    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');
+        }
+        if (response.status === 404) {
+            throw new Error(`MCP JSON with ID ${id} not found`);
+        }
+        throw new Error(`Failed to fetch MCP JSON: ${response.status} ${response.statusText}`);
+    }
+    const mcpJson = (await response.json());
+    return {
+        id: mcpJson.id,
+        mcp_servers_unofficial_mirror_id: mcpJson.mcp_servers_unofficial_mirror_id,
+        unofficial_mirror_name: mcpJson.unofficial_mirror_name,
+        unofficial_mirror_version: mcpJson.unofficial_mirror_version,
+        title: mcpJson.title,
+        description: mcpJson.description,
+        value: mcpJson.value,
+        server_key: mcpJson.server_key,
+        created_at: mcpJson.created_at,
+        updated_at: mcpJson.updated_at,
+    };
+}

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

@@ -0,0 +1,56 @@
+function mapMcpJson(mcpJson) {
+    return {
+        id: mcpJson.id,
+        mcp_servers_unofficial_mirror_id: mcpJson.mcp_servers_unofficial_mirror_id,
+        unofficial_mirror_name: mcpJson.unofficial_mirror_name,
+        unofficial_mirror_version: mcpJson.unofficial_mirror_version,
+        title: mcpJson.title,
+        description: mcpJson.description,
+        value: mcpJson.value,
+        server_key: mcpJson.server_key,
+        created_at: mcpJson.created_at,
+        updated_at: mcpJson.updated_at,
+    };
+}
+export async function getMcpJsons(apiKey, baseUrl, params) {
+    const url = new URL('/api/mcp_jsons', baseUrl);
+    if (params?.unofficial_mirror_id) {
+        url.searchParams.append('unofficial_mirror_id', params.unofficial_mirror_id.toString());
+    }
+    if (params?.q) {
+        url.searchParams.append('q', params.q);
+    }
+    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 JSONs: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return {
+        mcp_jsons: data.data.map(mapMcpJson),
+        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/get-official-mirror.js

@@ -0,0 +1,39 @@
+export async function getOfficialMirror(apiKey, baseUrl, id) {
+    const url = new URL(`/api/official_mirrors/${id}`, baseUrl);
+    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');
+        }
+        if (response.status === 404) {
+            throw new Error(`Official mirror with ID ${id} not found`);
+        }
+        throw new Error(`Failed to fetch official mirror: ${response.status} ${response.statusText}`);
+    }
+    const mirror = (await response.json());
+    return {
+        id: mirror.id,
+        name: mirror.name,
+        version: mirror.version,
+        official_version_id: mirror.official_version_id,
+        jsonb_data: mirror.jsonb_data,
+        datetime_ingested: mirror.datetime_ingested,
+        mcp_server_id: mirror.mcp_server_id,
+        mcp_server_slug: mirror.mcp_server_slug,
+        processed: mirror.processed,
+        processing_failure_reason: mirror.processing_failure_reason,
+        queue_id: mirror.queue_id,
+        queue_status: mirror.queue_status,
+        created_at: mirror.created_at,
+        updated_at: mirror.updated_at,
+    };
+}

package/build/shared/src/pulsemcp-admin-client/lib/get-official-mirrors.js

@@ -0,0 +1,66 @@
+function mapMirror(mirror) {
+    return {
+        id: mirror.id,
+        name: mirror.name,
+        version: mirror.version,
+        official_version_id: mirror.official_version_id,
+        jsonb_data: mirror.jsonb_data,
+        datetime_ingested: mirror.datetime_ingested,
+        mcp_server_id: mirror.mcp_server_id,
+        mcp_server_slug: mirror.mcp_server_slug,
+        processed: mirror.processed,
+        processing_failure_reason: mirror.processing_failure_reason,
+        queue_id: mirror.queue_id,
+        queue_status: mirror.queue_status,
+        created_at: mirror.created_at,
+        updated_at: mirror.updated_at,
+    };
+}
+export async function getOfficialMirrors(apiKey, baseUrl, params) {
+    const url = new URL('/api/official_mirrors', baseUrl);
+    if (params?.q) {
+        url.searchParams.append('q', params.q);
+    }
+    if (params?.mcp_server_id) {
+        url.searchParams.append('mcp_server_id', params.mcp_server_id.toString());
+    }
+    if (params?.status) {
+        url.searchParams.append('status', params.status);
+    }
+    if (params?.processed !== undefined) {
+        url.searchParams.append('processed', params.processed.toString());
+    }
+    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 official mirrors: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return {
+        mirrors: data.data.map(mapMirror),
+        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/get-tenant.js

@@ -0,0 +1,31 @@
+export async function getTenant(apiKey, baseUrl, idOrSlug) {
+    const url = new URL(`/api/tenants/${idOrSlug}`, baseUrl);
+    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');
+        }
+        if (response.status === 404) {
+            throw new Error(`Tenant with ID/slug ${idOrSlug} not found`);
+        }
+        throw new Error(`Failed to fetch tenant: ${response.status} ${response.statusText}`);
+    }
+    const tenant = (await response.json());
+    return {
+        id: tenant.id,
+        slug: tenant.slug,
+        is_admin: tenant.is_admin,
+        enrichments: tenant.enrichments,
+        created_at: tenant.created_at,
+        updated_at: tenant.updated_at,
+    };
+}

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

@@ -0,0 +1,52 @@
+function mapTenant(tenant) {
+    return {
+        id: tenant.id,
+        slug: tenant.slug,
+        is_admin: tenant.is_admin,
+        enrichments: tenant.enrichments,
+        created_at: tenant.created_at,
+        updated_at: tenant.updated_at,
+    };
+}
+export async function getTenants(apiKey, baseUrl, params) {
+    const url = new URL('/api/tenants', baseUrl);
+    if (params?.q) {
+        url.searchParams.append('q', params.q);
+    }
+    if (params?.is_admin !== undefined) {
+        url.searchParams.append('is_admin', params.is_admin.toString());
+    }
+    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 tenants: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return {
+        tenants: data.data.map(mapTenant),
+        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,
+        },
+    };
+}