ras_pub_get_status
Check publishing service health and operational status to verify functionality or diagnose resource availability issues.
Instructions
Get the overall publishing service status and health. Returns whether the publishing agent is operational and any pending changes. Use this to verify publishing is functioning or diagnose why resources are unavailable.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/publishing.ts:132-151 (handler)Complete implementation of ras_pub_get_status tool - registers the tool with MCP server and provides the handler function that fetches publishing service status from the RAS API endpoint /api/publishing/statusserver.registerTool( "ras_pub_get_status", { title: "Publishing Status", description: "Get the overall publishing service status and health. Returns whether " + "the publishing agent is operational and any pending changes. Use this to " + "verify publishing is functioning or diagnose why resources are unavailable.", annotations: READ_ONLY_ANNOTATIONS, inputSchema: {}, }, async () => { try { const data = await rasClient.get("/api/publishing/status"); return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] }; } catch (err) { return { content: [{ type: "text" as const, text: sanitiseError(err, "Failed to retrieve publishing status") }], isError: true }; } } );
- src/tools/publishing.ts:143-150 (handler)Handler function for ras_pub_get_status - makes an async GET request to /api/publishing/status via rasClient, returns JSON-formatted data, or a sanitized error message if the request failsasync () => { try { const data = await rasClient.get("/api/publishing/status"); return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] }; } catch (err) { return { content: [{ type: "text" as const, text: sanitiseError(err, "Failed to retrieve publishing status") }], isError: true }; } }
- src/tools/publishing.ts:11-17 (schema)READ_ONLY_ANNOTATIONS constant - provides shared metadata for read-only publishing tools indicating they are non-destructive, idempotent, and read-only operations/** Shared annotations for all read-only publishing tools. */ const READ_ONLY_ANNOTATIONS = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true, } as const;