pulsemcp-cms-admin-mcp-server 0.9.6 → 0.9.7

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

@@ -0,0 +1,23 @@
+/**
+ * Get available runtimes and exams from the Proctor API
+ */
+export async function getProctorMetadata(apiKey, baseUrl) {
+    const url = new URL('/api/proctor/metadata', 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 or insufficient permissions');
+        }
+        throw new Error(`Failed to get proctor metadata: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}

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

@@ -964,6 +964,12 @@ export function createMockPulseMCPAdminClient(mockData) {
                 pagination: { current_page: 1, total_pages: 1, total_count: 0, has_next: false, limit: 30 },
             };
         },
+        async getProctorMetadata() {
+            return {
+                runtimes: [],
+                exams: [],
+            };
+        },
         // Discovered URL methods
         async getDiscoveredUrls() {
             return {

package/build/shared/src/server.js

@@ -64,6 +64,7 @@ import { cleanupGoodJobs } from './pulsemcp-admin-client/lib/cleanup-good-jobs.j
 import { runExamForMirror } from './pulsemcp-admin-client/lib/run-exam-for-mirror.js';
 import { saveResultsForMirror } from './pulsemcp-admin-client/lib/save-results-for-mirror.js';
 import { getProctorRuns } from './pulsemcp-admin-client/lib/get-proctor-runs.js';
+import { getProctorMetadata } from './pulsemcp-admin-client/lib/get-proctor-metadata.js';
 import { getDiscoveredUrls } from './pulsemcp-admin-client/lib/get-discovered-urls.js';
 import { markDiscoveredUrlProcessed } from './pulsemcp-admin-client/lib/mark-discovered-url-processed.js';
 import { getDiscoveredUrlStats } from './pulsemcp-admin-client/lib/get-discovered-url-stats.js';
@@ -270,6 +271,9 @@ export class PulseMCPAdminClient {
     async getProctorRuns(params) {
         return getProctorRuns(this.apiKey, this.baseUrl, params);
     }
+    async getProctorMetadata() {
+        return getProctorMetadata(this.apiKey, this.baseUrl);
+    }
     // Discovered URL REST API methods
     async getDiscoveredUrls(params) {
         return getDiscoveredUrls(this.apiKey, this.baseUrl, params);

package/build/shared/src/tools/get-proctor-metadata.js

@@ -0,0 +1,59 @@
+export function getProctorMetadata(_server, clientFactory) {
+    return {
+        name: 'get_proctor_metadata',
+        description: `Get available runtimes and exams for Proctor testing.
+
+Returns the list of available runtime environments (Docker images) and exam types.
+
+**Returns:**
+- runtimes: Array of runtime configurations with id, name, and Docker image
+- exams: Array of exam types with id, name, and description
+
+**Use cases:**
+- Discover available runtime environments and their IDs (needed for run_exam_for_mirror)
+- Find the correct exam ID for a specific test type
+- Check which runtime versions are available`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+        handler: async () => {
+            const client = clientFactory();
+            try {
+                const response = await client.getProctorMetadata();
+                let content = '## Available Proctor Runtimes\n\n';
+                for (const runtime of response.runtimes) {
+                    content += `- **${runtime.name}** (id: \`${runtime.id}\`)\n`;
+                    content += `  Image: \`${runtime.image}\`\n`;
+                }
+                content += '\n## Available Exams\n\n';
+                for (const exam of response.exams) {
+                    content += `- **${exam.name}** (id: \`${exam.id}\`)\n`;
+                    if (exam.description) {
+                        content += `  ${exam.description}\n`;
+                    }
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: content.trim(),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error getting Proctor metadata: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        },
+    };
+}

package/build/shared/src/tools.js

@@ -61,6 +61,7 @@ import { runExamForMirror } from './tools/run-exam-for-mirror.js';
 import { getExamResult } from './tools/get-exam-result.js';
 import { saveResultsForMirror } from './tools/save-results-for-mirror.js';
 import { listProctorRuns } from './tools/list-proctor-runs.js';
+import { getProctorMetadata } from './tools/get-proctor-metadata.js';
 // Discovered URLs tools
 import { listDiscoveredUrls } from './tools/list-discovered-urls.js';
 import { markDiscoveredUrlProcessed } from './tools/mark-discovered-url-processed.js';
@@ -232,6 +233,7 @@ const ALL_TOOLS = [
     { factory: getExamResult, groups: ['proctor'], isWriteOperation: false },
     { factory: saveResultsForMirror, groups: ['proctor'], isWriteOperation: true },
     { factory: listProctorRuns, groups: ['proctor'], isWriteOperation: false },
+    { factory: getProctorMetadata, groups: ['proctor'], isWriteOperation: false },
     // Discovered URLs tools
     { factory: listDiscoveredUrls, groups: ['discovered_urls'], isWriteOperation: false },
     {
@@ -369,7 +371,7 @@ function shouldIncludeTool(toolDef, enabledGroups) {
  * - good_jobs: GoodJob background job management tools (read + write)
  * - good_jobs_readonly: GoodJob tools (read only)
  * - proctor: Proctor exam execution and result storage tools (read + write)
- * - proctor_readonly: Proctor tools (read only - get_exam_result and list_proctor_runs)
+ * - proctor_readonly: Proctor tools (read only - get_exam_result, list_proctor_runs, and get_proctor_metadata)
  * - discovered_urls: Discovered URL management tools for processing URLs into MCP implementations (read + write)
  * - discovered_urls_readonly: Discovered URL tools (read only - list and stats)
  * - notifications: Notification email tools - send_impl_posted_notif (write-only, no readonly variant)

package/package.json

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

package/shared/pulsemcp-admin-client/lib/get-proctor-metadata.d.ts

@@ -0,0 +1,6 @@
+import type { ProctorMetadataResponse } from '../../types.js';
+/**
+ * Get available runtimes and exams from the Proctor API
+ */
+export declare function getProctorMetadata(apiKey: string, baseUrl: string): Promise<ProctorMetadataResponse>;
+//# sourceMappingURL=get-proctor-metadata.d.ts.map

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

@@ -0,0 +1,23 @@
+/**
+ * Get available runtimes and exams from the Proctor API
+ */
+export async function getProctorMetadata(apiKey, baseUrl) {
+    const url = new URL('/api/proctor/metadata', 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 or insufficient permissions');
+        }
+        throw new Error(`Failed to get proctor metadata: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}

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

@@ -964,6 +964,12 @@ export function createMockPulseMCPAdminClient(mockData) {
                 pagination: { current_page: 1, total_pages: 1, total_count: 0, has_next: false, limit: 30 },
             };
         },
+        async getProctorMetadata() {
+            return {
+                runtimes: [],
+                exams: [],
+            };
+        },
         // Discovered URL methods
         async getDiscoveredUrls() {
             return {

package/shared/server.d.ts

@@ -1,5 +1,5 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import type { Post, PostsResponse, CreatePostParams, UpdatePostParams, ImageUploadResponse, Author, AuthorsResponse, MCPServer, MCPClient, MCPImplementation, MCPImplementationsResponse, SaveMCPImplementationParams, CreateMCPImplementationParams, Provider, ProvidersResponse, OfficialMirrorQueueStatus, OfficialMirrorQueueResponse, OfficialMirrorQueueItemDetail, OfficialMirrorQueueActionResponse, UnofficialMirror, UnofficialMirrorsResponse, CreateUnofficialMirrorParams, UpdateUnofficialMirrorParams, OfficialMirrorRest, OfficialMirrorsResponse, Tenant, TenantsResponse, McpJson, McpJsonsResponse, CreateMcpJsonParams, UpdateMcpJsonParams, UnifiedMCPServer, UnifiedMCPServersResponse, UpdateUnifiedMCPServerParams, Redirect, RedirectsResponse, RedirectStatus, CreateRedirectParams, UpdateRedirectParams, GoodJob, GoodJobsResponse, GoodJobStatus, GoodJobCronSchedule, GoodJobProcess, GoodJobStatistics, GoodJobActionResponse, GoodJobCleanupResponse, ProctorRunExamParams, ProctorRunExamResponse, ProctorSaveResultsParams, ProctorSaveResultsResponse, ProctorRunsResponse, GetProctorRunsParams, DiscoveredUrlsResponse, MarkDiscoveredUrlProcessedParams, MarkDiscoveredUrlProcessedResponse, DiscoveredUrlStats } from './types.js';
+import type { Post, PostsResponse, CreatePostParams, UpdatePostParams, ImageUploadResponse, Author, AuthorsResponse, MCPServer, MCPClient, MCPImplementation, MCPImplementationsResponse, SaveMCPImplementationParams, CreateMCPImplementationParams, Provider, ProvidersResponse, OfficialMirrorQueueStatus, OfficialMirrorQueueResponse, OfficialMirrorQueueItemDetail, OfficialMirrorQueueActionResponse, UnofficialMirror, UnofficialMirrorsResponse, CreateUnofficialMirrorParams, UpdateUnofficialMirrorParams, OfficialMirrorRest, OfficialMirrorsResponse, Tenant, TenantsResponse, McpJson, McpJsonsResponse, CreateMcpJsonParams, UpdateMcpJsonParams, UnifiedMCPServer, UnifiedMCPServersResponse, UpdateUnifiedMCPServerParams, Redirect, RedirectsResponse, RedirectStatus, CreateRedirectParams, UpdateRedirectParams, GoodJob, GoodJobsResponse, GoodJobStatus, GoodJobCronSchedule, GoodJobProcess, GoodJobStatistics, GoodJobActionResponse, GoodJobCleanupResponse, ProctorRunExamParams, ProctorRunExamResponse, ProctorSaveResultsParams, ProctorSaveResultsResponse, ProctorRunsResponse, GetProctorRunsParams, ProctorMetadataResponse, DiscoveredUrlsResponse, MarkDiscoveredUrlProcessedParams, MarkDiscoveredUrlProcessedResponse, DiscoveredUrlStats } from './types.js';
 export interface IPulseMCPAdminClient {
     getPosts(params?: {
         search?: string;
@@ -161,6 +161,7 @@ export interface IPulseMCPAdminClient {
     runExamForMirror(params: ProctorRunExamParams): Promise<ProctorRunExamResponse>;
     saveResultsForMirror(params: ProctorSaveResultsParams): Promise<ProctorSaveResultsResponse>;
     getProctorRuns(params?: GetProctorRunsParams): Promise<ProctorRunsResponse>;
+    getProctorMetadata(): Promise<ProctorMetadataResponse>;
     getDiscoveredUrls(params?: {
         status?: 'pending' | 'processed' | 'all';
         page?: number;
@@ -333,6 +334,7 @@ export declare class PulseMCPAdminClient implements IPulseMCPAdminClient {
     runExamForMirror(params: ProctorRunExamParams): Promise<ProctorRunExamResponse>;
     saveResultsForMirror(params: ProctorSaveResultsParams): Promise<ProctorSaveResultsResponse>;
     getProctorRuns(params?: GetProctorRunsParams): Promise<ProctorRunsResponse>;
+    getProctorMetadata(): Promise<ProctorMetadataResponse>;
     getDiscoveredUrls(params?: {
         status?: 'pending' | 'processed' | 'all';
         page?: number;

package/shared/server.js

@@ -64,6 +64,7 @@ import { cleanupGoodJobs } from './pulsemcp-admin-client/lib/cleanup-good-jobs.j
 import { runExamForMirror } from './pulsemcp-admin-client/lib/run-exam-for-mirror.js';
 import { saveResultsForMirror } from './pulsemcp-admin-client/lib/save-results-for-mirror.js';
 import { getProctorRuns } from './pulsemcp-admin-client/lib/get-proctor-runs.js';
+import { getProctorMetadata } from './pulsemcp-admin-client/lib/get-proctor-metadata.js';
 import { getDiscoveredUrls } from './pulsemcp-admin-client/lib/get-discovered-urls.js';
 import { markDiscoveredUrlProcessed } from './pulsemcp-admin-client/lib/mark-discovered-url-processed.js';
 import { getDiscoveredUrlStats } from './pulsemcp-admin-client/lib/get-discovered-url-stats.js';
@@ -270,6 +271,9 @@ export class PulseMCPAdminClient {
     async getProctorRuns(params) {
         return getProctorRuns(this.apiKey, this.baseUrl, params);
     }
+    async getProctorMetadata() {
+        return getProctorMetadata(this.apiKey, this.baseUrl);
+    }
     // Discovered URL REST API methods
     async getDiscoveredUrls(params) {
         return getDiscoveredUrls(this.apiKey, this.baseUrl, params);

package/shared/tools/get-proctor-metadata.d.ts

@@ -0,0 +1,25 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { ClientFactory } from '../server.js';
+export declare function getProctorMetadata(_server: Server, clientFactory: ClientFactory): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+    handler: () => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};
+//# sourceMappingURL=get-proctor-metadata.d.ts.map

package/shared/tools/get-proctor-metadata.js

@@ -0,0 +1,59 @@
+export function getProctorMetadata(_server, clientFactory) {
+    return {
+        name: 'get_proctor_metadata',
+        description: `Get available runtimes and exams for Proctor testing.
+
+Returns the list of available runtime environments (Docker images) and exam types.
+
+**Returns:**
+- runtimes: Array of runtime configurations with id, name, and Docker image
+- exams: Array of exam types with id, name, and description
+
+**Use cases:**
+- Discover available runtime environments and their IDs (needed for run_exam_for_mirror)
+- Find the correct exam ID for a specific test type
+- Check which runtime versions are available`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+        handler: async () => {
+            const client = clientFactory();
+            try {
+                const response = await client.getProctorMetadata();
+                let content = '## Available Proctor Runtimes\n\n';
+                for (const runtime of response.runtimes) {
+                    content += `- **${runtime.name}** (id: \`${runtime.id}\`)\n`;
+                    content += `  Image: \`${runtime.image}\`\n`;
+                }
+                content += '\n## Available Exams\n\n';
+                for (const exam of response.exams) {
+                    content += `- **${exam.name}** (id: \`${exam.id}\`)\n`;
+                    if (exam.description) {
+                        content += `  ${exam.description}\n`;
+                    }
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: content.trim(),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error getting Proctor metadata: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        },
+    };
+}

package/shared/tools.d.ts

@@ -23,7 +23,7 @@ import { ClientFactory } from './server.js';
  * - mcp_servers / mcp_servers_readonly: Unified MCP server tools (abstracted interface)
  * - redirects / redirects_readonly: URL redirect management tools
  * - good_jobs / good_jobs_readonly: GoodJob background job management tools
- * - proctor / proctor_readonly: Proctor exam execution and result storage tools. The readonly variant includes get_exam_result and list_proctor_runs for retrieving stored results without running exams or saving
+ * - proctor / proctor_readonly: Proctor exam execution and result storage tools. The readonly variant includes get_exam_result, list_proctor_runs, and get_proctor_metadata for retrieving stored results and metadata without running exams or saving
  * - discovered_urls / discovered_urls_readonly: Discovered URL management tools for processing URLs into MCP implementations
  * - notifications: Notification email tools (send_impl_posted_notif). Separated from server_directory so notification capability can be granted independently.
  */
@@ -69,7 +69,7 @@ export declare function parseEnabledToolGroups(enabledGroupsParam?: string): Too
  * - good_jobs: GoodJob background job management tools (read + write)
  * - good_jobs_readonly: GoodJob tools (read only)
  * - proctor: Proctor exam execution and result storage tools (read + write)
- * - proctor_readonly: Proctor tools (read only - get_exam_result and list_proctor_runs)
+ * - proctor_readonly: Proctor tools (read only - get_exam_result, list_proctor_runs, and get_proctor_metadata)
  * - discovered_urls: Discovered URL management tools for processing URLs into MCP implementations (read + write)
  * - discovered_urls_readonly: Discovered URL tools (read only - list and stats)
  * - notifications: Notification email tools - send_impl_posted_notif (write-only, no readonly variant)

package/shared/tools.js

@@ -61,6 +61,7 @@ import { runExamForMirror } from './tools/run-exam-for-mirror.js';
 import { getExamResult } from './tools/get-exam-result.js';
 import { saveResultsForMirror } from './tools/save-results-for-mirror.js';
 import { listProctorRuns } from './tools/list-proctor-runs.js';
+import { getProctorMetadata } from './tools/get-proctor-metadata.js';
 // Discovered URLs tools
 import { listDiscoveredUrls } from './tools/list-discovered-urls.js';
 import { markDiscoveredUrlProcessed } from './tools/mark-discovered-url-processed.js';
@@ -232,6 +233,7 @@ const ALL_TOOLS = [
     { factory: getExamResult, groups: ['proctor'], isWriteOperation: false },
     { factory: saveResultsForMirror, groups: ['proctor'], isWriteOperation: true },
     { factory: listProctorRuns, groups: ['proctor'], isWriteOperation: false },
+    { factory: getProctorMetadata, groups: ['proctor'], isWriteOperation: false },
     // Discovered URLs tools
     { factory: listDiscoveredUrls, groups: ['discovered_urls'], isWriteOperation: false },
     {
@@ -369,7 +371,7 @@ function shouldIncludeTool(toolDef, enabledGroups) {
  * - good_jobs: GoodJob background job management tools (read + write)
  * - good_jobs_readonly: GoodJob tools (read only)
  * - proctor: Proctor exam execution and result storage tools (read + write)
- * - proctor_readonly: Proctor tools (read only - get_exam_result and list_proctor_runs)
+ * - proctor_readonly: Proctor tools (read only - get_exam_result, list_proctor_runs, and get_proctor_metadata)
  * - discovered_urls: Discovered URL management tools for processing URLs into MCP implementations (read + write)
  * - discovered_urls_readonly: Discovered URL tools (read only - list and stats)
  * - notifications: Notification email tools - send_impl_posted_notif (write-only, no readonly variant)

package/shared/types.d.ts

@@ -736,6 +736,20 @@ export interface GetProctorRunsParams {
     limit?: number;
     offset?: number;
 }
+export interface ProctorRuntime {
+    id: string;
+    name: string;
+    image: string;
+}
+export interface ProctorExam {
+    id: string;
+    name: string;
+    description: string;
+}
+export interface ProctorMetadataResponse {
+    runtimes: ProctorRuntime[];
+    exams: ProctorExam[];
+}
 export type DiscoveredUrlResult = 'posted' | 'skipped' | 'rejected' | 'error';
 export interface DiscoveredUrl {
     id: number;