getProcedureDetails

Retrieve detailed information on specific administrative procedures using the procedure ID, enabling structured access to eRegulations data for AI-driven insights.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`procedureId`	Yes	ID of the procedure to retrieve

Implementation Reference

src/mcp-capabilities/tools/handlers/get-procedure-details.ts:12-65 (handler)

The main handler implementation for the getProcedureDetails tool. It creates a ToolHandler object with the tool's metadata and the async execution logic that retrieves procedure details via the ERegulationsApi and formats the response.

export function createGetProcedureDetailsHandler(
  api: ERegulationsApi
): ToolHandler {
  return {
    name: ToolName.GET_PROCEDURE_DETAILS,
    description: `Get detailed information about a specific procedure by ID.`,
    inputSchema: zodToJsonSchema(GetProcedureDetailsSchema),
    inputSchemaDefinition: GetProcedureDetailsSchema,
    handler: async (args: any) => {
      try {
        // Use the inferred type for args
        const { procedureId } = args as GetProcedureDetailsArgs;

        logger.log(
          `Handling GET_PROCEDURE_DETAILS request for ID ${procedureId}`
        );

        const procedure = await api.getProcedureById(procedureId);

        // Use the formatter - Get result (data part will be ignored)
        const formattedResult = formatters.procedure.format(procedure);

        logger.log(
          `GET_PROCEDURE_DETAILS returning details for ${procedure.name}`
        );

        // Always return only text content
        return {
          content: [
            {
              type: "text",
              text: formattedResult.text, // Data part of formattedResult is ignored
            },
          ],
        };
      } catch (error: any) {
        const errorMessage = error.message || String(error);
        logger.error(
          `Error in GET_PROCEDURE_DETAILS handler for ID ${args?.procedureId}:`,
          errorMessage
        );

        return {
          content: [
            {
              type: "text",
              text: `Error retrieving procedure details: ${errorMessage}\n\nValid procedure IDs can be found by using the listProcedures tool first.`,
            },
          ],
        };
      }
    },
  };
}

src/mcp-capabilities/tools/schemas.ts:14-20 (schema)
Zod schema definition for the input parameters of the getProcedureDetails tool, requiring a positive integer procedureId.
```
export const GetProcedureDetailsSchema = z.object({
  procedureId: z
    .number()
    .int()
    .positive()
    .describe("ID of the procedure to retrieve"),
});
```

src/mcp-server.ts:65-79 (registration)

Registration of all tools, including getProcedureDetails, with the MCP server using server.tool() in a loop over the handlers array.

handlers.forEach((handler) => {
  const schemaDef = handler.inputSchemaDefinition;
  // Check if it's an instance of ZodObject
  if (schemaDef instanceof z.ZodObject) {
    // Now TypeScript knows schemaDef is a ZodObject and has .shape
    // Cast handler to 'any' to bypass strict type checking
    server.tool(handler.name, schemaDef.shape, handler.handler as any);
    logger.info(`Registered tool '${handler.name}' with McpServer`);
  } else {
    // Handle non-object schemas or log warning
    logger.warn(
      `Could not register tool '${handler.name}': Schema is not a ZodObject.`
    );
  }
});

src/mcp-capabilities/tools/handlers/index.ts:13-20 (registration)

The createHandlers function that includes the getProcedureDetails handler in the array of all tool handlers, called from mcp-server.ts.

export function createHandlers(api: ERegulationsApi): ToolHandler[] {
  return [
    createListProceduresHandler(api),
    createGetProcedureDetailsHandler(api),
    createGetProcedureStepHandler(api),
    createSearchProceduresHandler(api),
  ];
}

src/mcp-capabilities/tools/schemas.ts:3-8 (schema)

Enum defining the tool names, including GET_PROCEDURE_DETAILS used as the tool name string.

export enum ToolName {
  LIST_PROCEDURES = "listProcedures",
  GET_PROCEDURE_DETAILS = "getProcedureDetails",
  GET_PROCEDURE_STEP = "getProcedureStep",
  SEARCH_PROCEDURES = "searchProcedures",
}

eRegulations MCP Server