railway-mcp

Instructions

Implementation Reference

• src/tools/volume.tool.ts:97-99 (handler)

  The tool handler function that delegates volume deletion to the volumeService.

      return volumeService.deleteVolume(volumeId);
    }
  )

• src/tools/volume.tool.ts:94-96 (schema)

  Zod schema defining the input parameter 'volumeId' for the volume_delete tool.

    volumeId: z.string().describe("ID of the volume to delete")
  },
  async ({ volumeId }) => {

• src/tools/volume.tool.ts:74-99 (registration)

  The createTool invocation that defines and registers the volume_delete tool with its name, description, input schema, and handler.

  createTool(
    "volume_delete",
    formatToolDescription({
      type: 'API',
      description: "Delete a volume from a service",
      bestFor: [
        "Removing unused storage",
        "Storage cleanup",
        "Resource management"
      ],
      notFor: [
        "Temporary data removal",
        "Data backup (use volume_backup first)"
      ],
      relations: {
        prerequisites: ["volume_list"],
        related: ["service_update"]
      }
    }),
    {
      volumeId: z.string().describe("ID of the volume to delete")
    },
    async ({ volumeId }) => {
      return volumeService.deleteVolume(volumeId);
    }
  )

• src/tools/index.ts:16-37 (registration)

  The registration function that adds all tools, including volume_delete via volumeTools, to the MCP server.

  export function registerAllTools(server: McpServer) {
    // Collect all tools
    const allTools = [
      ...databaseTools,
      ...deploymentTools,
      ...domainTools,
      ...projectTools,
      ...serviceTools,
      ...tcpProxyTools,
      ...variableTools,
      ...configTools,
      ...volumeTools,
      ...templateTools,
    ] as Tool[];
  
    // Register each tool with the server
    allTools.forEach((tool) => {
      server.tool(
        ...tool
      );
    });
  } 

• src/services/volume.service.ts:95-110 (helper)

  Supporting service method that performs the volume deletion using the API client and formats the response.

  async deleteVolume(volumeId: string): Promise<CallToolResult> {
    try {
      const success = await this.client.volumes.deleteVolume(volumeId);
      
      if (success) {
        return createSuccessResponse({
          text: "✅ Volume deleted successfully",
          data: { success }
        });
      } else {
        return createErrorResponse("Failed to delete volume");
      }
    } catch (error) {
      return createErrorResponse(`Error deleting volume: ${formatError(error)}`);
    }
  }