pulsemcp-cms-admin-mcp-server 0.9.5 → 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

@@ -1,5 +1,73 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { createRegisterTools } from './tools.js';
+// Static imports for all API client functions (replaces dynamic imports
+// which can fail at runtime in some environments due to ESM resolution)
+import { getPosts } from './pulsemcp-admin-client/lib/get-posts.js';
+import { getPost } from './pulsemcp-admin-client/lib/get-post.js';
+import { createPost } from './pulsemcp-admin-client/lib/create-post.js';
+import { updatePost } from './pulsemcp-admin-client/lib/update-post.js';
+import { uploadImage } from './pulsemcp-admin-client/lib/upload-image.js';
+import { getAuthors } from './pulsemcp-admin-client/lib/get-authors.js';
+import { getAuthorBySlug } from './pulsemcp-admin-client/lib/get-author-by-slug.js';
+import { getAuthorById } from './pulsemcp-admin-client/lib/get-author-by-id.js';
+import { getMCPServerBySlug } from './pulsemcp-admin-client/lib/get-mcp-server-by-slug.js';
+import { getMCPServerById } from './pulsemcp-admin-client/lib/get-mcp-server-by-id.js';
+import { getMCPClientBySlug } from './pulsemcp-admin-client/lib/get-mcp-client-by-slug.js';
+import { getMCPClientById } from './pulsemcp-admin-client/lib/get-mcp-client-by-id.js';
+import { getMCPImplementationById } from './pulsemcp-admin-client/lib/get-mcp-implementation-by-id.js';
+import { searchMCPImplementations } from './pulsemcp-admin-client/lib/search-mcp-implementations.js';
+import { getDraftMCPImplementations } from './pulsemcp-admin-client/lib/get-draft-mcp-implementations.js';
+import { saveMCPImplementation } from './pulsemcp-admin-client/lib/save-mcp-implementation.js';
+import { createMCPImplementation } from './pulsemcp-admin-client/lib/create-mcp-implementation.js';
+import { sendEmail } from './pulsemcp-admin-client/lib/send-email.js';
+import { searchProviders } from './pulsemcp-admin-client/lib/search-providers.js';
+import { getProviderById } from './pulsemcp-admin-client/lib/get-provider-by-id.js';
+import { getOfficialMirrorQueueItems } from './pulsemcp-admin-client/lib/get-official-mirror-queue-items.js';
+import { getOfficialMirrorQueueItem } from './pulsemcp-admin-client/lib/get-official-mirror-queue-item.js';
+import { approveOfficialMirrorQueueItem } from './pulsemcp-admin-client/lib/approve-official-mirror-queue-item.js';
+import { approveOfficialMirrorQueueItemWithoutModifying } from './pulsemcp-admin-client/lib/approve-official-mirror-queue-item-without-modifying.js';
+import { rejectOfficialMirrorQueueItem } from './pulsemcp-admin-client/lib/reject-official-mirror-queue-item.js';
+import { addOfficialMirrorToRegularQueue } from './pulsemcp-admin-client/lib/add-official-mirror-to-regular-queue.js';
+import { unlinkOfficialMirrorQueueItem } from './pulsemcp-admin-client/lib/unlink-official-mirror-queue-item.js';
+import { getUnofficialMirrors } from './pulsemcp-admin-client/lib/get-unofficial-mirrors.js';
+import { getUnofficialMirror } from './pulsemcp-admin-client/lib/get-unofficial-mirror.js';
+import { createUnofficialMirror } from './pulsemcp-admin-client/lib/create-unofficial-mirror.js';
+import { updateUnofficialMirror } from './pulsemcp-admin-client/lib/update-unofficial-mirror.js';
+import { deleteUnofficialMirror } from './pulsemcp-admin-client/lib/delete-unofficial-mirror.js';
+import { getOfficialMirrors } from './pulsemcp-admin-client/lib/get-official-mirrors.js';
+import { getOfficialMirror } from './pulsemcp-admin-client/lib/get-official-mirror.js';
+import { getTenants } from './pulsemcp-admin-client/lib/get-tenants.js';
+import { getTenant } from './pulsemcp-admin-client/lib/get-tenant.js';
+import { getMcpJsons } from './pulsemcp-admin-client/lib/get-mcp-jsons.js';
+import { getMcpJson } from './pulsemcp-admin-client/lib/get-mcp-json.js';
+import { createMcpJson } from './pulsemcp-admin-client/lib/create-mcp-json.js';
+import { updateMcpJson } from './pulsemcp-admin-client/lib/update-mcp-json.js';
+import { deleteMcpJson } from './pulsemcp-admin-client/lib/delete-mcp-json.js';
+import { getUnifiedMCPServers } from './pulsemcp-admin-client/lib/get-unified-mcp-servers.js';
+import { getUnifiedMCPServer } from './pulsemcp-admin-client/lib/get-unified-mcp-server.js';
+import { updateUnifiedMCPServer } from './pulsemcp-admin-client/lib/update-unified-mcp-server.js';
+import { getRedirects } from './pulsemcp-admin-client/lib/get-redirects.js';
+import { getRedirect } from './pulsemcp-admin-client/lib/get-redirect.js';
+import { createRedirect } from './pulsemcp-admin-client/lib/create-redirect.js';
+import { updateRedirect } from './pulsemcp-admin-client/lib/update-redirect.js';
+import { deleteRedirect } from './pulsemcp-admin-client/lib/delete-redirect.js';
+import { getGoodJobs } from './pulsemcp-admin-client/lib/get-good-jobs.js';
+import { getGoodJob } from './pulsemcp-admin-client/lib/get-good-job.js';
+import { getGoodJobCronSchedules } from './pulsemcp-admin-client/lib/get-good-job-cron-schedules.js';
+import { getGoodJobProcesses } from './pulsemcp-admin-client/lib/get-good-job-processes.js';
+import { getGoodJobStatistics } from './pulsemcp-admin-client/lib/get-good-job-statistics.js';
+import { retryGoodJob } from './pulsemcp-admin-client/lib/retry-good-job.js';
+import { discardGoodJob } from './pulsemcp-admin-client/lib/discard-good-job.js';
+import { rescheduleGoodJob } from './pulsemcp-admin-client/lib/reschedule-good-job.js';
+import { forceTriggerGoodJobCron } from './pulsemcp-admin-client/lib/force-trigger-good-job-cron.js';
+import { cleanupGoodJobs } from './pulsemcp-admin-client/lib/cleanup-good-jobs.js';
+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';
 // PulseMCP Admin API client implementation
 export class PulseMCPAdminClient {
     apiKey;
@@ -9,273 +77,211 @@ export class PulseMCPAdminClient {
         this.baseUrl = baseUrl || 'https://admin.pulsemcp.com';
     }
     async getPosts(params) {
-        const { getPosts } = await import('./pulsemcp-admin-client/lib/get-posts.js');
         return getPosts(this.apiKey, this.baseUrl, params);
     }
     async getPost(slug) {
-        const { getPost } = await import('./pulsemcp-admin-client/lib/get-post.js');
         return getPost(this.apiKey, this.baseUrl, slug);
     }
     async createPost(params) {
-        const { createPost } = await import('./pulsemcp-admin-client/lib/create-post.js');
         return createPost(this.apiKey, this.baseUrl, params);
     }
     async updatePost(slug, params) {
-        const { updatePost } = await import('./pulsemcp-admin-client/lib/update-post.js');
         return updatePost(this.apiKey, this.baseUrl, slug, params);
     }
     async uploadImage(postSlug, fileName, fileData) {
-        const { uploadImage } = await import('./pulsemcp-admin-client/lib/upload-image.js');
         return uploadImage(this.apiKey, this.baseUrl, postSlug, fileName, fileData);
     }
     async getAuthors(params) {
-        const { getAuthors } = await import('./pulsemcp-admin-client/lib/get-authors.js');
         return getAuthors(this.apiKey, this.baseUrl, params);
     }
     async getAuthorBySlug(slug) {
-        const { getAuthorBySlug } = await import('./pulsemcp-admin-client/lib/get-author-by-slug.js');
         return getAuthorBySlug(this.apiKey, this.baseUrl, slug);
     }
     async getAuthorById(id) {
-        const { getAuthorById } = await import('./pulsemcp-admin-client/lib/get-author-by-id.js');
         return getAuthorById(this.apiKey, this.baseUrl, id);
     }
     async getMCPServerBySlug(slug) {
-        const { getMCPServerBySlug } = await import('./pulsemcp-admin-client/lib/get-mcp-server-by-slug.js');
         return getMCPServerBySlug(this.apiKey, this.baseUrl, slug);
     }
     async getMCPServerById(id) {
-        const { getMCPServerById } = await import('./pulsemcp-admin-client/lib/get-mcp-server-by-id.js');
         return getMCPServerById(this.apiKey, this.baseUrl, id);
     }
     async getMCPClientBySlug(slug) {
-        const { getMCPClientBySlug } = await import('./pulsemcp-admin-client/lib/get-mcp-client-by-slug.js');
         return getMCPClientBySlug(this.apiKey, this.baseUrl, slug);
     }
     async getMCPClientById(id) {
-        const { getMCPClientById } = await import('./pulsemcp-admin-client/lib/get-mcp-client-by-id.js');
         return getMCPClientById(this.apiKey, this.baseUrl, id);
     }
     async getMCPImplementationById(id) {
-        const { getMCPImplementationById } = await import('./pulsemcp-admin-client/lib/get-mcp-implementation-by-id.js');
         return getMCPImplementationById(this.apiKey, this.baseUrl, id);
     }
     async searchMCPImplementations(params) {
-        const { searchMCPImplementations } = await import('./pulsemcp-admin-client/lib/search-mcp-implementations.js');
         return searchMCPImplementations(this.apiKey, this.baseUrl, params);
     }
     async getDraftMCPImplementations(params) {
-        const { getDraftMCPImplementations } = await import('./pulsemcp-admin-client/lib/get-draft-mcp-implementations.js');
         return getDraftMCPImplementations(this.apiKey, this.baseUrl, params);
     }
     async saveMCPImplementation(id, params) {
-        const { saveMCPImplementation } = await import('./pulsemcp-admin-client/lib/save-mcp-implementation.js');
         return saveMCPImplementation(this.apiKey, this.baseUrl, id, params);
     }
     async createMCPImplementation(params) {
-        const { createMCPImplementation } = await import('./pulsemcp-admin-client/lib/create-mcp-implementation.js');
         return createMCPImplementation(this.apiKey, this.baseUrl, params);
     }
     async sendEmail(params) {
-        const { sendEmail } = await import('./pulsemcp-admin-client/lib/send-email.js');
         return sendEmail(this.apiKey, this.baseUrl, params);
     }
     async searchProviders(params) {
-        const { searchProviders } = await import('./pulsemcp-admin-client/lib/search-providers.js');
         return searchProviders(this.apiKey, this.baseUrl, params);
     }
     async getProviderById(id) {
-        const { getProviderById } = await import('./pulsemcp-admin-client/lib/get-provider-by-id.js');
         return getProviderById(this.apiKey, this.baseUrl, id);
     }
     // Official Mirror Queue methods
     async getOfficialMirrorQueueItems(params) {
-        const { getOfficialMirrorQueueItems } = await import('./pulsemcp-admin-client/lib/get-official-mirror-queue-items.js');
         return getOfficialMirrorQueueItems(this.apiKey, this.baseUrl, params);
     }
     async getOfficialMirrorQueueItem(id) {
-        const { getOfficialMirrorQueueItem } = await import('./pulsemcp-admin-client/lib/get-official-mirror-queue-item.js');
         return getOfficialMirrorQueueItem(this.apiKey, this.baseUrl, id);
     }
     async approveOfficialMirrorQueueItem(id, mcpServerSlug) {
-        const { approveOfficialMirrorQueueItem } = await import('./pulsemcp-admin-client/lib/approve-official-mirror-queue-item.js');
         return approveOfficialMirrorQueueItem(this.apiKey, this.baseUrl, id, mcpServerSlug);
     }
     async approveOfficialMirrorQueueItemWithoutModifying(id) {
-        const { approveOfficialMirrorQueueItemWithoutModifying } = await import('./pulsemcp-admin-client/lib/approve-official-mirror-queue-item-without-modifying.js');
         return approveOfficialMirrorQueueItemWithoutModifying(this.apiKey, this.baseUrl, id);
     }
     async rejectOfficialMirrorQueueItem(id) {
-        const { rejectOfficialMirrorQueueItem } = await import('./pulsemcp-admin-client/lib/reject-official-mirror-queue-item.js');
         return rejectOfficialMirrorQueueItem(this.apiKey, this.baseUrl, id);
     }
     async addOfficialMirrorToRegularQueue(id) {
-        const { addOfficialMirrorToRegularQueue } = await import('./pulsemcp-admin-client/lib/add-official-mirror-to-regular-queue.js');
         return addOfficialMirrorToRegularQueue(this.apiKey, this.baseUrl, id);
     }
     async unlinkOfficialMirrorQueueItem(id) {
-        const { unlinkOfficialMirrorQueueItem } = await import('./pulsemcp-admin-client/lib/unlink-official-mirror-queue-item.js');
         return unlinkOfficialMirrorQueueItem(this.apiKey, this.baseUrl, id);
     }
     // Unofficial Mirror REST API methods
     async getUnofficialMirrors(params) {
-        const { getUnofficialMirrors } = await import('./pulsemcp-admin-client/lib/get-unofficial-mirrors.js');
         return getUnofficialMirrors(this.apiKey, this.baseUrl, params);
     }
     async getUnofficialMirror(id) {
-        const { getUnofficialMirror } = await import('./pulsemcp-admin-client/lib/get-unofficial-mirror.js');
         return getUnofficialMirror(this.apiKey, this.baseUrl, id);
     }
     async createUnofficialMirror(params) {
-        const { createUnofficialMirror } = await import('./pulsemcp-admin-client/lib/create-unofficial-mirror.js');
         return createUnofficialMirror(this.apiKey, this.baseUrl, params);
     }
     async updateUnofficialMirror(id, params) {
-        const { updateUnofficialMirror } = await import('./pulsemcp-admin-client/lib/update-unofficial-mirror.js');
         return updateUnofficialMirror(this.apiKey, this.baseUrl, id, params);
     }
     async deleteUnofficialMirror(id) {
-        const { deleteUnofficialMirror } = await import('./pulsemcp-admin-client/lib/delete-unofficial-mirror.js');
         return deleteUnofficialMirror(this.apiKey, this.baseUrl, id);
     }
     // Official Mirror REST API methods (read-only)
     async getOfficialMirrors(params) {
-        const { getOfficialMirrors } = await import('./pulsemcp-admin-client/lib/get-official-mirrors.js');
         return getOfficialMirrors(this.apiKey, this.baseUrl, params);
     }
     async getOfficialMirror(id) {
-        const { getOfficialMirror } = await import('./pulsemcp-admin-client/lib/get-official-mirror.js');
         return getOfficialMirror(this.apiKey, this.baseUrl, id);
     }
     // Tenant REST API methods (read-only)
     async getTenants(params) {
-        const { getTenants } = await import('./pulsemcp-admin-client/lib/get-tenants.js');
         return getTenants(this.apiKey, this.baseUrl, params);
     }
     async getTenant(idOrSlug) {
-        const { getTenant } = await import('./pulsemcp-admin-client/lib/get-tenant.js');
         return getTenant(this.apiKey, this.baseUrl, idOrSlug);
     }
     // MCP JSON REST API methods
     async getMcpJsons(params) {
-        const { getMcpJsons } = await import('./pulsemcp-admin-client/lib/get-mcp-jsons.js');
         return getMcpJsons(this.apiKey, this.baseUrl, params);
     }
     async getMcpJson(id) {
-        const { getMcpJson } = await import('./pulsemcp-admin-client/lib/get-mcp-json.js');
         return getMcpJson(this.apiKey, this.baseUrl, id);
     }
     async createMcpJson(params) {
-        const { createMcpJson } = await import('./pulsemcp-admin-client/lib/create-mcp-json.js');
         return createMcpJson(this.apiKey, this.baseUrl, params);
     }
     async updateMcpJson(id, params) {
-        const { updateMcpJson } = await import('./pulsemcp-admin-client/lib/update-mcp-json.js');
         return updateMcpJson(this.apiKey, this.baseUrl, id, params);
     }
     async deleteMcpJson(id) {
-        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);
     }
     // Redirect REST API methods
     async getRedirects(params) {
-        const { getRedirects } = await import('./pulsemcp-admin-client/lib/get-redirects.js');
         return getRedirects(this.apiKey, this.baseUrl, params);
     }
     async getRedirect(id) {
-        const { getRedirect } = await import('./pulsemcp-admin-client/lib/get-redirect.js');
         return getRedirect(this.apiKey, this.baseUrl, id);
     }
     async createRedirect(params) {
-        const { createRedirect } = await import('./pulsemcp-admin-client/lib/create-redirect.js');
         return createRedirect(this.apiKey, this.baseUrl, params);
     }
     async updateRedirect(id, params) {
-        const { updateRedirect } = await import('./pulsemcp-admin-client/lib/update-redirect.js');
         return updateRedirect(this.apiKey, this.baseUrl, id, params);
     }
     async deleteRedirect(id) {
-        const { deleteRedirect } = await import('./pulsemcp-admin-client/lib/delete-redirect.js');
         return deleteRedirect(this.apiKey, this.baseUrl, id);
     }
     // GoodJob REST API methods
     async getGoodJobs(params) {
-        const { getGoodJobs } = await import('./pulsemcp-admin-client/lib/get-good-jobs.js');
         return getGoodJobs(this.apiKey, this.baseUrl, params);
     }
     async getGoodJob(id) {
-        const { getGoodJob } = await import('./pulsemcp-admin-client/lib/get-good-job.js');
         return getGoodJob(this.apiKey, this.baseUrl, id);
     }
     async getGoodJobCronSchedules() {
-        const { getGoodJobCronSchedules } = await import('./pulsemcp-admin-client/lib/get-good-job-cron-schedules.js');
         return getGoodJobCronSchedules(this.apiKey, this.baseUrl);
     }
     async getGoodJobProcesses() {
-        const { getGoodJobProcesses } = await import('./pulsemcp-admin-client/lib/get-good-job-processes.js');
         return getGoodJobProcesses(this.apiKey, this.baseUrl);
     }
     async getGoodJobStatistics() {
-        const { getGoodJobStatistics } = await import('./pulsemcp-admin-client/lib/get-good-job-statistics.js');
         return getGoodJobStatistics(this.apiKey, this.baseUrl);
     }
     async retryGoodJob(id) {
-        const { retryGoodJob } = await import('./pulsemcp-admin-client/lib/retry-good-job.js');
         return retryGoodJob(this.apiKey, this.baseUrl, id);
     }
     async discardGoodJob(id) {
-        const { discardGoodJob } = await import('./pulsemcp-admin-client/lib/discard-good-job.js');
         return discardGoodJob(this.apiKey, this.baseUrl, id);
     }
     async rescheduleGoodJob(id, scheduledAt) {
-        const { rescheduleGoodJob } = await import('./pulsemcp-admin-client/lib/reschedule-good-job.js');
         return rescheduleGoodJob(this.apiKey, this.baseUrl, id, scheduledAt);
     }
     async forceTriggerGoodJobCron(cronKey) {
-        const { forceTriggerGoodJobCron } = await import('./pulsemcp-admin-client/lib/force-trigger-good-job-cron.js');
         return forceTriggerGoodJobCron(this.apiKey, this.baseUrl, cronKey);
     }
     async cleanupGoodJobs(params) {
-        const { cleanupGoodJobs } = await import('./pulsemcp-admin-client/lib/cleanup-good-jobs.js');
         return cleanupGoodJobs(this.apiKey, this.baseUrl, params);
     }
     // Proctor REST API methods
     async runExamForMirror(params) {
-        const { runExamForMirror } = await import('./pulsemcp-admin-client/lib/run-exam-for-mirror.js');
         return runExamForMirror(this.apiKey, this.baseUrl, params);
     }
     async saveResultsForMirror(params) {
-        const { saveResultsForMirror } = await import('./pulsemcp-admin-client/lib/save-results-for-mirror.js');
         return saveResultsForMirror(this.apiKey, this.baseUrl, params);
     }
     async getProctorRuns(params) {
-        const { getProctorRuns } = await import('./pulsemcp-admin-client/lib/get-proctor-runs.js');
         return getProctorRuns(this.apiKey, this.baseUrl, params);
     }
+    async getProctorMetadata() {
+        return getProctorMetadata(this.apiKey, this.baseUrl);
+    }
     // Discovered URL REST API methods
     async getDiscoveredUrls(params) {
-        const { getDiscoveredUrls } = await import('./pulsemcp-admin-client/lib/get-discovered-urls.js');
         return getDiscoveredUrls(this.apiKey, this.baseUrl, params);
     }
     async markDiscoveredUrlProcessed(params) {
-        const { markDiscoveredUrlProcessed } = await import('./pulsemcp-admin-client/lib/mark-discovered-url-processed.js');
         return markDiscoveredUrlProcessed(this.apiKey, this.baseUrl, params);
     }
     async getDiscoveredUrlStats() {
-        const { getDiscoveredUrlStats } = await import('./pulsemcp-admin-client/lib/get-discovered-url-stats.js');
         return getDiscoveredUrlStats(this.apiKey, this.baseUrl);
     }
 }

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.5",
+  "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

@@ -1,5 +1,73 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { createRegisterTools } from './tools.js';
+// Static imports for all API client functions (replaces dynamic imports
+// which can fail at runtime in some environments due to ESM resolution)
+import { getPosts } from './pulsemcp-admin-client/lib/get-posts.js';
+import { getPost } from './pulsemcp-admin-client/lib/get-post.js';
+import { createPost } from './pulsemcp-admin-client/lib/create-post.js';
+import { updatePost } from './pulsemcp-admin-client/lib/update-post.js';
+import { uploadImage } from './pulsemcp-admin-client/lib/upload-image.js';
+import { getAuthors } from './pulsemcp-admin-client/lib/get-authors.js';
+import { getAuthorBySlug } from './pulsemcp-admin-client/lib/get-author-by-slug.js';
+import { getAuthorById } from './pulsemcp-admin-client/lib/get-author-by-id.js';
+import { getMCPServerBySlug } from './pulsemcp-admin-client/lib/get-mcp-server-by-slug.js';
+import { getMCPServerById } from './pulsemcp-admin-client/lib/get-mcp-server-by-id.js';
+import { getMCPClientBySlug } from './pulsemcp-admin-client/lib/get-mcp-client-by-slug.js';
+import { getMCPClientById } from './pulsemcp-admin-client/lib/get-mcp-client-by-id.js';
+import { getMCPImplementationById } from './pulsemcp-admin-client/lib/get-mcp-implementation-by-id.js';
+import { searchMCPImplementations } from './pulsemcp-admin-client/lib/search-mcp-implementations.js';
+import { getDraftMCPImplementations } from './pulsemcp-admin-client/lib/get-draft-mcp-implementations.js';
+import { saveMCPImplementation } from './pulsemcp-admin-client/lib/save-mcp-implementation.js';
+import { createMCPImplementation } from './pulsemcp-admin-client/lib/create-mcp-implementation.js';
+import { sendEmail } from './pulsemcp-admin-client/lib/send-email.js';
+import { searchProviders } from './pulsemcp-admin-client/lib/search-providers.js';
+import { getProviderById } from './pulsemcp-admin-client/lib/get-provider-by-id.js';
+import { getOfficialMirrorQueueItems } from './pulsemcp-admin-client/lib/get-official-mirror-queue-items.js';
+import { getOfficialMirrorQueueItem } from './pulsemcp-admin-client/lib/get-official-mirror-queue-item.js';
+import { approveOfficialMirrorQueueItem } from './pulsemcp-admin-client/lib/approve-official-mirror-queue-item.js';
+import { approveOfficialMirrorQueueItemWithoutModifying } from './pulsemcp-admin-client/lib/approve-official-mirror-queue-item-without-modifying.js';
+import { rejectOfficialMirrorQueueItem } from './pulsemcp-admin-client/lib/reject-official-mirror-queue-item.js';
+import { addOfficialMirrorToRegularQueue } from './pulsemcp-admin-client/lib/add-official-mirror-to-regular-queue.js';
+import { unlinkOfficialMirrorQueueItem } from './pulsemcp-admin-client/lib/unlink-official-mirror-queue-item.js';
+import { getUnofficialMirrors } from './pulsemcp-admin-client/lib/get-unofficial-mirrors.js';
+import { getUnofficialMirror } from './pulsemcp-admin-client/lib/get-unofficial-mirror.js';
+import { createUnofficialMirror } from './pulsemcp-admin-client/lib/create-unofficial-mirror.js';
+import { updateUnofficialMirror } from './pulsemcp-admin-client/lib/update-unofficial-mirror.js';
+import { deleteUnofficialMirror } from './pulsemcp-admin-client/lib/delete-unofficial-mirror.js';
+import { getOfficialMirrors } from './pulsemcp-admin-client/lib/get-official-mirrors.js';
+import { getOfficialMirror } from './pulsemcp-admin-client/lib/get-official-mirror.js';
+import { getTenants } from './pulsemcp-admin-client/lib/get-tenants.js';
+import { getTenant } from './pulsemcp-admin-client/lib/get-tenant.js';
+import { getMcpJsons } from './pulsemcp-admin-client/lib/get-mcp-jsons.js';
+import { getMcpJson } from './pulsemcp-admin-client/lib/get-mcp-json.js';
+import { createMcpJson } from './pulsemcp-admin-client/lib/create-mcp-json.js';
+import { updateMcpJson } from './pulsemcp-admin-client/lib/update-mcp-json.js';
+import { deleteMcpJson } from './pulsemcp-admin-client/lib/delete-mcp-json.js';
+import { getUnifiedMCPServers } from './pulsemcp-admin-client/lib/get-unified-mcp-servers.js';
+import { getUnifiedMCPServer } from './pulsemcp-admin-client/lib/get-unified-mcp-server.js';
+import { updateUnifiedMCPServer } from './pulsemcp-admin-client/lib/update-unified-mcp-server.js';
+import { getRedirects } from './pulsemcp-admin-client/lib/get-redirects.js';
+import { getRedirect } from './pulsemcp-admin-client/lib/get-redirect.js';
+import { createRedirect } from './pulsemcp-admin-client/lib/create-redirect.js';
+import { updateRedirect } from './pulsemcp-admin-client/lib/update-redirect.js';
+import { deleteRedirect } from './pulsemcp-admin-client/lib/delete-redirect.js';
+import { getGoodJobs } from './pulsemcp-admin-client/lib/get-good-jobs.js';
+import { getGoodJob } from './pulsemcp-admin-client/lib/get-good-job.js';
+import { getGoodJobCronSchedules } from './pulsemcp-admin-client/lib/get-good-job-cron-schedules.js';
+import { getGoodJobProcesses } from './pulsemcp-admin-client/lib/get-good-job-processes.js';
+import { getGoodJobStatistics } from './pulsemcp-admin-client/lib/get-good-job-statistics.js';
+import { retryGoodJob } from './pulsemcp-admin-client/lib/retry-good-job.js';
+import { discardGoodJob } from './pulsemcp-admin-client/lib/discard-good-job.js';
+import { rescheduleGoodJob } from './pulsemcp-admin-client/lib/reschedule-good-job.js';
+import { forceTriggerGoodJobCron } from './pulsemcp-admin-client/lib/force-trigger-good-job-cron.js';
+import { cleanupGoodJobs } from './pulsemcp-admin-client/lib/cleanup-good-jobs.js';
+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';
 // PulseMCP Admin API client implementation
 export class PulseMCPAdminClient {
     apiKey;
@@ -9,273 +77,211 @@ export class PulseMCPAdminClient {
         this.baseUrl = baseUrl || 'https://admin.pulsemcp.com';
     }
     async getPosts(params) {
-        const { getPosts } = await import('./pulsemcp-admin-client/lib/get-posts.js');
         return getPosts(this.apiKey, this.baseUrl, params);
     }
     async getPost(slug) {
-        const { getPost } = await import('./pulsemcp-admin-client/lib/get-post.js');
         return getPost(this.apiKey, this.baseUrl, slug);
     }
     async createPost(params) {
-        const { createPost } = await import('./pulsemcp-admin-client/lib/create-post.js');
         return createPost(this.apiKey, this.baseUrl, params);
     }
     async updatePost(slug, params) {
-        const { updatePost } = await import('./pulsemcp-admin-client/lib/update-post.js');
         return updatePost(this.apiKey, this.baseUrl, slug, params);
     }
     async uploadImage(postSlug, fileName, fileData) {
-        const { uploadImage } = await import('./pulsemcp-admin-client/lib/upload-image.js');
         return uploadImage(this.apiKey, this.baseUrl, postSlug, fileName, fileData);
     }
     async getAuthors(params) {
-        const { getAuthors } = await import('./pulsemcp-admin-client/lib/get-authors.js');
         return getAuthors(this.apiKey, this.baseUrl, params);
     }
     async getAuthorBySlug(slug) {
-        const { getAuthorBySlug } = await import('./pulsemcp-admin-client/lib/get-author-by-slug.js');
         return getAuthorBySlug(this.apiKey, this.baseUrl, slug);
     }
     async getAuthorById(id) {
-        const { getAuthorById } = await import('./pulsemcp-admin-client/lib/get-author-by-id.js');
         return getAuthorById(this.apiKey, this.baseUrl, id);
     }
     async getMCPServerBySlug(slug) {
-        const { getMCPServerBySlug } = await import('./pulsemcp-admin-client/lib/get-mcp-server-by-slug.js');
         return getMCPServerBySlug(this.apiKey, this.baseUrl, slug);
     }
     async getMCPServerById(id) {
-        const { getMCPServerById } = await import('./pulsemcp-admin-client/lib/get-mcp-server-by-id.js');
         return getMCPServerById(this.apiKey, this.baseUrl, id);
     }
     async getMCPClientBySlug(slug) {
-        const { getMCPClientBySlug } = await import('./pulsemcp-admin-client/lib/get-mcp-client-by-slug.js');
         return getMCPClientBySlug(this.apiKey, this.baseUrl, slug);
     }
     async getMCPClientById(id) {
-        const { getMCPClientById } = await import('./pulsemcp-admin-client/lib/get-mcp-client-by-id.js');
         return getMCPClientById(this.apiKey, this.baseUrl, id);
     }
     async getMCPImplementationById(id) {
-        const { getMCPImplementationById } = await import('./pulsemcp-admin-client/lib/get-mcp-implementation-by-id.js');
         return getMCPImplementationById(this.apiKey, this.baseUrl, id);
     }
     async searchMCPImplementations(params) {
-        const { searchMCPImplementations } = await import('./pulsemcp-admin-client/lib/search-mcp-implementations.js');
         return searchMCPImplementations(this.apiKey, this.baseUrl, params);
     }
     async getDraftMCPImplementations(params) {
-        const { getDraftMCPImplementations } = await import('./pulsemcp-admin-client/lib/get-draft-mcp-implementations.js');
         return getDraftMCPImplementations(this.apiKey, this.baseUrl, params);
     }
     async saveMCPImplementation(id, params) {
-        const { saveMCPImplementation } = await import('./pulsemcp-admin-client/lib/save-mcp-implementation.js');
         return saveMCPImplementation(this.apiKey, this.baseUrl, id, params);
     }
     async createMCPImplementation(params) {
-        const { createMCPImplementation } = await import('./pulsemcp-admin-client/lib/create-mcp-implementation.js');
         return createMCPImplementation(this.apiKey, this.baseUrl, params);
     }
     async sendEmail(params) {
-        const { sendEmail } = await import('./pulsemcp-admin-client/lib/send-email.js');
         return sendEmail(this.apiKey, this.baseUrl, params);
     }
     async searchProviders(params) {
-        const { searchProviders } = await import('./pulsemcp-admin-client/lib/search-providers.js');
         return searchProviders(this.apiKey, this.baseUrl, params);
     }
     async getProviderById(id) {
-        const { getProviderById } = await import('./pulsemcp-admin-client/lib/get-provider-by-id.js');
         return getProviderById(this.apiKey, this.baseUrl, id);
     }
     // Official Mirror Queue methods
     async getOfficialMirrorQueueItems(params) {
-        const { getOfficialMirrorQueueItems } = await import('./pulsemcp-admin-client/lib/get-official-mirror-queue-items.js');
         return getOfficialMirrorQueueItems(this.apiKey, this.baseUrl, params);
     }
     async getOfficialMirrorQueueItem(id) {
-        const { getOfficialMirrorQueueItem } = await import('./pulsemcp-admin-client/lib/get-official-mirror-queue-item.js');
         return getOfficialMirrorQueueItem(this.apiKey, this.baseUrl, id);
     }
     async approveOfficialMirrorQueueItem(id, mcpServerSlug) {
-        const { approveOfficialMirrorQueueItem } = await import('./pulsemcp-admin-client/lib/approve-official-mirror-queue-item.js');
         return approveOfficialMirrorQueueItem(this.apiKey, this.baseUrl, id, mcpServerSlug);
     }
     async approveOfficialMirrorQueueItemWithoutModifying(id) {
-        const { approveOfficialMirrorQueueItemWithoutModifying } = await import('./pulsemcp-admin-client/lib/approve-official-mirror-queue-item-without-modifying.js');
         return approveOfficialMirrorQueueItemWithoutModifying(this.apiKey, this.baseUrl, id);
     }
     async rejectOfficialMirrorQueueItem(id) {
-        const { rejectOfficialMirrorQueueItem } = await import('./pulsemcp-admin-client/lib/reject-official-mirror-queue-item.js');
         return rejectOfficialMirrorQueueItem(this.apiKey, this.baseUrl, id);
     }
     async addOfficialMirrorToRegularQueue(id) {
-        const { addOfficialMirrorToRegularQueue } = await import('./pulsemcp-admin-client/lib/add-official-mirror-to-regular-queue.js');
         return addOfficialMirrorToRegularQueue(this.apiKey, this.baseUrl, id);
     }
     async unlinkOfficialMirrorQueueItem(id) {
-        const { unlinkOfficialMirrorQueueItem } = await import('./pulsemcp-admin-client/lib/unlink-official-mirror-queue-item.js');
         return unlinkOfficialMirrorQueueItem(this.apiKey, this.baseUrl, id);
     }
     // Unofficial Mirror REST API methods
     async getUnofficialMirrors(params) {
-        const { getUnofficialMirrors } = await import('./pulsemcp-admin-client/lib/get-unofficial-mirrors.js');
         return getUnofficialMirrors(this.apiKey, this.baseUrl, params);
     }
     async getUnofficialMirror(id) {
-        const { getUnofficialMirror } = await import('./pulsemcp-admin-client/lib/get-unofficial-mirror.js');
         return getUnofficialMirror(this.apiKey, this.baseUrl, id);
     }
     async createUnofficialMirror(params) {
-        const { createUnofficialMirror } = await import('./pulsemcp-admin-client/lib/create-unofficial-mirror.js');
         return createUnofficialMirror(this.apiKey, this.baseUrl, params);
     }
     async updateUnofficialMirror(id, params) {
-        const { updateUnofficialMirror } = await import('./pulsemcp-admin-client/lib/update-unofficial-mirror.js');
         return updateUnofficialMirror(this.apiKey, this.baseUrl, id, params);
     }
     async deleteUnofficialMirror(id) {
-        const { deleteUnofficialMirror } = await import('./pulsemcp-admin-client/lib/delete-unofficial-mirror.js');
         return deleteUnofficialMirror(this.apiKey, this.baseUrl, id);
     }
     // Official Mirror REST API methods (read-only)
     async getOfficialMirrors(params) {
-        const { getOfficialMirrors } = await import('./pulsemcp-admin-client/lib/get-official-mirrors.js');
         return getOfficialMirrors(this.apiKey, this.baseUrl, params);
     }
     async getOfficialMirror(id) {
-        const { getOfficialMirror } = await import('./pulsemcp-admin-client/lib/get-official-mirror.js');
         return getOfficialMirror(this.apiKey, this.baseUrl, id);
     }
     // Tenant REST API methods (read-only)
     async getTenants(params) {
-        const { getTenants } = await import('./pulsemcp-admin-client/lib/get-tenants.js');
         return getTenants(this.apiKey, this.baseUrl, params);
     }
     async getTenant(idOrSlug) {
-        const { getTenant } = await import('./pulsemcp-admin-client/lib/get-tenant.js');
         return getTenant(this.apiKey, this.baseUrl, idOrSlug);
     }
     // MCP JSON REST API methods
     async getMcpJsons(params) {
-        const { getMcpJsons } = await import('./pulsemcp-admin-client/lib/get-mcp-jsons.js');
         return getMcpJsons(this.apiKey, this.baseUrl, params);
     }
     async getMcpJson(id) {
-        const { getMcpJson } = await import('./pulsemcp-admin-client/lib/get-mcp-json.js');
         return getMcpJson(this.apiKey, this.baseUrl, id);
     }
     async createMcpJson(params) {
-        const { createMcpJson } = await import('./pulsemcp-admin-client/lib/create-mcp-json.js');
         return createMcpJson(this.apiKey, this.baseUrl, params);
     }
     async updateMcpJson(id, params) {
-        const { updateMcpJson } = await import('./pulsemcp-admin-client/lib/update-mcp-json.js');
         return updateMcpJson(this.apiKey, this.baseUrl, id, params);
     }
     async deleteMcpJson(id) {
-        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);
     }
     // Redirect REST API methods
     async getRedirects(params) {
-        const { getRedirects } = await import('./pulsemcp-admin-client/lib/get-redirects.js');
         return getRedirects(this.apiKey, this.baseUrl, params);
     }
     async getRedirect(id) {
-        const { getRedirect } = await import('./pulsemcp-admin-client/lib/get-redirect.js');
         return getRedirect(this.apiKey, this.baseUrl, id);
     }
     async createRedirect(params) {
-        const { createRedirect } = await import('./pulsemcp-admin-client/lib/create-redirect.js');
         return createRedirect(this.apiKey, this.baseUrl, params);
     }
     async updateRedirect(id, params) {
-        const { updateRedirect } = await import('./pulsemcp-admin-client/lib/update-redirect.js');
         return updateRedirect(this.apiKey, this.baseUrl, id, params);
     }
     async deleteRedirect(id) {
-        const { deleteRedirect } = await import('./pulsemcp-admin-client/lib/delete-redirect.js');
         return deleteRedirect(this.apiKey, this.baseUrl, id);
     }
     // GoodJob REST API methods
     async getGoodJobs(params) {
-        const { getGoodJobs } = await import('./pulsemcp-admin-client/lib/get-good-jobs.js');
         return getGoodJobs(this.apiKey, this.baseUrl, params);
     }
     async getGoodJob(id) {
-        const { getGoodJob } = await import('./pulsemcp-admin-client/lib/get-good-job.js');
         return getGoodJob(this.apiKey, this.baseUrl, id);
     }
     async getGoodJobCronSchedules() {
-        const { getGoodJobCronSchedules } = await import('./pulsemcp-admin-client/lib/get-good-job-cron-schedules.js');
         return getGoodJobCronSchedules(this.apiKey, this.baseUrl);
     }
     async getGoodJobProcesses() {
-        const { getGoodJobProcesses } = await import('./pulsemcp-admin-client/lib/get-good-job-processes.js');
         return getGoodJobProcesses(this.apiKey, this.baseUrl);
     }
     async getGoodJobStatistics() {
-        const { getGoodJobStatistics } = await import('./pulsemcp-admin-client/lib/get-good-job-statistics.js');
         return getGoodJobStatistics(this.apiKey, this.baseUrl);
     }
     async retryGoodJob(id) {
-        const { retryGoodJob } = await import('./pulsemcp-admin-client/lib/retry-good-job.js');
         return retryGoodJob(this.apiKey, this.baseUrl, id);
     }
     async discardGoodJob(id) {
-        const { discardGoodJob } = await import('./pulsemcp-admin-client/lib/discard-good-job.js');
         return discardGoodJob(this.apiKey, this.baseUrl, id);
     }
     async rescheduleGoodJob(id, scheduledAt) {
-        const { rescheduleGoodJob } = await import('./pulsemcp-admin-client/lib/reschedule-good-job.js');
         return rescheduleGoodJob(this.apiKey, this.baseUrl, id, scheduledAt);
     }
     async forceTriggerGoodJobCron(cronKey) {
-        const { forceTriggerGoodJobCron } = await import('./pulsemcp-admin-client/lib/force-trigger-good-job-cron.js');
         return forceTriggerGoodJobCron(this.apiKey, this.baseUrl, cronKey);
     }
     async cleanupGoodJobs(params) {
-        const { cleanupGoodJobs } = await import('./pulsemcp-admin-client/lib/cleanup-good-jobs.js');
         return cleanupGoodJobs(this.apiKey, this.baseUrl, params);
     }
     // Proctor REST API methods
     async runExamForMirror(params) {
-        const { runExamForMirror } = await import('./pulsemcp-admin-client/lib/run-exam-for-mirror.js');
         return runExamForMirror(this.apiKey, this.baseUrl, params);
     }
     async saveResultsForMirror(params) {
-        const { saveResultsForMirror } = await import('./pulsemcp-admin-client/lib/save-results-for-mirror.js');
         return saveResultsForMirror(this.apiKey, this.baseUrl, params);
     }
     async getProctorRuns(params) {
-        const { getProctorRuns } = await import('./pulsemcp-admin-client/lib/get-proctor-runs.js');
         return getProctorRuns(this.apiKey, this.baseUrl, params);
     }
+    async getProctorMetadata() {
+        return getProctorMetadata(this.apiKey, this.baseUrl);
+    }
     // Discovered URL REST API methods
     async getDiscoveredUrls(params) {
-        const { getDiscoveredUrls } = await import('./pulsemcp-admin-client/lib/get-discovered-urls.js');
         return getDiscoveredUrls(this.apiKey, this.baseUrl, params);
     }
     async markDiscoveredUrlProcessed(params) {
-        const { markDiscoveredUrlProcessed } = await import('./pulsemcp-admin-client/lib/mark-discovered-url-processed.js');
         return markDiscoveredUrlProcessed(this.apiKey, this.baseUrl, params);
     }
     async getDiscoveredUrlStats() {
-        const { getDiscoveredUrlStats } = await import('./pulsemcp-admin-client/lib/get-discovered-url-stats.js');
         return getDiscoveredUrlStats(this.apiKey, this.baseUrl);
     }
 }

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;