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

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/list-discovered-urls.js

@@ -1,11 +1,14 @@
 import { z } from 'zod';
 const PARAM_DESCRIPTIONS = {
-    status: 'Filter by processing status: "pending" (unprocessed, default), "processed", or "all"',
+    status: 'Filter by processing status: "pending" (unprocessed, default), "processed", "needs_indexing" (awaiting indexing), or "all"',
     page: 'Page number for pagination. Default: 1',
     per_page: 'Results per page, range 1-100. Default: 50',
 };
 const ListDiscoveredUrlsSchema = z.object({
-    status: z.enum(['pending', 'processed', 'all']).optional().describe(PARAM_DESCRIPTIONS.status),
+    status: z
+        .enum(['pending', 'processed', 'needs_indexing', 'all'])
+        .optional()
+        .describe(PARAM_DESCRIPTIONS.status),
     page: z.number().min(1).optional().describe(PARAM_DESCRIPTIONS.page),
     per_page: z.number().min(1).max(100).optional().describe(PARAM_DESCRIPTIONS.per_page),
 });
@@ -34,13 +37,14 @@ Example response:
 Use cases:
 - Browse unprocessed discovered URLs for review
 - Page through pending URLs to process them into MCP implementations
+- Query needs_indexing URLs for the daily ingest pipeline
 - Check processed URLs for audit purposes`,
         inputSchema: {
             type: 'object',
             properties: {
                 status: {
                     type: 'string',
-                    enum: ['pending', 'processed', 'all'],
+                    enum: ['pending', 'processed', 'needs_indexing', 'all'],
                     description: PARAM_DESCRIPTIONS.status,
                 },
                 page: { type: 'number', minimum: 1, description: PARAM_DESCRIPTIONS.page },

package/build/shared/src/tools/mark-discovered-url-processed.js

@@ -1,13 +1,15 @@
 import { z } from 'zod';
 const PARAM_DESCRIPTIONS = {
     id: 'The ID of the discovered URL to mark as processed',
-    result: 'Processing result: "posted" (created MCP implementation), "skipped" (not relevant), "rejected" (invalid), or "error" (processing failed)',
+    result: 'Processing result: "posted" (published MCP implementation), "drafted" (created draft MCP implementation), "skipped" (not relevant), "rejected" (invalid), "error" (processing failed), or "needs_indexing" (awaiting indexing)',
     notes: 'Reason for skip/reject/error (e.g., "Not an MCP server", "Duplicate of ID 5678")',
-    mcp_implementation_id: 'The ID of the created mcp_implementation (only when result is "posted")',
+    mcp_implementation_id: 'The ID of the created mcp_implementation (when result is "posted" or "drafted")',
 };
 const MarkDiscoveredUrlProcessedSchema = z.object({
     id: z.number().describe(PARAM_DESCRIPTIONS.id),
-    result: z.enum(['posted', 'skipped', 'rejected', 'error']).describe(PARAM_DESCRIPTIONS.result),
+    result: z
+        .enum(['posted', 'skipped', 'rejected', 'error', 'needs_indexing', 'drafted'])
+        .describe(PARAM_DESCRIPTIONS.result),
     notes: z.string().optional().describe(PARAM_DESCRIPTIONS.notes),
     mcp_implementation_id: z.number().optional().describe(PARAM_DESCRIPTIONS.mcp_implementation_id),
 });
@@ -19,17 +21,19 @@ export function markDiscoveredUrlProcessed(_server, clientFactory) {
 Idempotent — calling on an already-processed URL updates the fields.
 
 Use cases:
-- Mark a URL as "posted" after creating an MCP implementation from it
+- Mark a URL as "posted" after publishing an MCP implementation from it
+- Mark a URL as "drafted" after creating a draft MCP implementation from it
 - Mark a URL as "skipped" if it's not relevant (e.g., not an MCP server)
 - Mark a URL as "rejected" if it's invalid or a duplicate
-- Mark a URL as "error" if processing failed`,
+- Mark a URL as "error" if processing failed
+- Mark a URL as "needs_indexing" to flag it for the indexing pipeline`,
         inputSchema: {
             type: 'object',
             properties: {
                 id: { type: 'number', description: PARAM_DESCRIPTIONS.id },
                 result: {
                     type: 'string',
-                    enum: ['posted', 'skipped', 'rejected', 'error'],
+                    enum: ['posted', 'skipped', 'rejected', 'error', 'needs_indexing', 'drafted'],
                     description: PARAM_DESCRIPTIONS.result,
                 },
                 notes: { type: 'string', description: PARAM_DESCRIPTIONS.notes },

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.9",
   "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-discovered-urls.d.ts

@@ -1,6 +1,6 @@
 import type { DiscoveredUrlsResponse } from '../../types.js';
 export declare function getDiscoveredUrls(apiKey: string, baseUrl: string, params?: {
-    status?: 'pending' | 'processed' | 'all';
+    status?: 'pending' | 'processed' | 'needs_indexing' | 'all';
     page?: number;
     per_page?: number;
 }): Promise<DiscoveredUrlsResponse>;

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,8 +161,9 @@ 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';
+        status?: 'pending' | 'processed' | 'needs_indexing' | 'all';
         page?: number;
         per_page?: number;
     }): Promise<DiscoveredUrlsResponse>;
@@ -333,8 +334,9 @@ 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';
+        status?: 'pending' | 'processed' | 'needs_indexing' | 'all';
         page?: number;
         per_page?: number;
     }): Promise<DiscoveredUrlsResponse>;

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/list-discovered-urls.d.ts

@@ -9,7 +9,7 @@ export declare function listDiscoveredUrls(_server: Server, clientFactory: Clien
             status: {
                 type: string;
                 enum: string[];
-                description: "Filter by processing status: \"pending\" (unprocessed, default), \"processed\", or \"all\"";
+                description: "Filter by processing status: \"pending\" (unprocessed, default), \"processed\", \"needs_indexing\" (awaiting indexing), or \"all\"";
             };
             page: {
                 type: string;

package/shared/tools/list-discovered-urls.js

@@ -1,11 +1,14 @@
 import { z } from 'zod';
 const PARAM_DESCRIPTIONS = {
-    status: 'Filter by processing status: "pending" (unprocessed, default), "processed", or "all"',
+    status: 'Filter by processing status: "pending" (unprocessed, default), "processed", "needs_indexing" (awaiting indexing), or "all"',
     page: 'Page number for pagination. Default: 1',
     per_page: 'Results per page, range 1-100. Default: 50',
 };
 const ListDiscoveredUrlsSchema = z.object({
-    status: z.enum(['pending', 'processed', 'all']).optional().describe(PARAM_DESCRIPTIONS.status),
+    status: z
+        .enum(['pending', 'processed', 'needs_indexing', 'all'])
+        .optional()
+        .describe(PARAM_DESCRIPTIONS.status),
     page: z.number().min(1).optional().describe(PARAM_DESCRIPTIONS.page),
     per_page: z.number().min(1).max(100).optional().describe(PARAM_DESCRIPTIONS.per_page),
 });
@@ -34,13 +37,14 @@ Example response:
 Use cases:
 - Browse unprocessed discovered URLs for review
 - Page through pending URLs to process them into MCP implementations
+- Query needs_indexing URLs for the daily ingest pipeline
 - Check processed URLs for audit purposes`,
         inputSchema: {
             type: 'object',
             properties: {
                 status: {
                     type: 'string',
-                    enum: ['pending', 'processed', 'all'],
+                    enum: ['pending', 'processed', 'needs_indexing', 'all'],
                     description: PARAM_DESCRIPTIONS.status,
                 },
                 page: { type: 'number', minimum: 1, description: PARAM_DESCRIPTIONS.page },

package/shared/tools/mark-discovered-url-processed.d.ts

@@ -13,7 +13,7 @@ export declare function markDiscoveredUrlProcessed(_server: Server, clientFactor
             result: {
                 type: string;
                 enum: string[];
-                description: "Processing result: \"posted\" (created MCP implementation), \"skipped\" (not relevant), \"rejected\" (invalid), or \"error\" (processing failed)";
+                description: "Processing result: \"posted\" (published MCP implementation), \"drafted\" (created draft MCP implementation), \"skipped\" (not relevant), \"rejected\" (invalid), \"error\" (processing failed), or \"needs_indexing\" (awaiting indexing)";
             };
             notes: {
                 type: string;
@@ -21,7 +21,7 @@ export declare function markDiscoveredUrlProcessed(_server: Server, clientFactor
             };
             mcp_implementation_id: {
                 type: string;
-                description: "The ID of the created mcp_implementation (only when result is \"posted\")";
+                description: "The ID of the created mcp_implementation (when result is \"posted\" or \"drafted\")";
             };
         };
         required: string[];

package/shared/tools/mark-discovered-url-processed.js

@@ -1,13 +1,15 @@
 import { z } from 'zod';
 const PARAM_DESCRIPTIONS = {
     id: 'The ID of the discovered URL to mark as processed',
-    result: 'Processing result: "posted" (created MCP implementation), "skipped" (not relevant), "rejected" (invalid), or "error" (processing failed)',
+    result: 'Processing result: "posted" (published MCP implementation), "drafted" (created draft MCP implementation), "skipped" (not relevant), "rejected" (invalid), "error" (processing failed), or "needs_indexing" (awaiting indexing)',
     notes: 'Reason for skip/reject/error (e.g., "Not an MCP server", "Duplicate of ID 5678")',
-    mcp_implementation_id: 'The ID of the created mcp_implementation (only when result is "posted")',
+    mcp_implementation_id: 'The ID of the created mcp_implementation (when result is "posted" or "drafted")',
 };
 const MarkDiscoveredUrlProcessedSchema = z.object({
     id: z.number().describe(PARAM_DESCRIPTIONS.id),
-    result: z.enum(['posted', 'skipped', 'rejected', 'error']).describe(PARAM_DESCRIPTIONS.result),
+    result: z
+        .enum(['posted', 'skipped', 'rejected', 'error', 'needs_indexing', 'drafted'])
+        .describe(PARAM_DESCRIPTIONS.result),
     notes: z.string().optional().describe(PARAM_DESCRIPTIONS.notes),
     mcp_implementation_id: z.number().optional().describe(PARAM_DESCRIPTIONS.mcp_implementation_id),
 });
@@ -19,17 +21,19 @@ export function markDiscoveredUrlProcessed(_server, clientFactory) {
 Idempotent — calling on an already-processed URL updates the fields.
 
 Use cases:
-- Mark a URL as "posted" after creating an MCP implementation from it
+- Mark a URL as "posted" after publishing an MCP implementation from it
+- Mark a URL as "drafted" after creating a draft MCP implementation from it
 - Mark a URL as "skipped" if it's not relevant (e.g., not an MCP server)
 - Mark a URL as "rejected" if it's invalid or a duplicate
-- Mark a URL as "error" if processing failed`,
+- Mark a URL as "error" if processing failed
+- Mark a URL as "needs_indexing" to flag it for the indexing pipeline`,
         inputSchema: {
             type: 'object',
             properties: {
                 id: { type: 'number', description: PARAM_DESCRIPTIONS.id },
                 result: {
                     type: 'string',
-                    enum: ['posted', 'skipped', 'rejected', 'error'],
+                    enum: ['posted', 'skipped', 'rejected', 'error', 'needs_indexing', 'drafted'],
                     description: PARAM_DESCRIPTIONS.result,
                 },
                 notes: { type: 'string', description: PARAM_DESCRIPTIONS.notes },

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,7 +736,21 @@ export interface GetProctorRunsParams {
     limit?: number;
     offset?: number;
 }
-export type DiscoveredUrlResult = 'posted' | 'skipped' | 'rejected' | 'error';
+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' | 'needs_indexing' | 'drafted';
 export interface DiscoveredUrl {
     id: number;
     url: string;